Fazer login no Docker e no Helm

Neste documento, descrevemos como fazer login no Docker ou no Helm usando secrets da CLI.

As instâncias do registro do Harbor no dispositivo com isolamento físico do Google Distributed Cloud (GDC) usam o Identity-Aware Proxy (IAP) para autenticação. Depois de fazer login na interface da Web do Harbor usando o IAP pela primeira vez, é possível recuperar um secret estático da CLI no seu perfil de usuário do Harbor e usá-lo como senha ao fazer login na CLI do Docker ou do Helm. Esse método só está disponível com a interface do Harbor.

Antes de começar

Papéis necessários do IAM

Para configurar a autenticação para instâncias do registro do Harbor, entre em contato com o administrador do IAM do projeto para solicitar o papel de Leitor de instâncias do Harbor (harbor-instance-viewer), que permite receber, listar e assistir instâncias do Harbor no namespace do projeto. Esse papel inclui as permissões necessárias para visualizar os detalhes das instâncias atuais do Harbor para que você possa recuperar os URLs do registro para autenticação.

Fazer login com secrets da CLI

Para fazer login no Docker ou no Helm com secrets da CLI, siga estas etapas:

  1. Faça login no Harbor com uma conta de usuário do IAP.
  2. Clique no seu nome de usuário e selecione Perfil do usuário.
  3. Para copiar a chave secreta da CLI associada à sua conta, clique em Copiar.

  4. Opcional: para exibir botões para gerar automaticamente ou criar manualmente uma nova chave secreta da CLI, clique em Mais no seu perfil de usuário.

  5. Se você gerou uma nova chave secreta da CLI, clique em Copiar para copiá-la.

  6. Use o secret da CLI como senha ao fazer login no Harbor pela CLI do Docker ou do Helm:

    docker login -u USERNAME -p CLI_SECRET HARBOR_INSTANCE_URL

    Substitua:

    • USERNAME: o nome de usuário da conta do Harbor.
    • CLI_SECRET: a chave secreta da CLI gerada.
    • HARBOR_INSTANCE_URL: o URL da instância do Harbor.