Adicionar um gatilho push, pull ou scheduler

Use as instruções a seguir para adicionar um gatilho push, pull ou agendamento ao seu fluxo de trabalho.

Visual

Para adicionar um gatilho (editor visual)

1. Abra o CodeCatalyst console em https://codecatalyst.aws/.

2. Selecione o projeto.

3. No painel de navegação, escolha CI/CD e, em seguida, escolha Fluxos de trabalho.

4. Escolha o nome do seu fluxo de trabalho. Você pode filtrar pelo nome do repositório ou ramificação de origem em que o fluxo de trabalho está definido, ou filtrar pelo nome do fluxo de trabalho.

5. Selecione a opção Editar.

6. Escolha Visual.

7. No diagrama do fluxo de trabalho, escolha a caixa Fonte e Acionadores.

8. No painel de configuração, escolha Adicionar gatilho.

9. Na caixa de diálogo Adicionar gatilho, forneça as informações nos campos, da seguinte forma.

   Tipo de gatilho

   Especifique o tipo de gatilho. Você pode usar um dos seguintes valores:

   • Push (editor visual) ou PUSH (editor YAML)

     Um gatilho push inicia a execução de um fluxo de trabalho quando uma alteração é enviada para seu repositório de origem. A execução do fluxo de trabalho usará os arquivos na ramificação para a qual você está enviando (ou seja, a ramificação de destino).

   • Pull request (editor visual) ou PULLREQUEST (editor YAML)

     Um gatilho de pull request inicia a execução de um fluxo de trabalho quando uma pull request é aberta, atualizada ou fechada no seu repositório de origem. A execução do fluxo de trabalho usará os arquivos na ramificação da qual você está extraindo (ou seja, a ramificação de origem).

   • Agenda (editor visual) ou SCHEDULE (editor YAML)

     Um gatilho de agendamento inicia a execução do fluxo de trabalho em um cronograma definido por uma expressão cron especificada por você. Uma execução de fluxo de trabalho separada será iniciada para cada ramificação em seu repositório de origem usando os arquivos da ramificação. (Para limitar as ramificações nas quais o gatilho é ativado, use o campo Ramificações (editor visual) ou a Branches propriedade (editor YAML).)

     Ao configurar um gatilho de agendamento, siga estas diretrizes:

     • Use apenas um gatilho de agendamento por fluxo de trabalho.

     • Se você definiu vários fluxos de trabalho em seu CodeCatalyst espaço, recomendamos que não agende mais do que 10 deles para começarem simultaneamente.

     • Certifique-se de configurar a expressão cron do gatilho com tempo adequado entre as execuções. Para ter mais informações, consulte Expression.

   Para ver exemplos, consulte Exemplos de gatilhos.

   Eventos para pull request

   Esse campo só aparece se você selecionou o tipo de gatilho de pull request.

   Especifique o tipo de eventos de pull request que iniciarão a execução de um fluxo de trabalho. A seguir estão os valores válidos:

   • A solicitação pull é criada (editor visual) ou OPEN (editor YAML)

     A execução do fluxo de trabalho é iniciada quando uma pull request é criada.

   • A solicitação pull está fechada (editor visual) ou CLOSED (editor YAML)

     A execução do fluxo de trabalho é iniciada quando uma pull request é fechada. O comportamento do CLOSED evento é complicado e é melhor compreendido por meio de um exemplo. Consulte Exemplo: um gatilho com um puxão, galhos e um evento “FECHADO” Para mais informações.

   • Uma nova revisão é feita para pull request (editor visual) ou REVISION (editor YAML)

     A execução do fluxo de trabalho é iniciada quando uma revisão de uma pull request é criada. A primeira revisão é criada quando a pull request é criada. Depois disso, uma nova revisão é criada toda vez que alguém envia um novo commit para a ramificação de origem especificada na pull request. Se você incluir o REVISION evento em seu gatilho de pull request, poderá omitir o OPEN evento, pois REVISION é um superconjunto de. OPEN

   Você pode especificar vários eventos no mesmo gatilho de pull request.

   Para ver exemplos, consulte Exemplos de gatilhos.

   Schedule (Programação)

   Esse campo só aparece se você selecionou o tipo de gatilho de agendamento.

   Especifique a expressão cron que descreve quando você deseja que suas execuções de fluxo de trabalho agendadas ocorram.

   As expressões Cron CodeCatalyst usam a seguinte sintaxe de seis campos, em que cada campo é separado por um espaço:

   minutos horas days-of-monthmês days-of-weekano

   Exemplos de expressões cron

   Minutos	Horas	Dias do mês	Mês	Dias da semana	Ano	Significado
   0	0	?	*	SEG-SEX	*	Executa um fluxo de trabalho à meia-noite (UTC+0) de segunda a sexta-feira.
   0	2	*	*	?	*	Executa um fluxo de trabalho às 2:00 da manhã (UTC+0) todos os dias.
   15	22	*	*	?	*	Executa um fluxo de trabalho às 22h15 (UTC+0) todos os dias.
   0/30	22-2	?	*	SÁB-DOM	*	Executa um fluxo de trabalho a cada 30 minutos, de sábado a domingo, entre 22h no dia inicial e 2h no dia seguinte (UTC+0).
   45	13	L	*	?	2023-2027	Executa um fluxo de trabalho às 13h45 (UTC+0) no último dia do mês entre os anos de 2023 e 2027, inclusive.

   Ao especificar expressões cron em CodeCatalyst, siga estas diretrizes:

   • Especifique uma única expressão cron por SCHEDULE gatilho.

   • Coloque a expressão cron entre aspas duplas (") no editor YAML.

   • Especifique a hora em Tempo Universal Coordenado (UTC). Outros fusos horários não são suportados.

   • Configure pelo menos 30 minutos entre as execuções. Não há suporte para uma cadência mais rápida.

   • Especifique o days-of-weekcampo days-of-monthou, mas não ambos. Se você especificar um valor ou um asterisco (*) em um dos campos, deverá usar um ponto de interrogação (?) no outro. O asterisco significa 'tudo' e o ponto de interrogação significa 'qualquer'.

   Para obter mais exemplos de expressões cron e informações sobre curingas como?,, e *L, consulte a referência de expressões Cron no Guia do usuário da Amazon EventBridge . As expressões Cron CodeCatalyst funcionam exatamente da mesma maneira. EventBridge

   Para obter exemplos de acionadores de agendamento, consulte. Exemplos de gatilhos

   Galhos e padrão de ramificação

   (Optional)

   Especifique as ramificações em seu repositório de origem que o acionador monitora para saber quando iniciar a execução de um fluxo de trabalho. Você pode usar padrões regex para definir os nomes das ramificações. Por exemplo, use main.* para combinar todas as ramificações que começam commain.

   As ramificações a serem especificadas são diferentes dependendo do tipo de acionador:

   • Para um gatilho de pressão, especifique as ramificações para as quais você está enviando, ou seja, as ramificações de destino. Uma execução de fluxo de trabalho será iniciada por ramificação correspondente, usando os arquivos na ramificação correspondente.

     Exemplos: main.*, mainline

   • Para um gatilho de pull request, especifique as ramificações para as quais você está enviando, ou seja, as ramificações de destino. Uma execução de fluxo de trabalho será iniciada por ramificação correspondente, usando o arquivo de definição do fluxo de trabalho e os arquivos de origem na ramificação de origem (não a ramificação correspondente).

     Exemplos:main.*,mainline, v1\-.* (corresponde às ramificações que começam comv1-)

   • Para um gatilho de agendamento, especifique as ramificações que contêm os arquivos que você deseja que sua execução programada use. Uma execução de fluxo de trabalho será iniciada por ramificação correspondente, usando o arquivo de definição do fluxo de trabalho e os arquivos de origem na ramificação correspondente.

     Exemplos: main.*, version\-1\.0

   nota

   Se você não especificar ramificações, o gatilho monitorará todas as ramificações em seu repositório de origem e iniciará a execução de um fluxo de trabalho usando o arquivo de definição do fluxo de trabalho e os arquivos de origem em:

   • O galho para o qual você está empurrando (para gatilhos de pressão). Para ter mais informações, consulte Exemplo: um simples gatilho de envio de código.

   • A ramificação da qual você está retirando (para acionadores de pull request). Para ter mais informações, consulte Exemplo: um simples gatilho de pull request.

   • Todas as filiais (para acionadores de agendamento). Uma execução de fluxo de trabalho será iniciada por ramificação em seu repositório de origem. Para ter mais informações, consulte Exemplo: um simples gatilho de agendamento.

   Para obter mais informações sobre ramificações e gatilhos, consulte. Acione considerações ao ramificar

   Para obter mais exemplos, consulte Exemplos de gatilhos.

   Arquivos alterados

   Esse campo só aparece se você selecionou o tipo de gatilho de solicitação push ou pull.

   Especifique os arquivos ou pastas em seu repositório de origem que o acionador monitora para saber quando iniciar a execução de um fluxo de trabalho. Você pode usar expressões regulares para combinar nomes ou caminhos de arquivos.

   Para ver exemplos, consulte Exemplos de gatilhos.

10. (Opcional) Escolha Validar para validar o código YAML do fluxo de trabalho antes de confirmar.

11. Escolha Confirmar, insira uma mensagem de confirmação e escolha Confirmar novamente.

YAML

Para adicionar um gatilho (editor YAML)

1. Abra o CodeCatalyst console em https://codecatalyst.aws/.

2. Selecione o projeto.

3. No painel de navegação, escolha CI/CD e, em seguida, escolha Fluxos de trabalho.

4. Escolha o nome do seu fluxo de trabalho. Você pode filtrar pelo nome do repositório ou ramificação de origem em que o fluxo de trabalho está definido, ou filtrar pelo nome do fluxo de trabalho.

5. Selecione a opção Editar.

6. Escolha YAML.

7. Adicione uma Triggers seção e propriedades subjacentes usando o exemplo a seguir como guia. Para obter mais informações, consulte o Triggers no Definição de fluxo de trabalho YAML.

   Um gatilho de envio de código pode ter a seguinte aparência:

   Triggers:
     - Type: PUSH
       Branches:
         - main

   Um gatilho de pull request pode ter a seguinte aparência:

   Triggers:
     - Type: PULLREQUEST
       Branches:
         - main.*
       Events: 
         - OPEN
         - REVISION
         - CLOSED
   

   Um gatilho de agendamento pode ter a seguinte aparência:

   Triggers:
     - Type: SCHEDULE
       Branches:
         - main.*
       # Run the workflow at 1:15 am (UTC+0) every Friday until the end of 2023
       Expression: "15 1 ? * FRI 2022-2023"
   

   Para obter mais exemplos de expressões cron que você pode usar na Expression propriedade, consulteExpression.

   Para obter mais exemplos de acionadores push, pull request e agendamento, consulte. Exemplos de gatilhos

8. (Opcional) Escolha Validar para validar o código YAML do fluxo de trabalho antes de confirmar.

9. Escolha Confirmar, insira uma mensagem de confirmação e escolha Confirmar novamente.