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 インスタンスの詳細を表示するために必要な権限が含まれているため、認証用のレジストリ URL を取得できます。

CLI シークレットでログインする

CLI シークレットを使用して Docker または Helm にログインする手順は次のとおりです。

  1. IAP ユーザー アカウントで Harbor にログインします。
  2. ユーザー名をクリックし、[ユーザー プロフィール] を選択します。
  3. アカウントに関連付けられている CLI シークレットをコピーするには、 [コピー] をクリックします。

  4. 省略可: 新しい CLI シークレットを自動生成または手動作成するためのボタンを表示するには、ユーザー プロファイルの [その他] をクリックします。

  5. 新しい CLI シークレットを生成した場合は、 [コピー] をクリックしてコピーします。

  6. Docker CLI または Helm CLI から Harbor にログインするときに、CLI シークレットをパスワードとして使用します。

    docker login -u USERNAME -p CLI_SECRET HARBOR_INSTANCE_URL

    次のように置き換えます。

    • USERNAME: Harbor アカウントのユーザー名。
    • CLI_SECRET: 生成された CLI シークレット。
    • HARBOR_INSTANCE_URL: Harbor インスタンスの URL。