イメージレジストリとリポジトリの操作

Snowpark Container Services は、 OCIv2 準拠のイメージレジストリサービスと、イメージを格納するためのストレージユニット呼び出しリポジトリを提供します。次の Snowflake CLI コマンドを使用して、 Snowpark Container Services イメージレジストリとリポジトリを管理できます。

Snowpark Container Services イメージレジストリおよびリポジトリに関する詳細については、 Snowpark Container Services: イメージレジストリおよびリポジトリの操作 をご参照ください。

イメージレジストリの管理

Snowflake CLI を使用すると、 Snowpark Container Services イメージリポジトリで次のタスクを実行できます。

リスト表示やドロップなどの一般的な操作では、 Snowflake CLI は Snowflakeオブジェクトの管理 で説明されている snow object コマンドを使用します。

レジストリ認証用の環境トークンを取得する

snow spcs image-registry token コマンドを使用すると、指定した接続に関連付けられたトークンを返すことができます。このトークンは、レジストリでの認証コードとして使用できます。

snow spcs image-registry token --connection mytest
Copy
+----------------------------------------------------------------------------------------------------------------------+
| key        | value                                                                                                   |
|------------+---------------------------------------------------------------------------------------------------------|
| token      | ****************************************************************************************************    |
|            | ****************************************************************************************************    |
| expires_in | 3600                                                                                                    |
+----------------------------------------------------------------------------------------------------------------------+

そのトークンを docker login コマンドにパイプすることで、次のようにDockerコンテナにログインできます。

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

イメージレジストリへのログイン

snow spcs image-registry login は、接続のために指定された認証情報でイメージリポジトリにログインします。ログインする前に、次の前提条件を満たしている必要があります。

  • このコマンドはDockerを使用してSnowflakeにログインするため、 Docker Desktop をインストールする必要があります。

  • レジストリ URL を取得するには、現在のロールでアカウント内のイメージリポジトリに対する READ 権限が必要です。

アカウント認証情報を使用してイメージレジストリにログインするには、次を実行します。

snow spcs image-registry login
Copy
Login Succeeded

イメージレジストリの URL を取得する

snow spcs image-registry url コマンドはイメージリポジトリの URL を返します。レジストリ URL を取得するには、現在のロールでアカウント内のイメージリポジトリに対する READ 権限が必要です。

リポジトリの URL を取得するには、次を実行します。

snow spcs image-registry url
Copy
<orgname-acctname>.registry.snowflakecomputing.com

イメージリポジトリの管理

Snowflake CLI を使用すると、 Snowpark Container Services イメージリポジトリで次のタスクを実行できます。

リスト表示やドロップなどの一般的な操作では、 Snowflake CLI は Snowflakeオブジェクトの管理 で説明されている snow object コマンドを使用します。

イメージリポジトリの作成

snow spcs image-repository create コマンドは、現在のスキーマに新しいイメージレポジトリを作成します。

イメージリポジトリを作成するには、次のようなコマンドを入力します。

snow spcs image-repository create tutorial_repository
Copy
+-------------------------------------------+
| key    | value                            |
|--------+----------------------------------|
| status | Statement executed successfully. |
+-------------------------------------------+

イメージリポジトリの URL を取得する

snow spcs image-repository url コマンドは、イメージリポジトリの URL を取得します。

URL を取得するには、次のようなコマンドを入力します。

snow spcs image-repository url tutorial_repository
Copy
<orgname-acctname>.registry.snowflakecomputing.com/tutorial_db/data_schema/tutorial_repository

イメージリポジトリのタグとイメージを一覧表示する

snow spcs image-repository list-images コマンドを使うと、画像リポジトリの画像とタグを取得できます。

リポジトリ内のイメージを一覧表示するには、次のようなコマンドを入力します。このコマンドは、 my_db データベース内の images という名前のリポジトリにあるイメージを一覧表示します。

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