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
Copy
+----------------------------------------------------------------------------------------------------------------------+
| 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
Copy

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 efetuar login em um registro de imagem com as credenciais da sua conta, use o seguinte:

snow spcs image-registry login
Copy
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
Copy
<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
Copy
+-------------------------------------------+
| key    | value                            |
|--------+----------------------------------|
| status | Statement executed successfully. |
+-------------------------------------------+

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
Copy
<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
Copy
+----------------------------+---------------+---------+-------------------------------------------------+-----------------------------------------+
| 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                                  |
+----------------------------+---------------+---------+-------------------------------------------------+-----------------------------------------+