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

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

プロジェクト定義からのイメージリポジトリの作成とデプロイ

イメージリポジトリをステージにデプロイするには、 snowflake.yml プロジェクト定義ファイルを作成し、 snow spcs image-repository deploy コマンドを実行します。

snowflake.yml プロジェクト定義ファイルのサンプルは次のとおりです。

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

以下のテーブルは、コンピューティングプールプロジェクト定義のプロパティを表しています。

イメージリポジトリプロジェクト定義プロパティ

プロパティ

定義

タイプ

required, string

image-repository でなければなりません。

識別子

optional, string

エンティティのSnowflake識別子。この値には次のような形式があります。

  • 文字列識別子テキスト

    identifier: my-image-repository
    Copy

    引用符で囲まれていない識別子と引用符で囲まれた識別子の両方がサポートされています。引用符で囲まれた識別子を使用するには、 YAML の値に引用符で囲んでください（例えば、 "My Image Repository"）。

  • オブジェクト

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

    注釈

    schema または database を指定し、 name プロパティに完全修飾名を使用するとエラーが発生します（mydb.schema1.my-app など）。

イメージリポジトリを作成してデプロイするには、以下の手順を実行します。

  1. 現在のディレクトリをプロジェクト定義ファイルのあるディレクトリに変更します。

  2. 次のような snow spcs image-repository deploy コマンドを実行します。

    snow spcs image-repository deploy
    Copy
    +---------------------------------------------------------------------+
| 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
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                                  |
+----------------------------+---------------+---------+-------------------------------------------------+-----------------------------------------+
言語: 日本語