

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
<a name="build-triggers"></a>

Você pode criar um trigger em um projeto para programar um build uma vez a cada hora, dia ou semana. Você também pode editar um gatilho para usar uma regra personalizada com uma expressão CloudWatch cron da Amazon. 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 [Crie AWS CodeBuild gatilhos](#trigger-create) e [Editar AWS CodeBuild gatilhos](triggers-edit.md).

**Topics**
+ [Crie AWS CodeBuild gatilhos](#trigger-create)
+ [Editar AWS CodeBuild gatilhos](triggers-edit.md)

## Crie AWS CodeBuild gatilhos
<a name="trigger-create"></a>

Você pode criar um trigger em um projeto para programar um build uma vez a cada hora, dia ou semana. Você também pode criar um gatilho usando uma regra personalizada com uma expressão CloudWatch cron da Amazon. 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 EventBridge evento da Amazon ou de uma AWS Step Functions tarefa.

**Topics**
+ [Criar AWS CodeBuild gatilhos (console)](#trigger-create-console)
+ [Crie AWS CodeBuild gatilhos programaticamente](#trigger-create-code)

### Criar AWS CodeBuild gatilhos (console)
<a name="trigger-create-console"></a>

Use o procedimento a seguir para criar gatilhos usando o Console de gerenciamento da AWS.

**Para criar um trigger** 

1. Abra o AWS CodeBuild console 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 P.M 12:15. tem uma hora inicial de 12 e um minuto inicial 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 P.M 11:59. tem uma hora inicial de 23 e um minuto inicial 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 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 uma ID de confirmação, uma ID de pull request, um nome de ramificação ou um nome de tag que corresponda à versão do código-fonte que você deseja criar. 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 uma compilação AWS CodeBuild tenta antes que ela pare. 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**.

### Crie AWS CodeBuild gatilhos programaticamente
<a name="trigger-create-code"></a>

CodeBuild usa EventBridge as regras da Amazon para criar gatilhos. Você pode usar a EventBridge API para criar programaticamente acionadores de compilação para seus projetos. CodeBuild Consulte a [Amazon EventBridge API Reference](https://docs.aws.amazon.com/eventbridge/latest/APIReference/) para obter mais informações.