Guia de início rápido do Docker

Nesta página, explicamos como usar o Cloud Build para construir uma imagem do Docker e enviar a imagem para o Container Registry. Você primeiro criará a imagem usando um Dockerfile e, em seguida, criará a mesma imagem usando o arquivo de configuração da versã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 GCP, acesse a página Gerenciar recursos e selecione ou crie um projeto.

    Acessar a página Gerenciar recursos

  3. Verifique se o faturamento foi ativado para o projeto.

    Saiba como ativar o faturamento

  4. Ativar Cloud Build API.

    Ativar a API

  5. Instale e inicialize o SDK do Cloud.

Fazer login no Google Cloud

  1. Autorize a ferramenta de linha de comando gcloud a acessar seu projeto:

    gcloud auth login
    
  2. Configure seu projeto para a ferramenta gcloud, em que [PROJECT_ID] é o código do projeto do GCP que você criou ou selecionou na seção anterior:

    gcloud config set project [PROJECT_ID]
    

Como preparar arquivos de origem

Você precisará de um código-fonte de amostra para criar. Nesta seção, você criará um exemplo simples do Hello World e um Dockerfile.

  1. Crie um arquivo denominado quickstart.sh com o seguinte conteúdo:

    #!/bin/sh
    echo "Hello, world! The time is $(date)."
    
  2. Crie um arquivo denominado Dockerfile com o seguinte conteúdo:

    FROM alpine
    COPY quickstart.sh /
    CMD ["/quickstart.sh"]
    
  3. Abra uma janela do terminal se já não estiver aberta.

  4. Execute o seguinte comando para tornar o arquivo quickstart.sh executável:

    chmod +x quickstart.sh
    

Criar usando o Dockerfile

O Cloud Build permite criar uma imagem do Docker usando um Dockerfile. Você não precisa de um arquivo de configuração da versão à parte.

Execute o seguinte comando a partir do diretório que contém quickstart.sh e Dockerfile, em que [PROJECT_ID] é o código do projeto do GCP:

    gcloud builds submit --tag gcr.io/[PROJECT_ID]/quickstart-image .

Após a conclusão da versão, você verá um resultado semelhante a este:

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 da versão

Nesta seção você usará um arquivo de configuração da versão para criar a mesma imagem do Docker como acima. A configuração da versão instrui o Cloud Build a executar tarefas de acordo com suas especificações.

  1. No mesmo diretório que contém quickstart.sh e o Dockerfile, crie um arquivo chamado cloudbuild.yaml com o conteúdo a seguir. Esse arquivo é o arquivo de configuração da versão. No momento da criação, o Cloud Build substitui automaticamente $PROJECT_ID pelo código 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 versão executando o comando a seguir:

    gcloud builds submit --config cloudbuild.yaml .
    

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

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 versão

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

    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 de histórico de versão

  3. Clique em uma versão específica.

    Você verá a página Detalhes da versão:

  4. Clique na imagem.

    Captura de tela do link da imagem

    Você verá os detalhes da imagem na página "Container Registry".

Opcional: executar a imagem do Docker

Para verificar se a imagem que você criou funciona como esperado, é possível executá-la usando o Docker.

  1. Instale o Docker.

  2. Configure o Docker para usar as credenciais do Container Registry quando interagir com o Container Registry (você só precisa fazer isso uma vez):

    gcloud auth configure-docker
    

    Você verá uma mensagem semelhante à seguinte:

    The following settings will be added to your Docker config file
    located at [/.docker/config.json]:
    
    {
      "credHelpers": {
        "gcr.io": "gcloud",
        "us.gcr.io": "gcloud",
        "eu.gcr.io": "gcloud",
        "asia.gcr.io": "gcloud",
        "staging-k8s.gcr.io": "gcloud",
        "marketplace.gcr.io": "gcloud"
      }
    }
    
    Do you want to continue (Y/n)?
    
  3. Digite y para acessar.

  4. Execute a imagem do Docker que você criou anteriormente, em que [PROJECT_ID] é o código do projeto do GCP:

    docker run gcr.io/[PROJECT_ID]/quickstart-image
    

    Você verá um resultado semelhante a este:

    Hello, world! The time is Fri Feb  2 16:09:54 UTC 2018.
    

Fazer limpeza

Para evitar cobranças na sua conta do GCP pelo uso de recursos neste guia de início rápido:

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

    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

Enviar comentários sobre…