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 レジストリ インスタンスを表示するをご覧ください。