Docker を使用してイメージを pull する

Docker クライアントの Harbor プロジェクトからイメージを pull して、Harbor レジストリからローカルマシンに指定されたコンテナ イメージをダウンロードします。これにより、コンテナ化されたアプリケーションをローカルで実行したり、他のイメージをビルドするためのベースイメージとして使用したりできます。

始める前に

Docker でイメージを pull するには、次のものにアクセスできる必要があります。

• 必要な ID とアクセスロール。組織の IAM 管理者に、Harbor インスタンス閲覧者（harbor-instance-viewer）ロールを付与するよう依頼します。
• Harbor のロールベース アクセス制御の Limited Guest ロールを持つアカウント。詳細については、API と Harbor インスタンス内のアクセスを構成するをご覧ください。
• 既存の Harbor プロジェクト。詳細については、Harbor プロジェクトを作成するをご覧ください。
• 既存の Harbor プロジェクト内の既存のコンテナ イメージ。

イメージを pull する

Docker クライアントで Harbor プロジェクトからイメージを pull する手順は次のとおりです。

1. Harbor インスタンスに対して認証されていることを確認します。

2. 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-project
• IMAGE: イメージの名前。例: nginx
• TAG: pull するイメージ バージョンのタグ。例: staging
• IMAGE_DIGEST: イメージ コンテンツの sha256 ハッシュ値。イメージの各バージョンにはそれぞれ固有のイメージ ダイジェストがあります。Harbor インスタンスの UI で、特定のイメージをクリックしてダイジェストを表示します。詳細については、Harbor レジストリ インスタンスを表示するをご覧ください。