使用镜像注册表和镜像仓库¶
Snowpark Container Services 提供了 OCIv2 (https://github.com/opencontainers/distribution-spec/blob/main/spec.md) 兼容镜像注册表服务和存储单元调用存储库来存储镜像。您可以使用以下 Snowflake CLI 命令管理 Snowpark Container Services 镜像注册表和镜像仓库：
有关 Snowpark Container Services 镜像注册表和镜像仓库的更多信息，请参阅 Snowpark Container Services：使用镜像注册表和镜像仓库。
管理镜像注册表¶
Snowflake CLI 允许您使用 Snowpark Container Services 镜像仓库执行以下任务：
对于常见操作，如列表或拖放，Snowflake CLI 使用 snow object 命令，如 管理 Snowflake 对象 中所述。
获取用于注册表身份验证的环境令牌¶
您可以使用 snow spcs image-registry token 命令返回与指定连接关联的令牌，您可以使用该令牌对注册表进行身份验证。
snow spcs image-registry token --connection mytest
+----------------------------------------------------------------------------------------------------------------------+
| key | value |
|------------+---------------------------------------------------------------------------------------------------------|
| token | **************************************************************************************************** |
| | **************************************************************************************************** |
| expires_in | 3600 |
+----------------------------------------------------------------------------------------------------------------------+
然后，您可以使用该令牌通过管道将其传输到 docker login 命令来登录 Docker 容器，类似于以下操作：
snow spcs image-registry token --format=JSON | docker login <org>-<account>.registry.snowflakecomputing.cn -u 0sessiontoken --password-stdin
登录镜像注册表¶
snow spcs image-registry login 使用为您的连接指定的凭据将您登录到镜像仓库。在登录之前，您必须满足以下先决条件：
必须安装 Docker Desktop (https://www.docker.com/products/docker-desktop/)，因为该命令要使用 Docker 登录到 Snowflake。
当前角色必须具有账户中镜像仓库的 READ 权限才能获取注册表 URL。
要使用您的账户凭据登录到镜像注册表，请使用以下命令：
snow spcs image-registry login
Login Succeeded
检索镜像注册表的 URL¶
snow spcs image-registry url 命令返回镜像仓库的 URL。 当前角色必须具有账户中镜像仓库的 READ 权限才能获取注册表 URL。
要获取镜像仓库的 URL，请执行以下操作：
snow spcs image-registry url
<orgname-acctname>.registry.snowflakecomputing.cn
管理镜像仓库¶
Snowflake CLI 允许您使用 Snowpark Container Services 镜像仓库执行以下任务：
对于常见操作，如列表或拖放，Snowflake CLI 使用 snow object 命令，如 管理 Snowflake 对象 中所述。
创建镜像仓库¶
snow spcs image-repository create 命令在当前架构中创建新的镜像仓库。
要创建镜像仓库，请输入类似下面的命令：
snow spcs image-repository create tutorial_repository
+-------------------------------------------+
| key | value |
|--------+----------------------------------|
| status | Statement executed successfully. |
+-------------------------------------------+
根据项目定义创建和部署镜像仓库¶
通过创建 snowflake.yml 项目定义文件并执行 snow spcs image-repository deploy 命令，您可以将镜像仓库部署到暂存区。
下面显示的是一个 snowflake.yml 项目定义文件示例：
definition_version: 2
entities:
my_image_repository:
type: image-repository
identifier: my_image_repository
下表描述了计算池项目定义的属性。
属性 |
定义 |
|---|---|
type required、string |
必须是 |
identifier optional、string |
实体的 Snowflake 标识符。该值可以采用以下形式：
|
要创建和部署镜像仓库，请执行以下操作：
将当前目录更改为包含项目定义文件的目录。
运行
snow spcs image-repository deploy命令，类似如下：snow spcs image-repository deploy
+---------------------------------------------------------------------+ | key | value | |--------+------------------------------------------------------------| | status | Image Repository MY_IMAGE_REPOSITORY successfully created. | +---------------------------------------------------------------------+
检索镜像仓库的 URL¶
snow spcs image-repository url 命令获取镜像仓库的 URL。
要获取 URL，请输入类似下面的命令：
snow spcs image-repository url tutorial_repository
<orgname-acctname>.registry.snowflakecomputing.cn/tutorial_db/data_schema/tutorial_repository