As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# O gatilho AWS CodeBuild é criado automaticamente
Você pode criar um trigger em um projeto para programar um build uma vez a cada hora, dia ou semana. Também é possível editar um gatilho para usar uma regra personalizada com uma expressão cron do Amazon CloudWatch. Por exemplo, usando uma expressão cron, você pode programar uma compilação em um horário específico todos os dias úteis. Para obter informações sobre como criar e editar gatilhos, consulte [Criar triggers do AWS CodeBuild](#trigger-create) e [Editar triggers do AWS CodeBuild](triggers-edit.md).
**Topics**
+ [Criar triggers do AWS CodeBuild](#trigger-create)
+ [Editar triggers do AWS CodeBuild](triggers-edit.md)
## Criar triggers do AWS CodeBuild
Você pode criar um trigger em um projeto para programar um build uma vez a cada hora, dia ou semana. Também é possível criar um gatilho usando uma regra personalizada com uma expressão cron do Amazon CloudWatch. Por exemplo, usando uma expressão cron, você pode programar uma compilação em um horário específico todos os dias úteis.
**nota**
Não é possível iniciar uma compilação em lote a partir de um gatilho de compilação, de um evento do Amazon EventBridge ou de uma tarefa do AWS Step Functions.
**Topics**
+ [Criar gatilhos do AWS CodeBuild (console)](#trigger-create-console)
+ [Criar gatilhos do AWS CodeBuild programaticamente](#trigger-create-code)
### Criar gatilhos do AWS CodeBuild (console)
Use o procedimento a seguir para criar gatilhos usando o Console de gerenciamento da AWS.
**Para criar um trigger**
1. Abra o console do AWS CodeBuild em [https://console.aws.amazon.com/codesuite/codebuild/home](https://console.aws.amazon.com/codesuite/codebuild/home).
1. No painel de navegação, selecione **Projetos de compilação**.
1. Escolha o link para o projeto de build ao qual você deseja adicionar o trigger e, em seguida, escolha a guia **Construir triggers**.
**nota**
Por padrão, somente os cem projetos de compilação mais recentes são exibidos. Para ver mais projetos de compilação, selecione o ícone de engrenagem e depois escolha outro valor para **Projetos por página** ou use as setas para voltar e avançar.
1. Escolha **Criar acionador**.
1. Em **Trigger name (Nome do gatilho)**, insira um nome.
1. Na lista suspensa **Frequência**, escolha a frequência do gatilho. Se você deseja criar uma frequência usando uma expressão cron, escolha **Personalizado**.
1. Especifique os parâmetros para a frequência do gatilho. Você pode digitar os primeiros caracteres de suas seleções na caixa de texto para filtrar os itens de menu suspenso.
**nota**
As horas e os minutos de início são baseados em zero. O minuto de início é um número entre 0 e 59. A hora de início é um número entre 0 e 23. Por exemplo, um gatilho diário que começa todos os dias às 12h15 tem uma hora de início de 12 e um minuto de início de 15. Um gatilho diário que começa todos os dias às 0h tem uma hora de início de 0 e um minuto de início de 0. Um gatilho diário que começa todos os dias às 23h59 tem uma hora de início de 23 e um minuto de início de 59.
****
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/codebuild/latest/userguide/build-triggers.html)
1. Selecione **Habilitar este trigger**.
1. (Opcional) Expanda **Advanced section (Seção avançada)**. Em **Source version (Versão da origem)**, digite a versão da sua origem.
+ Para o Amazon S3, digite o ID da versão que corresponde à versão do artefato de entrada que você deseja compilar. Se o campo **Source version (Versão de origem)** for deixado em branco, a versão mais recente será usada.
+ Para o AWS CodeCommit, digite um ID de confirmação. Se o campo **Source version (Versão de origem)** for deixado em branco, o ID de confirmação HEAD da ramificação padrão será usado.
+ Para GitHub ou GitHub Enterprise, digite um ID de confirmação, um ID de solicitação pull, um nome de ramificação ou um nome de tag que corresponda à versão do código-fonte que você deseja compilar. Se você especificar um ID de solicitação, ele deve usar o formato `pr/pull-request-ID` (por exemplo, `pr/25`). Se você especificar um nome de ramificação, o ID de confirmação HEAD da ramificação será usado. Se **Source version** estiver em branco, o ID de confirmação HEAD da ramificação padrão será usado.
+ Para o Bitbucket, digite um ID de confirmação, um nome da ramificação ou um nome de tag que corresponda à versão do código-fonte que você deseja compilar. Se você especificar um nome de ramificação, o ID de confirmação HEAD da ramificação será usado. Se **Source version** estiver em branco, o ID de confirmação HEAD da ramificação padrão será usado.
1. (Opcional) Especifique um tempo limite entre 5 minutos e 2.160 minutos (36 horas). Esse valor especifica por quanto tempo o AWS CodeBuild tenta uma compilação antes de parar. Se **Hours (Horas)** e **Minutes (Minutos)** forem deixados em branco, será usado o valor de tempo limite padrão especificado no projeto.
1. Escolha **Criar acionador**.
### Criar gatilhos do AWS CodeBuild programaticamente
O CodeBuild usa regras do Amazon EventBridge para gatilhos de compilação. É possível usar a API do EventBridge para criar programaticamente gatilhos de compilação para os projetos do CodeBuild. Consulte [Referência da API do Amazon EventBridge](https://docs.aws.amazon.com/eventbridge/latest/APIReference/) para obter mais informações.
# Editar triggers do AWS CodeBuild
Você pode editar um trigger em um projeto para programar um build uma vez a cada hora, dia ou semana. Também é possível editar um gatilho para usar uma regra personalizada com uma expressão cron do Amazon CloudWatch. Por exemplo, usando uma expressão cron, você pode programar uma compilação em um horário específico todos os dias úteis. Para obter mais informações sobre como criar um trigger, consulte [Criar triggers do AWS CodeBuild](build-triggers.md#trigger-create).
**Topics**
+ [Editar gatilhos do AWS CodeBuild (console)](#triggers-edit-console)
+ [Editar gatilhos do AWS CodeBuild programaticamente](#trigger-edit-code)
## Editar gatilhos do AWS CodeBuild (console)
Use o procedimento a seguir para editar gatilhos usando o Console de gerenciamento da AWS.
**Como editar um trigger**
1. Abra o console do AWS CodeBuild em [https://console.aws.amazon.com/codesuite/codebuild/home](https://console.aws.amazon.com/codesuite/codebuild/home).
1. No painel de navegação, selecione **Projetos de compilação**.
1. Selecione o link para o projeto de compilação que você deseja alterar e selecione **Build triggers (Gatilhos da compilação)**.
**nota**
Por padrão, somente os cem projetos de compilação mais recentes são exibidos. Para ver mais projetos de compilação, selecione o ícone de engrenagem e depois escolha outro valor para **Projetos por página** ou use as setas para voltar e avançar.
1. Escolha o botão de seleção próximo ao trigger a ser alterado e selecione **Edit (Editar)**.
1. Na lista suspensa **Frequência**, escolha a frequência do gatilho. Se você deseja criar uma frequência usando uma expressão cron, escolha **Personalizado**.
1. Especifique os parâmetros para a frequência do gatilho. Você pode digitar os primeiros caracteres de suas seleções na caixa de texto para filtrar os itens de menu suspenso.
**nota**
As horas e os minutos de início são baseados em zero. O minuto de início é um número entre 0 e 59. A hora de início é um número entre 0 e 23. Por exemplo, um gatilho diário que começa todos os dias às 12h15 tem uma hora de início de 12 e um minuto de início de 15. Um gatilho diário que começa todos os dias às 0h tem uma hora de início de 0 e um minuto de início de 0. Um gatilho diário que começa todos os dias às 23h59 tem uma hora de início de 23 e um minuto de início de 59.
****
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/codebuild/latest/userguide/triggers-edit.html)
1. Selecione **Habilitar este trigger**.
**nota**
É possível usar o console do Amazon CloudWatch em [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/) para editar a versão de origem, o tempo limite e outras opções que não estão disponíveis no AWS CodeBuild.
## Editar gatilhos do AWS CodeBuild programaticamente
O CodeBuild usa regras do Amazon EventBridge para gatilhos de compilação. É possível usar a API do EventBridge para editar programaticamente gatilhos de compilação para os projetos do CodeBuild. Consulte [Referência da API do Amazon EventBridge](https://docs.aws.amazon.com/eventbridge/latest/APIReference/) para obter mais informações.