GSP1131

Visão geral

O Artifact Registry é um serviço seguro, escalonável e totalmente gerenciado para armazenar, gerenciar e proteger seus artefatos e dependências de build. Você vai aprender a criar um repositório privado do Docker, configurar a autenticação e enviar e extrair uma imagem de amostra do Docker. Esta experiência prática vai oferecer a você um entendimento básico de como usar o Artifact Registry para seus aplicativos conteinerizados.

Objetivos

Neste laboratório, você vai aprender a fazer o seguinte:

• Criar um repositório Docker particular no Artifact Registry
• Configurar a autenticação
• Enviar uma imagem para o repositório
• Extrair a imagem do repositório

Pré-requisitos

É recomendável ter alguma experiência com o Docker para este laboratório. Confira a documentação do Docker para uma revisão ou introdução. Você também pode conferir nosso laboratório Introdução ao Docker para mais prática.

Configuração e requisitos

Antes de clicar no botão Começar o Laboratório

Leia estas instruções. Os laboratórios são cronometrados e não podem ser pausados. O timer é ativado quando você clica em Iniciar laboratório e mostra por quanto tempo os recursos do Google Cloud vão ficar disponíveis.

Este laboratório prático permite que você realize as atividades em um ambiente real de nuvem, e não em uma simulação ou demonstração. Você vai receber novas credenciais temporárias para fazer login e acessar o Google Cloud durante o laboratório.

Confira os requisitos para concluir o laboratório:

• Acesso a um navegador de Internet padrão (recomendamos o Chrome).

• Tempo para concluir o laboratório: não se esqueça que, depois de começar, não será possível pausar o laboratório.

Como iniciar seu laboratório e fazer login no console do Google Cloud

1. Clique no botão Começar o laboratório. Se for preciso pagar por ele, uma caixa de diálogo vai aparecer para você selecionar a forma de pagamento. No painel Detalhes do Laboratório, à esquerda, você vai encontrar o seguinte:

   • O botão Abrir Console do Google Cloud
   • O tempo restante
   • As credenciais temporárias que você vai usar neste laboratório
   • Outras informações, se forem necessárias

2. Se você estiver usando o navegador Chrome, clique em Abrir console do Google Cloud ou clique com o botão direito do mouse e selecione Abrir link em uma janela anônima.

   O laboratório ativa os recursos e depois abre a página Fazer Login em outra guia.

   Dica: coloque as guias em janelas separadas lado a lado.

   Observação: se aparecer a caixa de diálogo Escolher uma conta, clique em Usar outra conta.

3. Se necessário, copie o Nome de usuário abaixo e cole na caixa de diálogo Fazer login.

   {{{user_0.username | "Username"}}}

   Você também encontra o nome de usuário no painel Detalhes do Laboratório.

4. Clique em Próxima.

5. Copie a Senha abaixo e cole na caixa de diálogo de Olá.

   {{{user_0.password | "Password"}}}

   Você também encontra a senha no painel Detalhes do Laboratório.

6. Clique em Próxima.

   Importante: você precisa usar as credenciais fornecidas no laboratório, e não as da sua conta do Google Cloud. Observação: se você usar sua própria conta do Google Cloud neste laboratório, é possível que receba cobranças adicionais.

7. Acesse as próximas páginas:

   • Aceite os Termos e Condições.
   • Não adicione opções de recuperação nem autenticação de dois fatores (porque essa é uma conta temporária).
   • Não se inscreva em testes gratuitos.

Depois de alguns instantes, o console do Google Cloud será aberto nesta guia.

Observação: para acessar os produtos e serviços do Google Cloud, clique no Menu de navegação ou digite o nome do serviço ou produto no campo Pesquisar.

Ativar o Cloud Shell

O Cloud Shell é uma máquina virtual com várias ferramentas de desenvolvimento. Ele tem um diretório principal permanente de 5 GB e é executado no Google Cloud. O Cloud Shell oferece acesso de linha de comando aos recursos do Google Cloud.

1. Clique em Ativar o Cloud Shell na parte de cima do console do Google Cloud.

2. Clique nas seguintes janelas:

   • Continue na janela de informações do Cloud Shell.
   • Autorize o Cloud Shell a usar suas credenciais para fazer chamadas de APIs do Google Cloud.

Depois de se conectar, você verá que sua conta já está autenticada e que o projeto está configurado com seu Project_ID, . A saída contém uma linha que declara o projeto PROJECT_ID para esta sessão:

A gcloud é a ferramenta de linha de comando do Google Cloud. Ela vem pré-instalada no Cloud Shell e aceita preenchimento com tabulação.

3. (Opcional) É possível listar o nome da conta ativa usando este comando:

4. Clique em Autorizar.

Saída:

5. (Opcional) É possível listar o ID do projeto usando este comando:

Saída:

Tarefa 1: criar um repositório do Docker

Nesta seção, você vai criar um repositório particular do Docker no Artifact Registry. Esse repositório vai servir como um local central para armazenar e gerenciar suas imagens do Docker. Você vai usar a ferramenta de linha de comando gcloud para criar o repositório e verificar a criação dele no console do Google Cloud.

1. Abra uma nova janela do Cloud Shell clicando no ícone () no canto superior direito do console.

2. Execute o seguinte comando para receber o ID do projeto e salvá-lo como uma variável de ambiente:

3. Execute o seguinte comando para criar um novo repositório do Docker chamado example-docker-repo no local com a descrição "Repositório do Docker".

4. Execute o seguinte comando para verificar se o repositório foi criado.

5. Na barra de pesquisa na parte de cima do console, digite Artifact Registry e selecione o primeiro resultado.

6. Na página do produto Artifact Registry, confirme se você encontra o repositório. A visualização será parecida com esta:

7. Clique no repositório example-docker-repo. Você vai notar que não há arquivos no repositório. Nas próximas seções, você vai adicionar arquivos ao repositório.

Clique em Verificar meu progresso para conferir o objetivo. Criar um repositório do Docker.

Tarefa 2: configurar a autenticação do Artifact Registry

Para enviar e extrair imagens do repositório Docker recém-criado, você precisa configurar o Docker para autenticar com o Artifact Registry. Isso envolve a configuração de credenciais que permitem que o cliente Docker interaja com o repositório de forma segura.

Antes de enviar ou extrair imagens, é necessário configurar o Docker para usar a CLI do Google Cloud e autenticar solicitações ao Artifact Registry.

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

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

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

Tarefa 3: acessar uma imagem para enviar

Você vai precisar de uma imagem do Docker para trabalhar neste laboratório. Em vez de criar uma imagem do zero, você vai extrair uma imagem de amostra pré-criada de um repositório público. Isso permite que você se concentre na interação com o Artifact Registry.

Neste laboratório, você vai enviar uma imagem de amostra chamada hello-app.

1. Execute o comando a seguir para extrair a versão 1.0 da imagem.

Os caminhos de imagens no Artifact Registry incluem várias partes. Para esta imagem de amostra:

• us-docker.pkg.dev é o nome do host das imagens de contêiner armazenadas nos repositórios do Docker do Artifact Registry, que inclui o local do repositório (us).
• google-samples é o ID do projeto.
• containers é o ID do repositório.
• /gke/hello-app é o caminho para a imagem no repositório containers.

Tarefa 4: adicionar a imagem ao repositório

Agora você vai adicionar a imagem de amostra ao seu repositório particular. Isso envolve incluir a tag na imagem com o nome do repositório para especificar o destino e, em seguida, enviar para o Artifact Registry.

Antes de enviar a imagem do Docker ao Artifact Registry, marque-a com o nome do repositório.

Marcar a imagem com um nome de registro

Marcar a imagem garante que ela seja enviada para o local correto, que neste laboratório é -docker.pkg.dev.

1. Execute o comando a seguir para marcar a imagem como sample-image:tag1:

Em que:

• é o local do repositório.
• -docker.pkg.dev é o nome do host do repositório do Docker que você criou.
• $PROJECT_ID é o ID do seu projeto do Google Cloud.
• example-docker-repo é o ID do repositório que você criou.
• sample-image é o nome da imagem que você quer usar no repositório. O nome da imagem pode ser diferente do nome da imagem local. Para este laboratório, você vai armazenar a imagem diretamente no ID do repositório example-docker-repo.
• tag1 é a tag que você está adicionando à imagem do Docker O Docker aplicará a tag padrão latest se você não tiver especificado uma.

Agora você está pronto para enviar a imagem ao repositório que criou.

Envie a imagem para o Artifact Registry

Depois de configurar a autenticação e marcar a imagem local, é possível enviá-la para o repositório que você criou.

Basta executar o comando a seguir:

Clique em Verificar meu progresso para conferir o objetivo. Adicionar a imagem ao repositório.

Tarefa 5: extrair a imagem do Artifact Registry

Por fim, você vai extrair a imagem que acabou de enviar para o repositório particular. Isso simula como você acessaria e usaria imagens armazenadas no Artifact Registry em um cenário real.

1. Para extrair a imagem do Artifact Registry para a máquina local, execute o comando a seguir:

A resposta será semelhante a esta:

Parabéns!

Neste laboratório, você criou um repositório privado do Docker no Artifact Registry, configurou a autenticação, enviou uma imagem de amostra para o repositório e fez a extração da imagem de volta. Agora você tem um entendimento básico de como usar o Artifact Registry para gerenciar suas imagens do Docker.

Próximas etapas / Saiba mais

• Consulte a documentação do Artifact Registry
• Saiba mais sobre o Docker
• Confira mais laboratórios no Google Cloud Ensina

Treinamento e certificação do Google Cloud

Esses treinamentos ajudam você a aproveitar as tecnologias do Google Cloud ao máximo. Nossas aulas incluem habilidades técnicas e práticas recomendadas para ajudar você a alcançar rapidamente o nível esperado e continuar sua jornada de aprendizado. Oferecemos treinamentos que vão do nível básico ao avançado, com opções de aulas virtuais, sob demanda e por meio de transmissões ao vivo para que você possa encaixá-las na correria do seu dia a dia. As certificações validam sua experiência e comprovam suas habilidades com as tecnologias do Google Cloud.

Manual atualizado em 28 de novembro de 2024

Laboratório testado em 28 de novembro de 2024

Copyright 2025 Google LLC. Todos os direitos reservados. Google e o logotipo do Google são marcas registradas da Google LLC. Todos os outros nomes de produtos e empresas podem ser marcas registradas das respectivas empresas a que estão associados.