Criar e enviar uma imagem Docker com o Cloud Build

Criar e enviar uma imagem Docker com o Cloud Build

Saiba como começar a usar o Cloud Build criando uma imagem Docker e enviando a imagem ao Artifact Registry. O Artifact Registry fornece um único local para gerenciar imagens particulares de contêiner do Docker e pacotes.

Primeiro, você cria a imagem usando um Dockerfile, que é o arquivo de configuração do Docker, depois cria a mesma imagem usando o arquivo de configuração do Cloud Build.

**Observação** :este guia de início rápido mostra como criar uma imagem com o Docker, mas o Cloud Build é compatível com a maioria das ferramentas do build e as linguagens de programação.

---

Para seguir as instruções da tarefa diretamente no editor do Cloud Shell, clique em Orientação:

Orientações

---

Antes de começar

Faça login na sua Google Cloud conta do. Se você começou a usar o Google Cloud, crie uma conta para avaliar o desempenho dos nossos produtos em situações reais. Clientes novos também recebem US $300 em créditos para executar, testar e implantar cargas de trabalho.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

If you're using an existing project for this guide, verify that you have the permissions required to complete this guide. If you created a new project, then you already have the required permissions.

Verify that billing is enabled for your Google Cloud project.

Enable the Cloud Build, Compute Engine and Artifact Registry APIs.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the APIs

Instale a Google Cloud CLI.

Ao usar um provedor de identidade (IdP) externo, primeiro faça login na CLI gcloud com sua identidade federada.

Para inicializar a CLI gcloud, execute o seguinte comando:

gcloud init

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

If you're using an existing project for this guide, verify that you have the permissions required to complete this guide. If you created a new project, then you already have the required permissions.

Verify that billing is enabled for your Google Cloud project.

Enable the Cloud Build, Compute Engine and Artifact Registry APIs.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the APIs

Instale a Google Cloud CLI.

Ao usar um provedor de identidade (IdP) externo, primeiro faça login na CLI gcloud com sua identidade federada.

Para inicializar a CLI gcloud, execute o seguinte comando:

gcloud init

Se você já instalou a Google Cloud CLI anteriormente, verifique se tem a versão mais recente disponível executando gcloud components update.

Funções exigidas

Para receber as permissões necessárias para criar uma imagem do Docker e enviá-la ao Artifact Registry, peça ao administrador para conceder a você os seguintes papéis do IAM na conta de serviço do Cloud Build:

• Administrador do Artifact Registry (roles/artifactregistry.admin)
• Editor do Cloud Build (roles/cloudbuild.builds.editor)
• Gravador de registros (roles/logging.logWriter)
• Leitor de bucket do Storage (roles/storage.bucketViewer)
• Usuário de objetos do Storage (roles/storage.objectUser)

Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Também é possível conseguir as permissões necessárias usando personalizados papéis ou outros predefinidos papéis.

Preparar os arquivos de origem para o build

Você precisará de um código-fonte de amostra para empacotar em uma imagem do contêiner. Nesta seção, você criará um script de shell e um Dockerfile. Um Dockerfile é um documento de texto que contém instruções para o Docker criar uma imagem.

1. Abra uma janela do terminal.

2. Crie um novo diretório chamado quickstart-docker e navegue até ele:

   mkdir quickstart-docker
   cd quickstart-docker
   

3. Crie um arquivo chamado quickstart.sh com o seguinte conteúdo:

   #!/bin/sh
   echo "Hello, world! The time is $(date)."

4. Crie um arquivo chamado Dockerfile com o seguinte conteúdo:

   FROM alpine
   COPY quickstart.sh /
   CMD ["/quickstart.sh"]

5. Na janela do terminal, execute o seguinte comando para tornar quickstart.sh executável:

   chmod +x quickstart.sh
   

Criar um repositório do Docker no Artifact Registry

1. Use o gcloud artifacts repositories create comando para criar um repositório do Docker chamado quickstart-docker-repo no local us-west2 e com a descrição "repositório do Docker":

   gcloud artifacts repositories create quickstart-docker-repo --repository-format=docker \
       --location=us-west2 --description="Docker repository"
   

2. Verifique se o repositório foi criado:

   gcloud artifacts repositories list
   

   A lista de repositórios exibidos precisa incluir quickstart-docker-repo.

   O Artifact Registry usa uma convenção de nomenclatura para identificar repositórios e imagens. Por exemplo, quando você interage com imagens do Docker armazenadas no Artifact Registry na região us-west2, use us-west2-docker.pkg.dev como o nome do host do registro nos comandos.

Criar uma imagem usando o Dockerfile

Use o comando gcloud builds submit para criar uma imagem Docker usando um Dockerfile. Você não precisa de um arquivo de configuração separado do Cloud Build.

1. Receba o ID do seu Google Cloud projeto executando o seguinte comando:

   gcloud config get-value project
   

2. Execute o seguinte comando no diretório que contém quickstart.sh e Dockerfile:

   gcloud builds submit --region=us-west2 --tag us-west2-docker.pkg.dev/PROJECT_ID/quickstart-docker-repo/quickstart-image:tag1
   

   Observação: se o ID do projeto contiver dois pontos, substitua-os por uma barra.

   Após a conclusão do build, a saída será semelhante a esta:

   DONE
   ------------------------------------------------------------------------------------------------------------------------------------
   ID                                    CREATE_TIME                DURATION  SOURCE   IMAGES     STATUS
   545cb89c-f7a4-4652-8f63-579ac974be2e  2020-11-05T18:16:04+00:00  16S       gs://gcb-docs-project_cloudbuild/source/1604600163.528729-b70741b0f2d0449d8635aa22893258fe.tgz  us-west2-docker.pkg.dev/gcb-docs-project/quickstart-docker-repo/quickstart-image:tag1  SUCCESS
   

Você acabou de criar uma imagem Docker chamada quickstart-image usando um Dockerfile e a enviou para o Artifact Registry.

Criar uma imagem usando um arquivo de configuração do build

Nesta seção, você usa um arquivo de configuração do Cloud Build para criar a mesma imagem Docker criada nas etapas anteriores. O arquivo de configuração de build instrui o Cloud Build a realizar tarefas com base nas suas especificações.

1. No mesmo diretório que contém quickstart.sh e Dockerfile, crie um arquivo chamado cloudbuild.yaml com o seguinte conteúdo. Esse arquivo é o arquivo de configuração da versão. No tempo de build, o Cloud Build substitui automaticamente $PROJECT_ID pelo ID do projeto.

   steps:
   - name: 'gcr.io/cloud-builders/docker'
     script: |
       docker build -t us-west2-docker.pkg.dev/$PROJECT_ID/quickstart-docker-repo/quickstart-image:tag1 .
     automapSubstitutions: true
   images:
   - 'us-west2-docker.pkg.dev/$PROJECT_ID/quickstart-docker-repo/quickstart-image:tag1'

2. Inicie o build executando o seguinte comando:

   gcloud builds submit --region=us-west2 --config cloudbuild.yaml
   

   Após a conclusão do build, a saída será semelhante a esta:

    DONE
    ------------------------------------------------------------------------------------------------------------------------------------
    ID                                    CREATE_TIME                DURATION  SOURCE          IMAGES          STATUS
    046ddd31-3670-4771-9336-8919e7098b11  2020-11-05T18:24:02+00:00  15S       gs://gcb-docs-project_cloudbuild/source/1604600641.576884-8153be22c94d438aa86c78abf11403eb.tgz  us-west2-docker.pkg.dev/gcb-docs-project/quickstart-docker-repo/quickstart-image:tag1  SUCCESS
   

Você acabou de criar quickstart-image usando o arquivo de configuração da versão e enviou a imagem para o Artifact Registry.

Ver detalhes do build

1. Abra a página do Cloud Build no console. Google Cloud

   Abra a página do Cloud Build

2. Se necessário, selecione o projeto e clique em Abrir.

   Você verá a página Histórico da versão:

   

3. Se necessário, selecione us-west2no menu suspenso Região para visualizar os builds nessa região.

   Haverá dois builds listados, um para cada um dos builds executados neste guia de início rápido.

4. Clique em um dos builds.

   Você verá a página Detalhes do build :

5. Para ver os artefatos do build em Resumo do build, clique em Artefatos de builds.

   A resposta será semelhante a esta:

   

   Nesta página, faça o download do seu registro da build e veja os detalhes da imagem no Artifact Registry.

Limpar

Para evitar cobranças na conta do Google Cloud pelos recursos usados nesta página, siga as etapas abaixo.

1. Abra a página do Artifact Registry no Google Cloud console.

   Abrir a página do Artifact Registry

2. Selecione o projeto e clique em Abrir.

3. Selecione quickstart-docker-repo.

4. Clique em Excluir.

Você já excluiu o repositório criado como parte deste guia de início rápido.

A seguir

• Saiba como executar uma imagem Docker.
• Saiba como criar um arquivo de configuração do build básico.
• Saiba como implantar usando o Cloud Build.
• Saiba como criar aplicativos Node.js.
• Saiba como criar aplicativos Java.
• Saiba como criar aplicativos Go.