O gatilho AWS CodeBuild é criado automaticamente
Você pode criar um gatilho em um projeto para programar uma compilação 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 e Editar triggers do AWS CodeBuild.
Criar triggers do AWS CodeBuild
Você pode criar um gatilho em um projeto para programar uma compilação 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.
Criar gatilhos do AWS CodeBuild (console)
Use o procedimento a seguir para criar gatilhos usando o AWS Management Console.
Para criar um trigger
Abra o console do AWS CodeBuild em https://console.aws.amazon.com/codesuite/codebuild/home
. -
No painel de navegação, selecione Projetos de compilação.
-
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 selecione outro valor para Projetos por página ou use as setas para voltar e avançar.
-
Escolha Criar gatilho.
-
Em Trigger name (Nome do gatilho), insira um nome.
-
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.
-
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.
Frequência Parâmetros necessários Detalhes Por hora Minuto inicial
Use o menu suspenso Minuto inicial.
Por dia Minuto inicial
Hora inicial
Use o menu suspenso Minuto inicial.
Use o menu suspenso Hora inicial.
Por semana Minuto inicial
Hora inicial
Dia inicial
Use o menu suspenso Minuto inicial.
Use o menu suspenso Hora inicial.
Use o menu suspenso Dia inicial.
Personalizado Expressão cron
Digite uma expressão cron em Expressão cron. Uma expressão cron tem seis campos obrigatórios, separados por espaços em branco. Os campos especificam um valor de início para minuto, hora, dia do mês, mês, dia da semana e ano. Você pode usar curingas para especificar um intervalo, valores adicionais e mais. Por exemplo, a expressão cron
0 9 ? * MON-FRI *
programa uma compilação todos os dias da semana às 9h. Para obter mais informações, consulte Cron Expressions no Guia do usuário do Amazon CloudWatch Events. -
Selecione Habilitar este trigger.
-
(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/
(por exemplo,pull-request-ID
pr/25
). Se você especificar um nome de ramificação, o ID de confirmação HEAD da ramificação será usado. Se Versão de origem 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 Versão de origem estiver em branco, o ID de confirmação HEAD da ramificação padrão será usado.
-
-
(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.
-
Escolha Criar gatilho.
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 para obter mais informações.