登入 Docker 和 Helm

本文說明如何使用 CLI 密鑰登入 Docker 或 Helm。

Google Distributed Cloud (GDC) 實體隔離設備中的 Harbor 登錄檔執行個體,會使用 Identity-Aware Proxy (IAP) 進行驗證。首次使用 IAP 登入 Harbor 網頁介面後,您可以從 Harbor 使用者個人資料擷取靜態 CLI 密鑰,並在透過 Docker 或 Helm CLI 登入時,將該密鑰做為密碼使用。這個方法僅適用於 Harbor UI。

事前準備

必要的 IAM 角色

如要設定 Harbor 登錄檔執行個體的驗證機制,請與專案 IAM 管理員聯絡,要求取得 Harbor 執行個體檢視者 (harbor-instance-viewer) 角色,以便取得、列出及監控專案命名空間中的 Harbor 執行個體。這個角色具備必要權限,可查看現有 Harbor 執行個體的詳細資料,以便擷取登錄檔網址進行驗證。

使用 CLI 密鑰登入

如要使用 CLI Secret 登入 Docker 或 Helm,請按照下列步驟操作:

  1. 使用 IAP 使用者帳戶登入 Harbor。
  2. 按一下使用者名稱,然後選取「使用者個人資料」。
  3. 如要複製與帳戶相關聯的 CLI 密鑰,請按一下 「Copy」(複製)。
  4. 選用:如要顯示自動產生或手動建立新 CLI 密鑰的按鈕,請按一下使用者個人資料中的 「More」(更多)。

  5. 如果您產生了新的 CLI 密鑰,請按一下 「Copy」(複製) 複製密鑰。

  6. 從 Docker 或 Helm CLI 登入 Harbor 時,請使用 CLI 密鑰做為密碼:

    docker login -u USERNAME -p CLI_SECRET HARBOR_INSTANCE_URL
    

    更改下列內容:

    • USERNAME:Harbor 帳戶使用者名稱。
    • CLI_SECRET:產生的 CLI 密鑰。
    • HARBOR_INSTANCE_URL:Harbor 執行個體的網址。