Extrair uma imagem com o Docker

Extraia uma imagem de um projeto do Harbor no cliente do Docker para fazer o download da imagem de contêiner especificada do registro do Harbor para sua máquina local. Isso permite executar o aplicativo conteinerizado localmente ou usá-lo como uma imagem base para criar outras imagens.

Antes de começar

Para extrair uma imagem com o Docker, configure o ambiente com os recursos e as permissões necessários, incluindo um projeto do Harbor com a imagem do contêiner que você quer extrair. Para mais informações, consulte Criar projetos do Harbor.

Papéis necessários do IAM

Para extrair imagens de instâncias do registro do Harbor, entre em contato com o administrador do projeto do IAM 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 de registro necessários para extrair imagens.

Papéis do RBAC do Harbor necessários

Ao contrário dos papéis do IAM do GDC, a extração de imagens requer permissões específicas no sistema interno de controle de acesso baseado em papéis (RBAC, na sigla em inglês) do Harbor. Solicite as permissões necessárias ao administrador. Aplique o acesso com privilégio mínimo solicitando apenas os papéis necessários para suas tarefas específicas.

Extrair uma imagem

Siga estas etapas para extrair uma imagem de um projeto do Harbor no cliente do Docker:

  1. Verifique se você está autenticado na instância do Harbor.

  2. Extraia a imagem de um projeto do Harbor:

    docker pull INSTANCE_URL/HARBOR_PROJECT_NAME/IMAGE:TAG

    ou

    docker pull INSTANCE_URL/HARBOR_PROJECT_NAME/IMAGE@IMAGE_DIGEST

Substitua os seguintes valores:

  • INSTANCE_URL: o URL da instância do Harbor. Por exemplo, harbor-1.org-1.zone1.google.gdc.test. É possível acessar o URL da instância do Harbor usando o console do GDC ou a CLI gdcloud.
  • HARBOR_PROJECT_NAME: o nome do projeto do Harbor. Por exemplo, my-project.
  • IMAGE: o nome da imagem. Por exemplo, nginx.
  • TAG: a tag da versão de imagem que você quer extrair. Por exemplo, staging.
  • IMAGE_DIGEST: o valor de hash sha256 do conteúdo da imagem. Cada versão de uma imagem tem um resumo de imagem exclusivo. Na UI da instância do Harbor, clique na imagem específica para ver o resumo dela. Para mais informações, consulte Ver instâncias do registro do Harbor.

A seguir

Depois de confirmar a conexão extraindo uma imagem, use os artefatos para iniciar o aplicativo no seu ambiente: