Extrair uma imagem com o Docker

Extraia uma imagem de um projeto do Harbor no cliente Docker para fazer o download da imagem do 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 de base para criar outras imagens.

Antes de começar

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

Papéis do IAM obrigatórios

Para extrair imagens de instâncias de 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 observar instâncias do Harbor no namespace do projeto. Esse papel inclui as permissões necessárias para visualizar os detalhes das instâncias do Harbor atuais, para que você possa recuperar os URLs de registro necessários para extrair imagens.

Papéis do RBAC do Harbor obrigatórios

Ao contrário dos papéis do IAM do GDC, a extração de imagens exige permissões específicas no sistema de controle de acesso baseado em papéis (RBAC, na sigla em inglês) interno do Harbor. Solicite as permissões necessárias ao administrador. Imponha 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 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. Para mais informações, consulte Visualizar instâncias de registro do Harbor.

A seguir

Depois de confirmar a conexão extraindo uma imagem, você pode usar seus artefatos para iniciar o aplicativo no ambiente: