使用 Docker 提取映像檔

在 Docker 用戶端中，從 Harbor 專案提取映像檔，將指定的容器映像檔從 Harbor 登錄檔下載到本機電腦。這樣一來，您就能在本機執行容器化應用程式，或將其做為基礎映像檔，用於建構其他映像檔。

事前準備

如要使用 Docker 提取映像檔，您必須為環境設定必要的資源和權限，包括現有的 Harbor 專案，其中包含要提取的容器映像檔。詳情請參閱「建立 Harbor 專案」。

必要的 IAM 角色

如要從 Harbor 登錄檔執行個體提取映像檔，請與 IAM 專案管理員聯絡，要求取得「Harbor 執行個體檢視者」 (harbor-instance-viewer) 角色，以便取得、列出及監控專案命名空間中的 Harbor 執行個體。這個角色具備必要權限，可查看現有 Harbor 執行個體的詳細資料，以便擷取提取映像檔所需的登錄檔網址。

必要的 Harbor RBAC 角色

與 GDC IAM 角色不同，提取映像檔需要 Harbor 內部角色式存取控管 (RBAC) 系統中的特定權限。請向管理員要求必要權限。請僅要求特定工作所需的角色，強制執行最小權限原則。

提取映像檔

請按照下列步驟，在 Docker 用戶端中從 Harbor 專案提取映像檔：

  1. 請確認您已驗證 Harbor 執行個體。

  2. 從 Harbor 專案提取映像檔：

    docker pull INSTANCE_URL/HARBOR_PROJECT_NAME/IMAGE:TAG

    或

    docker pull INSTANCE_URL/HARBOR_PROJECT_NAME/IMAGE@IMAGE_DIGEST

替換下列值：

  • INSTANCE_URL：Harbor 執行個體的網址。例如：harbor-1.org-1.zone1.google.gdc.test.。您可以使用 GDC 控制台或 gdcloud CLI 取得 Harbor 執行個體的網址。
  • HARBOR_PROJECT_NAME：Harbor 專案的名稱。例如：my-project。
  • IMAGE：映像檔名稱。例如：nginx。
  • TAG：要提取的映像檔版本標記。例如：staging。
  • IMAGE_DIGEST：映像檔內容的 sha256 雜湊值。每個映像檔版本都有專屬的映像檔摘要。在 Harbor 執行個體 UI 中，按一下特定映像檔即可查看摘要。詳情請參閱「查看 Harbor 登錄檔執行個體」。

後續步驟

確認連線成功後，您可以使用構件在環境中啟動應用程式：