使用 Docker 提取映像檔

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

事前準備

如要使用 Docker 提取映像檔，您必須有權存取下列項目：

• 必要的身分與存取權角色。請機構 IAM 管理員授予您 Harbor 執行個體檢視者 (harbor-instance-viewer) 角色。
• 在 Harbor 的角色型存取控管中，具有「Limited Guest」角色的帳戶。詳情請參閱設定 API 和 Harbor 執行個體內的存取權。
• 現有的 Harbor 專案。詳情請參閱「建立 Harbor 專案」。
• 現有 Harbor 專案中的現有容器映像檔。

提取映像檔

如要從 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 執行個體的 URL。
• HARBOR_PROJECT_NAME：Harbor 專案的名稱。例如：my-project。
• IMAGE：圖片的名稱。例如：nginx。
• TAG：要提取的映像檔版本標記。例如：staging。
• IMAGE_DIGEST：圖片內容的 sha256 雜湊值。每個圖片版本都有專屬的圖片摘要。在 Harbor 執行個體 UI 中，按一下特定映像檔即可查看摘要。詳情請參閱「查看 Harbor 登錄檔執行個體」。