Guia de início rápido: criar

Nesta página, explicamos como usar o Cloud Build para criar uma imagem do Docker e enviar a imagem para o Container Registry. O Container Registry oferece armazenamento seguro de imagens particulares do Docker no Google Cloud.

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.

Antes de começar

  1. Faça login na sua conta do Google.

    Se você ainda não tiver uma, inscreva-se.

  2. No Console do Cloud, na página do seletor de projetos, selecione ou crie um projeto do Cloud.

    Acessar a página do seletor de projetos

  3. Verifique se a cobrança está ativada para o seu projeto do Google Cloud. Saiba como confirmar se a cobrança está ativada para o seu projeto.

  4. Ative a API Cloud Build.

    Ative a API

  5. Instale e inicialize o SDK do Cloud..

Como preparar arquivos de origem

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 simples 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. Execute o seguinte comando para tornar quickstart.sh executável:

    chmod +x quickstart.sh
    

Criar 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 do Cloud, execute o seguinte comando:

    gcloud config get-value project
    
  2. Execute o seguinte comando no diretório que contém o quickstart.sh e Dockerfile, em que project-id é o ID do projeto do Cloud:

    gcloud builds submit --tag gcr.io/project-id/quickstart-image
    

Após a conclusão da build, você verá uma resposta semelhante a esta:

DONE
-------------------------------------------------------------------------------------------------------------------------
ID                                    CREATE_TIME                DURATION SOURCE                                   STATUS
$BUILD_ID                             2016-09-28T13:46:29+00:00  9S    gs://[PROJECT_ID]_cloudbuild/source/1508159187.8-b0d8841d51674a30aebd1e55bb99486f.gz  gcr.io/[PROJECT_ID]/quickstart-image (+1 more)       SUCCESS

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

Criar usando um arquivo de configuração de 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'
      args: [ 'build', '-t', 'gcr.io/$PROJECT_ID/quickstart-image', '.' ]
    images:
    - 'gcr.io/$PROJECT_ID/quickstart-image'
    
  2. Inicie a build executando o comando a seguir:

    gcloud builds submit --config cloudbuild.yaml
    

Quando a build for concluída, você verá uma resposta semelhante a esta:

DONE
-------------------------------------------------------------------------------------------------------------------------
ID                                    CREATE_TIME                DURATION SOURCE                                   STATUS
$BUILD_ID                             2016-09-28T13:46:29+00:00  8S    gs://[PROJECT_ID]_cloudbuild/source/1508158566.55-725755714baa4b7e9e99984c422ec4e2.gz  gcr.io/[PROJECT-ID]/quickstart-image (+1 more)       SUCCESS

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

Ver os detalhes da build

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

    Abra a página do Cloud Build

  2. Selecione o projeto e clique em Abrir.

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

    Captura de tela da página

  3. Clique em um build específico.

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

  4. Para ver os artefatos de criação, em Resumo da build, clique em Artefatos da build.

    Você verá um resultado semelhante a este:

    Captura de tela dos artefatos da build

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

Limpar

Para evitar cobranças na sua conta do Google Cloud pelos recursos usados neste guia de início rápido, siga estas etapas:

  1. Abra a página do Container Registry no Console do Google Cloud.

    Abrir a página do Container Registry

  2. Selecione o projeto e clique em Abrir.

  3. Clique em quickstart-image.

  4. Selecione todas as imagens e clique em Excluir.

Você já excluiu as imagens criadas como parte deste guia de início rápido.

Pronto, você concluiu as etapas deste guia de início rápido.

A seguir