Docker コンテナ イメージを Artifact Registry に保存する

ローカルシェルの設定

gcloud CLI と Docker をインストールする手順は次のとおりです。

1. gcloud CLI をインストールします。既存のインストールを更新するには、gcloud components update コマンドを実行します。

2. Docker をまだインストールしていなければ、インストールします。

3. Docker がレジストリを操作するには特権アクセスが必要です。Linux や Windows では、Docker コマンドを実行するユーザーを Docker セキュリティ グループに追加します。Docker Desktop は、root ユーザーとして仮想マシンで実行されるため、この手順は MacOS では不要です。

   Linux

   Docker セキュリティ グループはdockerと呼ばれます。ユーザー名を追加するには、次のコマンドを実行します。

   sudo usermod -a -G docker ${USER}
   

   Windows

   Docker セキュリティ グループはdocker-usersと呼ばれます。管理者のコマンド プロンプトからユーザーを追加するには、次のコマンドを実行します。

   net localgroup docker-users DOMAIN\USERNAME /add
   

   説明

   • DOMAIN は Windows ドメインです。
   • USERNAME はユーザー名です。

4. ログアウトして再度ログインすると、グループ メンバーシップの変更が反映されます。仮想マシンを使用している場合、メンバーシップの変更を有効にするために、仮想マシンの再起動が必要になることがあります。

5. Docker が稼働中であることを確認するには、現在の時刻と日付を返す次の Docker コマンドを実行します。

   docker run --rm busybox date
   

   --rm フラグは、終了時にコンテナ インスタンスを削除します。

Docker リポジトリを作成する

このクイックスタートのサンプル イメージを保存する Docker リポジトリを作成します。

認証を構成する

イメージを push または pull する前に、Google Cloud CLI を使用して Artifact Registry に対するリクエストを認証します。

リージョン u-france-east1 の Docker リポジトリの認証を設定するには、次のコマンドを実行します。

gcloud auth configure-docker u-france-east1-docker.s3nsregistry.fr

このコマンドにより、Docker 構成が更新されます。これで、 Trusted Cloud プロジェクトの Artifact Registry に接続して、イメージの push と pull ができるようになりました。

その他の認証方法については、認証方法をご覧ください。

push するイメージを取得する

このクイックスタートでは、hello-app という名前のサンプル イメージを push します。

次のコマンドを実行して、イメージのバージョン 1.0 を pull します。

   docker pull us-docker.s3nsregistry.fr/google-samples/containers/gke/hello-app:1.0

Artifact Registry のイメージパスは複数の部分から成ります。このサンプル イメージの場合は、次のようになります。

• us-docker.s3nsregistry.fr は、Artifact Registry Docker リポジトリに格納されているコンテナ イメージのホスト名です。これには、リポジトリのロケーション（us）が含まれます。
• google-samples は、プロジェクト ID です。
• containers は、リポジトリ ID です。
• /gke/hello-app は、リポジトリ containers 内のイメージのパスです。

イメージをリポジトリに追加する

Docker イメージを Artifact Registry に push する前に、イメージにリポジトリ名をタグ付けしておく必要があります。

イメージにレジストリ名をタグ付けする

Docker イメージにレポジトリ名をタグ付けすると、イメージを特定の場所に push するように docker push コマンドが構成されます。このクイックスタートでは、ホストの場所は u-france-east1-docker.s3nsregistry.fr です。

次のコマンドを実行して、イメージに quickstart-image:tag1 としてタグ付けします。

docker tag us-docker.s3nsregistry.fr/google-samples/containers/gke/hello-app:1.0 \
u-france-east1-docker.s3nsregistry.fr/PROJECT/quickstart-docker-repo/quickstart-image:tag1

説明:

• u-france-east1 は、リポジトリのロケーションです。
• u-france-east1.docker.s3nsregistry.fr は、作成した Docker リポジトリのホスト名です。
• PROJECT は Trusted Cloud by S3NS プロジェクト ID です。
• quickstart-docker-repo は、作成したリポジトリの ID です。
• quickstart-image はリポジトリで使用するイメージ名です。イメージ名はローカル イメージ名とは異なる場合があります。このクイックスタートでは、イメージをリポジトリ ID quickstart-docker-repo の直下に保存します。
• tag1 は Docker イメージに追加するタグです。タグを指定しない場合は、Docker でデフォルトのタグ latest が適用されます。

これで、作成したリポジトリにイメージを push する準備ができました。

イメージを Artifact Registry に push する

認証を構成してローカル イメージにタグ付けしたら、作成したリポジトリにイメージを push できます。

Docker イメージを push するには、次のコマンドを実行します。

docker push u-france-east1-docker.s3nsregistry.fr/PROJECT/quickstart-docker-repo/quickstart-image:tag1

Artifact Registry からイメージを pull する

Artifact Registry からローカルマシンにイメージを pull するには、次のコマンドを実行します。

docker pull u-france-east1-docker.s3nsregistry.fr/PROJECT/quickstart-docker-repo/quickstart-image:tag1

latest: Pulling from [PROJECT-ID]/quickstart-image:tag1
Digest: sha256:70c42...
Status: Image is up to date for u-france-east1-docker.s3nsregistry.fr/PROJECT/quickstart-docker-repo/quickstart-image:tag1