Criar e enviar uma imagem do Docker com o Cloud Build

Antes de começar

Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

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

Go to project selector

Make sure that billing is enabled for your Google Cloud project.

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

Enable the APIs

Install the Google Cloud CLI.

If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

To initialize the gcloud CLI, run the following command:

gcloud init

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

Go to project selector

Make sure that billing is enabled for your Google Cloud project.

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

Enable the APIs

Install the Google Cloud CLI.

If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

To initialize the gcloud CLI, run the following command:

gcloud init

1. Make sure that you have the following role or roles on the project: Artifact Registry Administrator, Cloud Build Editor, Logs Viewer, Service Account User, Service Usage Admin, Storage Bucket Viewer, Storage Object Creator

   Check for the roles

   1. In the Google Cloud console, go to the IAM page.

      Go to IAM
   2. Select the project.

   3. In the Principal column, find all rows that identify you or a group that you're included in. To learn which groups you're included in, contact your administrator.

   4. For all rows that specify or include you, check the Role column to see whether the list of roles includes the required roles.

   Grant the roles

   1. In the Google Cloud console, go to the IAM page.

      Acessar o IAM
   2. Selecionar um projeto.
   3. Clique em person_addCONCEDER ACESSO.

   4. No campo Novos principais, insira seu identificador de usuário. Normalmente, é o endereço de e-mail de uma Conta do Google.

   5. Na lista Selecionar um papel, escolha um.
   6. Para conceder outros papéis, clique em add Adicionar outro papel e adicione cada papel adicional.
   7. Clique em Salvar.

   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ê vai 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 de 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. Crie um novo repositório do Docker denominado 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
      

      Você verá quickstart-docker-repo na lista de repositórios exibidos.

   Criar uma imagem usando o Dockerfile

   O Cloud Build torna possível que você crie uma imagem do Docker usando um Dockerfile. Você não precisa de um arquivo de configuração separado do Cloud Build.

   Para criar usando um Dockerfile:

   1. Para receber o ID do projeto Google Cloud , execute 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
      

   Após a conclusão da build, você verá uma resposta 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 do Docker chamada quickstart-image usando um Dockerfile e enviou a imagem para o Artifact Registry.

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

   Nesta seção, você usará um arquivo de configuração do Cloud Build para criar a mesma imagem do Docker como acima. 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 momento da criação, 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
      

   Quando a criação for concluída, você verá um resultado semelhante a este:

   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 Google Cloud console.

      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-west2 no menu suspenso Região para conferir os builds nessa região.

      Dois builds vão aparecer na lista, um para cada build executado 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 de criação, em Resumo da build, clique em Artefatos da build.

      Você verá um resultado semelhante a este:

      

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