管理服务¶

Snowpark Container Services 使您能够轻松部署、管理和扩展容器化应用程序。将应用程序镜像上传到账户中的存储库后，将应用程序容器作为服务或作业运行。本主题介绍如何使用服务。

服务是长期运行的，就像 Web 服务一样，不会自己结束。Snowflake 管理运行中的服务。例如，如果某个服务容器出于某种原因退出，Snowflake 会重新启动该容器，以便服务不间断地运行。如果您的服务需要更多的资源，例如更多的计算能力，Snowflake 会在计算池中预置额外的节点。

有关使用容器服务的详细信息，请参阅 Snowpark Container Services：使用服务。

本主题介绍如何使用服务执行以下任务:

创建 Snowpark Container Services 服务
根据项目定义创建和部署服务
暂停和恢复服务
获取有关服务的状态信息
列出服务中的端点
设置和取消设置服务的属性或参数
显示命名服务的日志
升级命名服务

对于常见操作，如列表或拖放，Snowflake CLI 使用 snow object 命令，如管理 Snowflake 对象中所述。

创建 Snowpark Container Services 服务¶

Snowpark Container Services 需要以下条件：

计算池：Snowflake 在指定的计算池中运行您的服务。
服务规范文件：此规范为 Snowflake 提供配置和运行服务所需的信息。

要创建服务，请输入类似于以下内容的 snow spcs service create 命令：

snow spcs service create "job_1" --compute-pool "pool_1" --spec-path "/some-dir/spec_file.yaml"

Copy

有关更多信息，请参阅管理 Snowflake 对象。

根据项目定义创建和部署服务¶

您可以通过 snowflake.yml 项目定义文件创建服务，然后执行 snow spcs service deploy 命令。

下面显示的是一个 snowflake.yml 项目定义文件示例：

definition_version: 2
entities:
  my_service:
    type: service
    identifier: my_service
    stage: my_stage
    compute_pool: my_compute_pool
    spec_file: spec.yml
    min_instances: 1
    max_instances: 2
    query_warehouse: my_warehouse
    auto_resume: true
    external_access_integrations:
      - my_external_access
    secrets:
        cred: my_cred_name
    artifacts:
      - spec.yml
    comment: "My service"
    tags:
      - name: test_tag
        value: test_value

Copy

下表描述了计算池项目定义的属性。

Streamlit 项目定义属性¶
属性	定义
type required、string	必须是 `service`。
stage required、string	服务规范文件所在的暂存区。
compute_pool required、string	服务运行所在的计算池。
spec_file required、string	暂存区上服务规范文件的路径。
identifier optional、string	实体的 Snowflake 标识符。该值可以采用以下形式：字符串标识符文本 identifier: my-service Copy 支持不带引号和带引号的标识符。要使用带引号的标识符，请在 YAML 值中包含周围的引号（例如，`’”My Image Repository"`）。对象 identifier: name: my-service schema: my-schema # optional database: my-db # optional Copy 备注如果指定 `schema` 或 `database`，并在 `name` 属性中使用完全限定名称（例如 `mydb.schema1.my-app`），则会发生错误。
min_instances optional、string	要运行的最小服务实例数。默认值：`1`
max_instances optional、string	要运行的最大服务实例数。
query_warehouse optional、string	如果服务容器连接到 Snowflake 以执行查询，但未明确指定要使用的仓库，则使用此仓库。
auto_resume optional、string	在调用服务函数或入口时是否自动恢复。默认值：`True`
external_access_integrations optional、string sequence	该实体访问外部网络所需的外部访问集成名称。
secrets optional、dictionary	密钥变量的名称和值，以便使用变量来引用密钥。
artifacts optional、string sequence	要添加到部署根的文件源和目标对的列表。您可以使用以下工件属性： `src`：一个或多个代码源文件的路径。 `dest`：要部署工件的目录的路径。引用目录的目标路径必须以 `/` 结尾。如果 glob 模式的目标不是以 `/` 结尾，则会导致错误。如果省略，`dest` 默认为与 `src` 字符串相同。您还可以为每个项目传递一个字符串，而不是 `dict`，在这种情况下，该值将视为 `src` 和 `dest`。如果 `src` 仅引用一个文件（而不是 glob），`dest` 可以引用目标 `<path>` or a `<path/name>`。您还可以为每个项目传递一个字符串，而不是 `dict`，在这种情况下，该值将视为 `src` 和 `dest`。
comment optional、string	与计算池关联的注释。
tags optional、Tag sequence	计算池的标签名称和值。有关更多信息，请参阅对象和列的标签配额

要创建和部署服务，请执行以下操作：

运行 snow spcs service deploy 命令，类似如下：

snow spcs service deploy

Copy

+---------------------------------------------------------------------+
| key    | value                                                      |
|--------+------------------------------------------------------------|
| status | Service MY_SERVICE successfully created.                   |
+---------------------------------------------------------------------+

暂停和恢复服务¶

要暂停命名服务，请输入类似于以下内容的 snow spcs service suspend 命令：

snow spcs service suspend echo_service

Copy

+-------------------------------------------+
| key    | value                            |
|--------+----------------------------------|
| status | Statement executed successfully. |
+-------------------------------------------+

要恢复暂停服务，请输入类似于以下内容的 snow spcs service resume 命令：

snow spcs service resume echo_service

Copy

+-------------------------------------------+
| key    | value                            |
|--------+----------------------------------|
| status | Statement executed successfully. |
+-------------------------------------------+

获取有关服务的状态信息¶

备注

当前角色必须对服务具有 MONITOR 权限才能获取服务状态。

列出所有服务¶

snow spcs service list 命令会返回所有服务的概述，包括服务的运行时状态，例如 PENDING 或 RUNNING，以及升级状态。要获取所有服务的状态，请输入类似于以下内容的命令：

snow spcs service list

Copy

+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|        |        |        |        |        |        |        |        |        |        |        |         | extern |         |        |         |        |         |        |        |         |        |         |        |
|        |        |        |        |        |        |        |        |        |        |        |         | al_acc |         |        |         |        |         |        |        |         |        | managin | managi |
|        |        | databa |        |        |        |        | curren | target | min_in | max_in |         | ess_in |         |        |         |        | owner_r | query_ |        |         |        | g_objec | ng_obj |
|        |        | se_nam | schema |        | comput | dns_na | t_inst | _insta | stance | stance | auto_re | tegrat | created | update | resumed | commen | ole_typ | wareho |        | spec_di | is_upg | t_domai | ect_na |
| name   | status | e      | _name  | owner  | e_pool | me     | ances  | nces   | s      | s      | sume    | ions   | _on     | d_on   | _on     | t      | e       | use    | is_job | gest    | rading | n       | me     |
|--------+--------+--------+--------+--------+--------+--------+--------+--------+--------+--------+---------+--------+---------+--------+---------+--------+---------+--------+--------+---------+--------+---------+--------|
| ECHO_S | RUNNIN | TEST00 | TEST_S | SYSADM | TUTORI | echo-s | 1      | 1      | 1      | 1      | true    | None   | 2024-10 | 2024-1 | None    | This   | ROLE    | COMPUT | false  | 52e62d1 | false  | None    | None   |
| ERVICE | G      | _DB    | CHEMA  | IN     | AL_COM | ervice |        |        |        |        |         |        | -16     | 0-16   |         | is a   |         | E_WH   |        | f19c720 |        |         |        |
|        |        |        |        |        | PUTE_P | .imhd. |        |        |        |        |         |        | 15:09:3 | 15:09: |         | test   |         |        |        | 6b5f4ef |        |         |        |
|        |        |        |        |        | OOL    | svc.sp |        |        |        |        |         |        | 0.49300 | 31.905 |         | servic |         |        |        | c069557 |        |         |        |
|        |        |        |        |        |        | cs.int |        |        |        |        |         |        | 0-07:00 | 000-07 |         | e      |         |        |        | 8b6c2b3 |        |         |        |
|        |        |        |        |        |        | ernal  |        |        |        |        |         |        |         | :00    |         |        |         |        |        | 806ad76 |        |         |        |
|        |        |        |        |        |        |        |        |        |        |        |         |        |         |        |         |        |         |        |        | 67d78cc |        |         |        |
|        |        |        |        |        |        |        |        |        |        |        |         |        |         |        |         |        |         |        |        | ce8b6ed |        |         |        |
|        |        |        |        |        |        |        |        |        |        |        |         |        |         |        |         |        |         |        |        | 6501a8a |        |         |        |
|        |        |        |        |        |        |        |        |        |        |        |         |        |         |        |         |        |         |        |        | 3       |        |         |        |
+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+

获取命名服务的状态¶

要获取单个服务的状态，请输入类似于以下内容的 snow spcs service describe 命令：

snow spcs service describe echo_service

Copy

+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|        |        |        |        |        |        |        |        |        |        |        |         | extern |         |        |         |        |         |        |        |         |        |         |        |
|        |        |        |        |        |        |        |        |        |        |        |         | al_acc |         |        |         |        |         |        |        |         |        | managin | managi |
|        |        | databa |        |        |        |        | curren | target | min_in | max_in |         | ess_in |         |        |         |        | owner_r | query_ |        |         |        | g_objec | ng_obj |
|        |        | se_nam | schema |        | comput | dns_na | t_inst | _insta | stance | stance | auto_re | tegrat | created | update | resumed | commen | ole_typ | wareho |        | spec_di | is_upg | t_domai | ect_na |
| name   | status | e      | _name  | owner  | e_pool | me     | ances  | nces   | s      | s      | sume    | ions   | _on     | d_on   | _on     | t      | e       | use    | is_job | gest    | rading | n       | me     |
|--------+--------+--------+--------+--------+--------+--------+--------+--------+--------+--------+---------+--------+---------+--------+---------+--------+---------+--------+--------+---------+--------+---------+--------|
| ECHO_S | RUNNIN | TEST00 | TEST_S | SYSADM | TUTORI | echo-s | 1      | 1      | 1      | 1      | true    | None   | 2024-10 | 2024-1 | None    | This   | ROLE    | COMPUT | false  | 52e62d1 | false  | None    | None   |
| ERVICE | G      | _DB    | CHEMA  | IN     | AL_COM | ervice |        |        |        |        |         |        | -16     | 0-16   |         | is a   |         | E_WH   |        | f19c720 |        |         |        |
|        |        |        |        |        | PUTE_P | .imhd. |        |        |        |        |         |        | 15:09:3 | 15:09: |         | test   |         |        |        | 6b5f4ef |        |         |        |
|        |        |        |        |        | OOL    | svc.sp |        |        |        |        |         |        | 0.49300 | 31.905 |         | servic |         |        |        | c069557 |        |         |        |
|        |        |        |        |        |        | cs.int |        |        |        |        |         |        | 0-07:00 | 000-07 |         | e      |         |        |        | 8b6c2b3 |        |         |        |
|        |        |        |        |        |        | ernal  |        |        |        |        |         |        |         | :00    |         |        |         |        |        | 806ad76 |        |         |        |
|        |        |        |        |        |        |        |        |        |        |        |         |        |         |        |         |        |         |        |        | 67d78cc |        |         |        |
|        |        |        |        |        |        |        |        |        |        |        |         |        |         |        |         |        |         |        |        | ce8b6ed |        |         |        |
|        |        |        |        |        |        |        |        |        |        |        |         |        |         |        |         |        |         |        |        | 6501a8a |        |         |        |
|        |        |        |        |        |        |        |        |        |        |        |         |        |         |        |         |        |         |        |        | 3       |        |         |        |
+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+

列出实例和容器¶

您可以分别使用 snow spcs service list-instances 和 snow spcs service list-containers 命令列出服务的实例和容器。

要获取 echo_service 服务中的实例列表，请输入以下 snow spcs service list-instances 命令：

snow spcs service list-instances echo_service

Copy

+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| database_name | schema_name | service_name | instance_id | status | spec_digest                                                      | creation_time        | start_time           |
|---------------+-------------+--------------+-------------+--------+------------------------------------------------------------------+----------------------+----------------------|
| TEST00_DB     | TEST_SCHEMA | ECHO_SERVICE | 0           | READY  | 336c065739dd2b96e770f01804affdc7810e6df68a23b23052d851627abfbdf9 | 2024-10-10T06:06:30Z | 2024-10-10T06:06:30Z |
+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+

要获取 echo_service 服务中的容器列表，请输入以下 snow spcs service list-containers 命令：

snow spcs service list-containers echo_service

Copy

+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| database_name | schema_name | service_name | instance_id | container_name | status | message | image_name                                | image_digest                              | restart_count | start_time           |
|---------------+-------------+--------------+-------------+----------------+--------+---------+-------------------------------------------+-------------------------------------------+---------------+----------------------|
| TEST00_DB     | TEST_SCHEMA | ECHO_SERVICE | 0           | main           | READY  | Running | org-test-account-00.registry.registry.sno | sha256:06c3d54edc24925abe398eda70d37eb6b8 | 0             | 2024-10-16T22:09:35Z |
|               |             |              |             |                |        |         | wflakecomputing.com/test00_db/test_schema | 7b1c4dd6211317592764e1e7d94498            |               |                      |
|               |             |              |             |                |        |         | /test00_repo/echo_service:latest          |                                           |               |                      |
+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+

列出服务中的端点¶

要列出命名服务的端点，请输入类似于以下内容的 snow spcs service list-endpoints 命令：

snow spcs service list-endpoints echo_service

Copy

+--------------+------+----------+-----------------+-----------------------------------------+
| name         | port | protocol | ingress_enabled | ingress_url                             |
|--------------+------+----------+-----------------+-----------------------------------------|
| echoendpoint | 8000 | TCP      | true            | org-id-acct-id.snowflakecomputing.app   |
+--------------+------+----------+-----------------+-----------------------------------------+

列出与服务关联的服务角色¶

您可以通过在服务规范中定义服务角色和权限来管理对服务公开的各个端点的访问权限。有关如何使用服务角色的更多信息，请参阅 GRANT SERVICE ROLE。

要获取为服务创建的服务角色列表，请使用 snow spcs service list-roles 命令，如下所示：

snow spcs service list-roles my_service

Copy

+------------------------------------------------------------------+
| created_on                       | name                | comment |
|----------------------------------+---------------------+---------|
| 2024-10-09 16:48:52.980000-07:00 | ALL_ENDPOINTS_USAGE | None    |
+------------------------------------------------------------------+

设置和取消设置服务的属性或参数¶

备注

当前角色必须具有该服务的 OPERATE 权限才能设置属性。

要设置服务的属性或参数，请输入类似于以下内容的 snow spcs service set 命令：

snow spcs service set echo_service --min-instances 2 --max-instances 4

Copy

+-------------------------------------------+
| key    | value                            |
|--------+----------------------------------|
| status | Statement executed successfully. |
+-------------------------------------------+

要将服务的属性或参数重置为其默认值，请输入类似下面的命令：

snow spcs compute-pool unset tutorial_compute_pool --auto-resume

Copy

+-------------------------------------------+
| key    | value                            |
|--------+----------------------------------|
| status | Statement executed successfully. |
+-------------------------------------------+

显示命名服务的日志¶

备注

当前角色必须具有对服务的 MONITOR 权限才能显示日志。

要显示命名服务的本地日志，请输入类似于以下内容的 snow spcs service logs 命令：

snow spcs service logs "service_1" --container-name "container_1" --instance-id "0"

Copy

升级命名服务¶

备注

当前角色必须具有对服务的 OPERATE 权限才能升级服务。

要升级命名服务，请输入类似于以下内容的 snow spcs service upgrade 命令：

snow spcs service upgrade echo_service --spec-path spec.yml

Copy

+-------------------------------------------+
| key    | value                            |
|--------+----------------------------------|
| status | Statement executed successfully. |
+-------------------------------------------+