Esta página foi traduzida pela API Cloud Translation.
Switch to English

Guia de início rápido: automatizado

Nesta página, explicamos como usar o Cloud Build para automatizar versões.

O Cloud Build usa acionadores de versão para ativar automações de CI/CD. É possível configurar acionadores para detectar eventos de entrada, como quando uma nova confirmação é enviada para um repositório ou quando uma solicitação de envio é iniciada e, em seguida, invocar automaticamente uma versão quando novos eventos chegam.

Você criará um acionador e o configurará para invocar uma versão sempre que enviar uma alteração para um repositório do GitHub.

Antes de começar

  1. Faça login na sua conta do Google Cloud. Se você começou a usar o Google Cloud agora, crie uma conta para avaliar o desempenho de nossos produtos em situações reais. Clientes novos também recebem US$ 300 em créditos para executar, testar e implantar cargas de trabalho.
  2. No Console do Google Cloud, na página do seletor de projetos, selecione ou crie um projeto do Google Cloud.

    Acessar o seletor de projetos

  3. Verifique se o faturamento está ativado para seu projeto na nuvem. Saiba como confirmar se o faturamento está ativado para o projeto.

  4. Ative a API Cloud Build.

    Ative a API

  5. Instale e inicialize o SDK do Cloud..
  6. Crie uma conta no GitHub, se ainda não tiver uma.
  7. Se você tiver a autenticação de dois fatores configurada no GitHub, crie um token de acesso pessoal para usar no lugar de uma senha do GitHub com a linha de comando.

Preparar arquivos de origem

Você precisará de um código-fonte de amostra para criar. Nesta seção, você clonará um repositório de origem existente contendo um exemplo do Hello World em Go para sua própria conta de usuário do GitHub.

  1. Acesse o repositório cloud-build-samples do Cloud Build.

  2. Bifurcar o repositório cloud-build-samples para sua conta do GitHub.

    1. Clique no ícone Fork no canto superior direito da página.
    2. Clique na conta de usuário do GitHub à qual você quer bifurcar o repositório.

      Você será redirecionado automaticamente para a página com sua versão ramificada do repositório cloud-build-samples.

  3. Clone o repositório na sua máquina local executando o seguinte comando no terminal, em que GITHUB_USERNAME é o nome de usuário da sua conta do GitHub:

     git clone https://github.com/GITHUB_USERNAME/cloud-build-samples.git
    
  4. Navegue até o diretório quickstart-automate:

     cd cloud-build-samples/quickstart-automate
    

    Você verá os seguintes arquivos contendo código-fonte para o exemplo do Hello World:

    • main.go: um aplicativo Go de amostra que imprime Hello, world!

       package main
      
       import (
           "fmt"
       )
      
       func main() {
           fmt.Println("Hello, world!")
       }
      
    • cloudbuild.yaml: o arquivo de build de criação usado pelo Cloud Build para executar ações especificadas como etapas de criação. A etapa de criação usada neste arquivo instrui o Cloud Build a usar a imagem golang do Docker Hub para criar e executar o arquivo main.go.

       steps:
       - name: golang
         args: ['go', 'run', 'quickstart-automate/main.go']
      

Conectar seu repositório

Para criar código-fonte no GitHub usando acionadores, primeiro é preciso conectar o Cloud Build ao seu repositório do GitHub. Nesta seção, você conectará seu repositório cloud-build-samples ao Cloud Build.

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

    Abrir a página "Gatilhos"

  2. Selecione o projeto e clique em Abrir.

  3. Clique em Conectar repositório.

  4. Em Selecionar origem, selecione GitHub (aplicativo do GitHub para Cloud Build).

  5. Clique em Continuar.

  6. Autentique sua conta do GitHub.

  7. Na seção Selecionar repostory, insira o nome de usuário da sua conta do GitHub clicando em Adicionar.

    Você verá um pop-up para instalar o aplicativo Cloud Build GitHub.

  8. Clique no seu nome de usuário do GitHub.

  9. Clique em Somente determinados repositórios para instalar o aplicativo GitHub do Cloud Build em determinados repositórios.

  10. No menu suspenso, selecione GITHUB_USERNAME/cloud-build-samples, em que GITHUB_USERNAME é o nome de usuário da sua conta do GitHub.

  11. Clique em Instalar.

    Talvez seja necessário inserir a senha associada à sua conta do GitHub antes de continuar.

  12. Depois da instalação do app GitHub para Cloud Build, agora é possível ver o nome de usuário no menu suspenso do campo Conta do GitHub. Selecione seu nome de usuário.

  13. Em Repositório, selecione GITHUB_USERNAME/cloud-build-samples como seu repositório.

  14. Clique na marca de seleção para concordar com os Termos e Condições para conexão de acionamento.

  15. Clique em Connect.

  16. Clique em Concluído.

    Você criará um gatilho na próxima seção.

Criar um acionador

Nesta seção, você criará um acionador.

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

    Abrir a página "Gatilhos"

  2. Selecione o projeto no menu suspenso do seletor na parte superior da página.

  3. Clique em Abrir.

  4. Clique em Criar gatilho.

    Na página Criar gatilho, especifique as seguintes configurações:

    1. Nome: insira hello-world-trigger como o nome do gatilho.

    2. Evento: selecione Enviar para uma ramificação como o evento de repositório para invocar seu gatilho.

    3. Origem: selecione o repositório cloud-build-samples como origem, que contém o código-fonte e o arquivo de configuração da criação.

    4. Configuração da versão: escolha arquivo de configuração do Cloud Build como seu arquivo de configuração da versão.

    5. Local do arquivo de configuração do Cloud Build: especifique o caminho para o arquivo de configuração do Cloud Build como quickstart-automate/cloudbuild.yaml.

  5. Clique em Criar para salvar o gatilho de compilação.

Confirmar uma mudança

Nesta seção, você confirmará uma alteração no repositório cloud-build-samples clonado na sua própria conta do GitHub.

  1. Na janela do terminal, navegue até o diretório quickstart-automate:

      cd code-examaples/quickstart-automate
    
  2. Abra o arquivo main.go no seu terminal.

  3. Atualize a linha que contém "Hello, world!" para "Hello, universo!"

      package main
    
      import (
          "fmt"
      )
    
      func main() {
          fmt.Println("Hello, universe!")
      }
    
  4. Volte ao diretório raiz do seu repositório:

    cd ..
    
  5. Confirme as alterações no GitHub executando o seguinte comando:

    git add quickstart-automate/main.go
    git commit -m "update text"
    git push
    

    Talvez seja necessário inserir suas credenciais ao enviar o código para seu repositório. Se solicitado, digite seu nome de usuário e senha ou um token de autenticação.

Agora você enviou uma alteração para seu repositório. O push resultará em uma compilação automática pelo gatilho.

Ver detalhes do build

Nesta seção, você verá os detalhes de criação associados à sua chamada invocada depois de confirmar uma alteração.

  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 "Histórico da build" para automatizar

  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

    Você pode fazer o download do seu registro de compilação nessa página.

Limpeza

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 Gatilhos no Console do Google Cloud.

    Abrir a página “Gatilhos de compilação”

  2. Selecione o projeto no menu suspenso do seletor de projetos na parte superior da página.

  3. Clique em Abrir.

  4. Localize a linha com o gatilho que você quer excluir.

  5. Clique no menu (três pontos verticais) localizado na extremidade direita da linha.

  6. Selecione Excluir.

Você excluiu o gatilho associado ao seu repositório clonado.

A seguir