Docker クライアントの Harbor プロジェクトからイメージを pull して、Harbor レジストリからローカルマシンに指定されたコンテナ イメージをダウンロードします。これにより、コンテナ化されたアプリケーションをローカルで実行したり、他のイメージをビルドするためのベースイメージとして使用したりできます。
始める前に
Docker でイメージを pull するには、次のものにアクセスできる必要があります。
- 必要な ID とアクセスロール。組織の IAM 管理者に、Harbor インスタンス閲覧者（
harbor-instance-viewer）ロールを付与するよう依頼します。 - Harbor のロールベース アクセス制御の
Limited Guestロールを持つアカウント。詳細については、API と Harbor インスタンス内のアクセスを構成するをご覧ください。 - 既存の Harbor プロジェクト。詳細については、Harbor プロジェクトを作成するをご覧ください。
- 既存の Harbor プロジェクト内の既存のコンテナ イメージ。
イメージを pull する
Docker クライアントで Harbor プロジェクトからイメージを pull する手順は次のとおりです。
- Harbor インスタンスに対して認証されていることを確認します。
Harbor プロジェクトからイメージを pull します。
docker pull INSTANCE_URL/HARBOR_PROJECT_NAME/IMAGE:TAGまたは
docker pull INSTANCE_URL/HARBOR_PROJECT_NAME/IMAGE@IMAGE_DIGEST
次の値を置き換えます。
INSTANCE_URL: Harbor インスタンスの URL。たとえば、harbor-1.org-1.zone1.google.gdc.test.GDC コンソールまたは gdcloud CLI を使用して、Harbor インスタンスの URL を取得できます。HARBOR_PROJECT_NAME: Harbor プロジェクトの名前。例:my-projectIMAGE: イメージの名前。例:nginxTAG: pull するイメージ バージョンのタグ。例:stagingIMAGE_DIGEST: イメージ コンテンツの sha256 ハッシュ値。イメージの各バージョンにはそれぞれ固有のイメージ ダイジェストがあります。Harbor インスタンスの UI で、特定のイメージをクリックしてダイジェストを表示します。詳細については、Harbor レジストリ インスタンスを表示するをご覧ください。