Como trabalhar com registros e repositórios de imagens

O Snowpark Container Services fornece um serviço de registro de imagens compatível com OCIv2 e um repositório de chamadas de unidade de armazenamento para armazenar imagens. Você pode usar os seguintes comandos Snowflake CLI para gerenciar registros e repositórios de imagens do Snowpark Container Services:

Para obter mais informações sobre repositórios de registro de imagens Snowpark Container Services, consulte Snowpark Container Services: como trabalhar com um registro e repositório de imagens.

Gerenciamento de registros de imagens

Snowflake CLI permite que você execute as seguintes tarefas com repositórios de imagens Snowpark Container Services:

Para operações comuns, como listar ou descartar, o Snowflake CLI usa comandos snow object conforme descrito em Gerenciamento de objetos Snowflake.

Obtenção de tokens de ambiente para autenticação de registro

Você pode usar o comando snow spcs image-registry token para retornar o token associado à conexão especificada que você pode usar para autenticar no registro.

snow spcs image-registry token --connection mytest

+----------------------------------------------------------------------------------------------------------------------+
| key        | value                                                                                                   |
|------------+---------------------------------------------------------------------------------------------------------|
| token      | ****************************************************************************************************    |
|            | ****************************************************************************************************    |
| expires_in | 3600                                                                                                    |
+----------------------------------------------------------------------------------------------------------------------+

Você pode então usar esse token para efetuar login em um contêiner Docker canalizando-o para o comando docker login, semelhante ao seguinte:

snow spcs image-registry token --format=JSON | docker login <org>-<account>.registry.snowflakecomputing.com -u 0sessiontoken --password-stdin

Login em um registro de imagem

O snow spcs image-registry login conecta você a um repositório de imagens com as credenciais especificadas para sua conexão. Antes de efetuar login, você deve atender aos seguintes pré-requisitos:

  • Docker Desktop deve ser instalado porque o comando usa o docker para efetuar login no Snowflake.

  • A função atual deve ter privilégios READ para o repositório de imagens na conta para obter o URL de registro.

Para fazer login em um registro de imagem com as credenciais da sua conta, use o seguinte:

snow spcs image-registry login

Login Succeeded

Recupere o URL para um registro de imagem

O comando snow spcs image-registry url retorna um URL para um repositório de imagens. A função atual deve ter privilégios READ para o repositório de imagens na conta para obter o URL de registro.

Para obter o URL para um repositório, faça o seguinte:

snow spcs image-registry url

<orgname-acctname>.registry.snowflakecomputing.com

Gerenciamento de repositórios de imagens

Snowflake CLI permite que você execute as seguintes tarefas com repositórios de imagens Snowpark Container Services:

Para operações comuns, como listar ou descartar, o Snowflake CLI usa comandos snow object conforme descrito em Gerenciamento de objetos Snowflake.

Criação de um repositório de imagens

O comando snow spcs image-repository create cria um novo repositório de imagens no esquema atual.

Para criar um repositório de imagens, digite um comando semelhante ao seguinte:

snow spcs image-repository create tutorial_repository

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

Criar e implementar um repositório de imagens a partir de uma definição de projeto

Você pode implantar um repositório de imagens em um estágio criando um arquivo de definição de projeto snowflake.yml e executando o comando snow spcs image-repository deploy.

A seguir mostramos um exemplo de arquivo de definição de projeto snowflake.yml:

definition_version: 2
entities:
  my_image_repository:
    type: image-repository
    identifier: my_image_repository

A tabela a seguir descreve as propriedades de uma definição de projeto de pool de computação.

Propriedades de definição do projeto do repositório de imagens

Propriedade

Definição

type

required, string

Deve ser image-repository.

identifier

optional, string

Identificador Snowflake para a entidade. O valor pode ter as seguintes formas:

  • Texto identificador de cadeia de caracteres

    identifier: my-image-repository

    Identificadores entre aspas e sem aspas são suportados. Para usar identificadores entre aspas, inclua as aspas ao redor do valor YAML (por exemplo, "My Image Repository").

  • Objeto

    identifier:
  name: my-image-repository
  schema: my-schema # optional
  database: my-db # optional

    Nota

    Ocorrerá um erro se você especificar um schema ou um database e usar um nome totalmente qualificado na propriedade name (por exemplo, mydb.schema1.my-app).

Para criar e implantar o repositório de imagens, faça o seguinte:

  1. Altere seu diretório atual para o diretório que contém o arquivo de definição do projeto.

  2. Execute um comando snow spcs image-repository deploy semelhante ao seguinte:

    snow spcs image-repository deploy

    +---------------------------------------------------------------------+
| key    | value                                                      |
|--------+------------------------------------------------------------|
| status | Image Repository MY_IMAGE_REPOSITORY successfully created. |
+---------------------------------------------------------------------+

Recuperação do URL para um repositório de imagens

O comando snow spcs image-repository url obtém o URL para um repositório de imagens.

Para obter o URL, digite um comando semelhante ao seguinte:

snow spcs image-repository url tutorial_repository

<orgname-acctname>.registry.snowflakecomputing.com/tutorial_db/data_schema/tutorial_repository

Listagem de tags e imagens em um repositório de imagens

O comando snow spcs image-repository list-images permite que você obtenha as imagens e tags para um repositório de imagens.

Para listar as imagens e tags em um repositório, digite um comando semelhante ao seguinte, que lista as imagens em um repositório nomeado images no banco de dados my_db:

snow spcs image-repository list-images images --database my_db

+----------------------------+---------------+---------+-------------------------------------------------+-----------------------------------------+
| created_on                 | image_name    | tags    | digest                                          | image_path                              |
|----------------------------+---------------+---------+-------------------------------------------------+-----------------------------------------|
| 2024-10-11 14:23:49-07:00  | echo_service  | latest  | sha256:a8a001fef406fdb3125ce8e8bf9970c35af7084  | my_db/test_schema/images/echo_service:  |
|                            |               |         | fc33b0886d7a8915d3082c781                       | latest                                  |
| 2024-10-14 22:21:14-07:00  | test_counter  | latest  | sha256:8cae96dac29a4a05f54bb5520003f964baf67fc  | my_db/test_schema/images/test_counter:  |
|                            |               |         | 38dcad3d2c85d6c5aa7381174                       | latest                                  |
+----------------------------+---------------+---------+-------------------------------------------------+-----------------------------------------+