Automatizar os builds usando o Cloud Build

Bifurcar e clonar um repositório do GitHub de amostra

1. Se você ainda não tiver uma, crie uma conta no GitHub.

2. 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.

3. Bifurque o repositório cloud-build-samples para sua própria conta do GitHub:

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

   2. Clique no ícone Bifurcar no canto superior direito da página.

   3. Clique na conta de usuário do GitHub para bifurcar o repositório nela.

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

4. Abra um terminal no ambiente local.

5. Clone o repositório bifurcado executando o seguinte comando, 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

Conectar o Cloud Build ao seu repositório

1. No menu de navegação do console do Google Cloud, clique em Cloud Build > Gatilhos.

   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 (app GitHub do Cloud Build).

5. Clique emContinuar.

6. Autentique sua conta do GitHub.

7. Na seção Selecionar repositório, selecione o nome de usuário da sua conta do GitHub. Se o nome de usuário não aparecer na lista, faça o seguinte:

   1. Na lista de contas do GitHub, clique em +Adicionar.

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

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

   3. Clique em Apenas determinados repositórios para instalar o app GitHub do Cloud Build em determinados repositórios.

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

   5. Clique em Instalar.

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

   6. Após a instalação do app Cloud Build GitHub, agora você poderá ver seu nome de usuário no menu suspenso do campo conta GitHub. Selecione seu nome de usuário.

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

9. Clique na marca de seleção para concordar com os Termos e Condições de conexão do gatilho.

10. Clique emConectar.

11. Clique emConcluído.

Criar um gatilho

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 de projetos na parte superior da página.

3. Clique em Abrir.

4. Na página Gatilhos, clique em Criar gatilho.

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

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

   • Evento: selecione Enviar para uma ramificação como o evento do repositório para invocar o gatilho.

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

   • Configuração do build: escolha Arquivo de configuração do Cloud Build como seu arquivo de configuração do build.

   • 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.

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

Confirmar uma alteração

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

1. No seu terminal, navegue até o diretório quickstart-automate:

   cd cloud-build-samples/quickstart-automate

2. Abra o arquivo main.go e atualize a linha que contém "Hello, world!" para "Hello, universe!"

     package main
   
     import (
         "fmt"
     )
   
     func main() {
         fmt.Println("Hello, universe!")
     }
     

3. Revise cloudbuild.yaml, que é o arquivo de configuração do build usado pelo Cloud Build. Quando um build é invocado com um gatilho, a etapa nesse arquivo instrui o Cloud Build a usar a imagem golang do Docker Hub para criar e executar o arquivo main.go.

      steps:
      - name: golang
        script: go run quickstart-automate/main.go
      

4. Navegue de volta para o diretório raiz do repositório:

      cd ..

5. Confirme as alterações no GitHub executando os seguintes comandos:

       
       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 o repositório. Se solicitado, digite seu nome de usuário e senha ou um token de autenticação.

Você enviou uma alteração para seu repositório. O envio resultará em um build automático pelo gatilho.

Ver detalhes do build

1. No menu de navegação do Console do Google Cloud, clique em Cloud Build > Histórico.

   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:

   

3. Na coluna Build, clique no nome de um build.

4. Na página Detalhes do build, clique em Artefatos do build.

   Você verá um resultado semelhante a este:

   

5. Para ver o registro do build, clique no ícone de download e veja o arquivo salvo.

Você invocou um build do Cloud Build usando um gatilho e visualizou os detalhes do build.