O Cloud Build usa gatilhos de build para permitir a automação de CI/CD. É possível configurar gatilhos para detectar eventos recebidos, como quando um novo commit é enviado para um repositório ou quando uma solicitação de envio é iniciada, e, em seguida, executar automaticamente um build quando novos eventos chegarem. Também é possível configurar gatilhos para criar código em qualquer alteração no repositório de origem ou apenas em alterações que correspondam a determinados critérios.
Nesta página, você encontra uma visão geral de cada tipo de gatilho e dos recursos associados a eles.
Gatilhos de evento do repositório
O Cloud Build permite executar builds automaticamente em eventos de repositório, como pushes ou solicitações de pull. É possível conectar repositórios externos, como os do GitHub ou do Bitbucket, ao Cloud Build ou usar o código no Cloud Source Repositories para seus builds. Embora seja possível conectar qualquer repositório de origem ao Cloud Build, ele fornece gatilhos de eventos de repositório específicos que podem ser usados para integrar sistemas de gerenciamento de código-fonte (SCMs, na sigla em inglês) específicos. Nesta seção, discutimos os gatilhos de eventos de repositório disponíveis.
Acionadores do GitHub
É possível criar gatilhos do GitHub para executar builds automaticamente em resposta a eventos do repositório, como pushes ou solicitações de pull. É possível ver o status do build do gatilho no GitHub e no console do Google Cloud . Também é possível usar o app GitHub do Cloud Build para conectar e criar código no GitHub. Para saber mais, consulte Como criar repositórios do GitHub.
Gatilhos do GitHub Enterprise
É possível criar gatilhos para repositórios hospedados em uma instância do GitHub Enterprise, incluindo instâncias hospedadas em um ambiente local e não acessíveis por uma conexão de Internet pública. Os gatilhos do GitHub Enterprise podem ser usados para executar builds em resposta a pushes ou solicitações de pull de uma instância do GitHub Enterprise. Para saber mais, consulte Como criar repositórios do GitHub Enterprise.
Gatilhos do GitLab Enterprise Edition
É possível criar gatilhos para repositórios hospedados em uma instância do GitLab Enterprise Edition, incluindo instâncias hospedadas em uma rede privada. Os gatilhos do GitLab Enterprise Edition podem ser usados para executar builds em resposta a pushes de commit ou solicitações de pull associadas ao repositório do GitLab Enterprise Edition. Para saber mais, consulte Como criar repositórios do GitLab Enterprise Edition.
Gatilhos do Bitbucket Server
É possível criar gatilhos para repositórios hospedados em uma instância do Bitbucket Server, incluindo instâncias hospedadas em um ambiente local. É possível conectar o repositório do Bitbucket Server ao Cloud Build várias vezes com várias conexões de host. Para saber como criar gatilhos para executar builds em resposta a eventos, consulte Como criar repositórios do Bitbucket Server.
Gatilhos do Bitbucket Data Center
É possível criar gatilhos para repositórios hospedados em uma instância do Bitbucket Data Center, incluindo instâncias hospedadas em um ambiente local. Os gatilhos do Bitbucket Data Center podem ser usados para executar builds em resposta a eventos como pushes de commit ou solicitações de pull. Para saber mais, consulte Criar repositórios do Bitbucket Data Center.
Gatilhos do Bitbucket Cloud
É possível criar gatilhos para repositórios hospedados no Bitbucket Cloud. Os gatilhos do Bitbucket Cloud podem ser usados para executar builds em resposta a eventos como pushes de commit ou solicitações de pull. Para saber mais, consulte Como criar repositórios do Bitbucket Cloud.
Gatilhos do Secure Source Manager
É possível criar gatilhos para repositórios hospedados no Secure Source Manager. Os gatilhos do Secure Source Manager podem ser usados para executar builds em resposta a eventos como envios de commit ou solicitações de pull. Para saber mais, consulte Criar um arquivo de gatilhos no Secure Source Manager.
Gatilhos manuais
É possível criar gatilhos manuais para executar builds manualmente e modificar valores de variáveis de substituição definidas no momento da invocação antes de executar um build. Também é possível configurar gatilhos manuais para serem executados de acordo com uma programação. Para saber mais, consulte Criar código manualmente em repositórios de origem.
Gatilhos do Pub/Sub
É possível criar acionadores do Pub/Sub para executar builds em resposta a qualquer mensagem publicada no Pub/Sub. Por exemplo, é possível usar
gatilhos do Pub/Sub para criar em resposta a envios de imagens para o
Artifact Registry. Nesse caso, é possível configurar o gatilho para usar filtros e
executar um build somente se a imagem enviada corresponder a uma tag específica, como prod.
Além disso, os gatilhos do Pub/Sub podem ser configurados para se inscrever em
qualquer tópico do Pub/Sub. Para saber mais, consulte
Automatizar builds em resposta a eventos do Pub/Sub.
Gatilhos de webhook
É possível criar gatilhos de webhook para executar builds em resposta a webhooks. Os eventos de webhook enviados para um URL personalizado permitem conectar diretamente sistemas externos e sistemas de gerenciamento de código-fonte (SCMs) externos, como Bitbucket.com, Bitbucket Server ou GitLab, ao Cloud Build. Ao criar gatilhos de webhook, também é possível definir a configuração do build inline no gatilho para controlar quais repositórios ele clona durante o tempo de build, em vez de especificar explicitamente uma origem. Para saber mais, consulte Automatizar builds em resposta a eventos de webhook. Além disso, para aprender a usar gatilhos de webhook para criar repositórios de SCMs específicos, consulte Como criar repositórios do Bitbucket Server, Como criar repositórios do Bitbucket Cloud e Como criar repositórios do GitLab.
Gatilhos para repositórios vinculados ao Developer Connect
O Developer Connect permite conectar produtos externos ou ferramentas para desenvolvedores que não sejam do Google ao Google Cloud usando etapas e apps padronizados. É possível configurar gatilhos que criam com base em repositórios conectados pelo Developer Connect para os seguintes SCMs:
- Bitbucket Cloud
- Data center do Bitbucket
- Bitbucket Server
- GitHub
- GitHub Enterprise
- GitLab
- Gitlab Enterprise Edition
Recursos de gatilho
Os gatilhos do Cloud Build oferecem recursos que dão controle detalhado sobre como um build é executado. Nesta seção, discutimos vários recursos associados a gatilhos.
Gatilhos manuais programados
É possível programar gatilhos manuais para executar builds automaticamente em uma programação predefinida. Por exemplo, é possível configurar um gatilho programado para executar um build todos os sábados às 6h. Para programar builds, crie um gatilho manual e invoque-o usando o Cloud Scheduler. Para saber mais, consulte Programar builds.
Como filtrar eventos
O Cloud Build usa a
Common Expression Language (CEL) com a
variável build nos campos listados no recurso
Build para acessar
campos associados ao evento de build, como o ID do gatilho, a lista de imagens ou
os valores de substituição. Use a string filter para filtrar eventos de build no
arquivo de configuração de build usando qualquer campo listado no
recurso Build. Para saber
mais, consulte Usar CEL para filtrar eventos de build.
Variáveis de substituição
É possível especificar variáveis de substituição no arquivo de configuração do build para substituir valores específicos no momento do build. Por exemplo, convém usar variáveis de substituição se um valor não for conhecido até o momento da compilação ou se você quiser reutilizar uma solicitação já existente com variáveis diferentes. O Cloud Build fornece substituições padrão que podem ser usadas para builds invocados por gatilhos, como mapeamento de variáveis para o nome do gatilho ou repositório. Você também pode definir suas próprias variáveis de substituição. Para saber mais, consulte Como substituir valores de variáveis.
Expansões de parâmetros Bash
É possível aplicar expansões de parâmetros bash a valores de variáveis de substituição. As expansões do parâmetro Bash permitem manipular strings associadas a variáveis existentes. Por exemplo, use as expansões de parâmetros bash para colocar letras maiúsculas ou substituir uma substring. Para saber mais, consulte Expansões de parâmetros balanceados.
Vinculações de payload
É possível armazenar parte do payload de eventos do gatilho como uma variável de substituição usando vinculações de payload. As variáveis associadas a um payload são chamadas de vinculações e estão disponíveis para builds invocados por eventos de push e pull. É possível usar vinculações para acessar outros dados relacionados ao build, como o autor de uma solicitação de envio. Para saber mais, consulte Vinculações de payload.
Aprovações
É possível configurar gatilhos para não executar um build imediatamente, mas marcá-lo como pendente até que seja aprovado. Se um usuário com permissões aprovar um build pendente, ele será iniciado. Se a aprovação for negada, o build não será iniciado. Para saber como configurar gatilhos que exigem aprovação, consulte Controlar builds com aprovação.
Notificações de status da versão
É possível configurar os notificadores do Cloud Build para detectar atualizações de eventos de build do Pub/Sub no tópico padrão cloud-builds ou em um tópico definido pelo usuário.
Os notificadores também podem filtrar as mensagens recebidas pelo tópico e enviar mensagens para os serviços conectados. O Cloud Build fornece e mantém imagens de notificador implantáveis no repositório cloud-build-notifiers.
É possível configurar notificações usando um notificador do Cloud Build,
como BigQuery,
HTTP,
Slack ou
SMTP ou
criar seu próprio notificador.
Contas de serviço para gatilhos de build
Quando um gatilho invoca um build, o Cloud Build executa as etapas de build usando uma conta de serviço. Dependendo da configuração do gatilho e das configurações da política da organização do projeto, os builds invocados por gatilhos podem usar uma das seguintes contas de serviço:
- Conta de serviço especificada pelo usuário
(
ACCOUNT_NAME@PROJECT_ID.): recomendada. Você cria e gerencia essa conta de serviço e concede apenas as permissões do Identity and Access Management (IAM) necessárias para o build do gatilho. - Conta de serviço padrão do Compute Engine
(
PROJECT_NUMBER-compute@): a conta de serviço de build padrão para projetos que executaram o primeiro build após a alteração da conta de serviço padrão, a menos que seja restrita por políticas da organização. Nesses projetos, é preciso selecionar explicitamente uma conta de serviço (especificada pelo usuário ou a conta de serviço padrão do Compute Engine) ao criar ou atualizar um gatilho. - Conta de serviço legada do Cloud Build
(
PROJECT_NUMBER@cloudbuild.): usada como a conta de serviço de build padrão em projetos que executaram builds antes da mudança da conta de serviço padrão ou em organizações que recusaram a mudança. Nesses projetos, se o camposerviceAccountde um gatilho não for especificado, o gatilho vai usar por padrão a conta de serviço legada do Cloud Build.
Antes de conceder papéis do IAM para as etapas de build de um gatilho, verifique qual conta de serviço está configurada no gatilho. Para instruções, consulte Identificar qual conta de serviço configurar.
A seguir
- Saiba como criar e gerenciar gatilhos de compilação.
- Saiba como configurar contas de serviço especificadas pelo usuário.