Criar um repositório remoto do Docker Hub

Escolha um shell

Para concluir este guia de início rápido, use o Cloud Shell ou o shell local.

Cloud Shell

O Cloud Shell é um ambiente de shell para gerenciar recursos hospedados no Google Cloud. Ele vem pré-instalado com o Docker e o A Google Cloud CLI, a principal interface de linha de comando do Google Cloud.

Shell local

Se preferir usar seu shell local, instale o Docker e CLI gcloud no seu ambiente.

Como iniciar o Cloud Shell

Para iniciar o Cloud Shell, execute os seguintes passos:

1. Acesse o Console do Google Cloud.

   Console do Google Cloud

2. Clique no botão Ativar o Cloud Shell: .

Uma sessão do Cloud Shell é aberta dentro de um quadro inferior no console. Use esse shell para executar comandos gcloud.

Como configurar um shell local

Para instalar a CLI gcloud e o Docker, execute as seguintes etapas:

1. Instale a CLI da gcloud. Para atualizar uma instalação atual, execute o comando gcloud components update.

2. Instale o Docker se ele ainda não estiver instalado.

3. O Docker requer acesso com privilégios para interagir com registros. No Linux ou no Windows, adicione o usuário utilizado para executar comandos do Docker no grupo de segurança do Docker. Esta etapa não é necessária no macOS, porque O Docker Desktop é executado em uma máquina virtual como usuário raiz.

   Linux

   O grupo de segurança do Docker é chamado de docker. Para adicionar seu nome de usuário, execute o seguinte comando:

   sudo usermod -a -G docker ${USER}
   

   Windows

   O grupo de segurança do Docker é chamado de docker-users. Para adicionar um usuário a partir do prompt de comando do administrador, execute o seguinte comando:

   net localgroup docker-users DOMAIN\USERNAME /add
   

   Em que

   • DOMAIN é seu domínio do Windows.
   • USERNAME é seu nome de usuário.

4. Saia e acesse novamente para a mudança de filiação ao grupo fazer efeito. Se estiver usando uma máquina virtual, talvez seja necessário reiniciar a máquina virtual para a mudança fazer efeito;

5. Para garantir que o Docker esteja ativo, execute o seguinte comando do Docker, que retorna a hora e a data atuais:

   docker run --rm busybox date
   

   A sinalização --rm exclui a instância do contêiner na saída.

Configurar a autenticação do Docker Hub

Para evitar o uso da cota não autenticada do Docker Hub, recomendamos autenticar no Docker Hub ao usar repositórios remotos; Os repositórios remotos permitem que você adicione seu nome de usuário do Docker Hub e um token de acesso pessoal salvo como um Secret para autenticar no Docker Hub.

Criar um token de acesso pessoal do Docker Hub

1. Faça login no Docker Hub.
2. Crie um token de acesso pessoal com somente leitura. permissões.

3. Copie o token de acesso.

4. Salve o token de acesso em um arquivo de texto no seu local ou no Cloud Shell.

Salve seu token de acesso pessoal em um secret

gcloud secrets create my-secret --data-file="/path/to/file.txt"

Conceda à conta de serviço do Artifact Registry acesso ao seu secret

gcloud secrets add-iam-policy-binding my-secret \
    --member="serviceAccount:service-PROJECT-NUMBER@gcp-sa-artifactregistry.iam.gserviceaccount.com" \
    --role="roles/secretmanager.secretAccessor"

Criar um repositório remoto

Crie um repositório remoto do Artifact Registry com o nome quickstart-docker-hub-remote no local us-central1 usando suas credenciais do Docker Hub executando o seguinte comando:

gcloud artifacts repositories create quickstart-docker-hub-remote \
    --project=PROJECT_ID \
    --repository-format=DOCKER  \
    --location=us-central1 \
    --description="Remote Docker repository" \
    --mode=remote-repository \
    --remote-repo-config-desc="Docker Hub" \
    --remote-docker-repo=DOCKER-HUB \
    --remote-username=USERNAME \
    --remote-password-secret-version=projects/PROJECT/secrets/my-secret/versions/1

Em que:

• quickstart-docker-hub-remote é o nome do repositório. Para para cada local de repositório em um projeto, os nomes dos repositórios precisam ser exclusivos.
• PROJECT_ID é o ID do projeto; Se essa sinalização for omitida, o projeto atual ou padrão será usado.
• us-central1 é o local regional ou multirregional do repositório. É possível omitir essa sinalização se você definir um padrão. Para ver uma lista de locais com suporte, execute o comando gcloud artifacts locations list.
• "Remote Docker repository" é a descrição opcional do repositório. Não inclua dados sensíveis, pois as descrições do repositório não são criptografados.
• "Docker Hub" é a descrição opcional de a configuração do repositório externo para este repositório remoto.
• DOCKER-HUB define o repositório remoto upstream para o Docker Hub público upstream.
• USERNAME é seu nome de usuário do Docker Hub;
• projects/PROJECT/secrets/my-secret/versions/1 é a versão do secret que você criou para armazenar o acesso pessoal do Docker Hub com base no token correto anterior.

O Artifact Registry cria o repositório e o adiciona à lista de repositórios.

Configure a autenticação do Docker

Antes de enviar ou extrair imagens, configure o Docker para usar a A Google Cloud CLI para autenticar solicitações ao Artifact Registry.

1. Faça login na CLI gcloud como o usuário que vai executar os comandos do Docker.

   gcloud auth login
   

2. Para configurar a autenticação em repositórios do Docker na região us-central1, execute o seguinte comando:

   gcloud auth configure-docker us-central1-docker.pkg.dev
   

   O comando atualiza a configuração do Docker. Agora é possível se conectar com o Artifact Registry no projeto do Google Cloud para enviar e extrair imagens.

Para mais informações sobre outros métodos de autenticação, consulte a página Métodos de autenticação.

Extrair uma imagem para seu repositório remoto

1. Faça login na CLI gcloud como o usuário que vai executar os comandos do Docker.

   gcloud auth login
   

2. Extrair uma imagem do Docker Hub para sua máquina e para o controle remoto com o seguinte comando:

   docker pull us-central1-docker.pkg.dev/PROJECT/quickstart-docker-hub-remote/busybox:latest
   

   Em que:

   • us-central1 é o local do repositório remoto.
   • us-central1-docker.pkg.dev é o nome do host do repositório do Docker. que você criou.
   • PROJECT é seu Google Cloud ID do projeto. Caso o ID do projeto contenha dois pontos (:), consulte Projetos com escopo de domínio.
   • quickstart-docker-hub-remote é o ID do repositório que você criou.
   • busybox é o nome da imagem que você quer extrair do Docker Hub para o quickstart-docker-hub-remote.
   • latest é a versão da imagem com tag que você quer extrair do Docker Hub.

   A imagem é enviada para sua máquina e armazenada em cache no repositório remoto. Se você extrair a mesma imagem com tag novamente, ela será extraída do controle remoto repositório de dados. Suas credenciais do Docker Hub serão usadas.

3. Liste os artefatos armazenados no repositório remoto:

   gcloud artifacts packages list \
       --location=us-central1 \
       --repository=quickstart-docker-hub-remote
   

   A saída será assim:

   Listing items under project my-project, location us-central1, repository quickstart-docker-hub-remote.
   
   PACKAGE: busybox
   CREATE_TIME: 2023-06-19T18:59:09
   UPDATE_TIME: 2023-06-19T18:59:10