Explorar eventos

Concluído

Os eventos são implementados pela cláusula on em uma definição de fluxo de trabalho.

Há vários tipos de eventos que podem disparar fluxos de trabalho.

Eventos agendados

Com esse tipo de gatilho, um agendamento cron precisa ser fornecido.

on:
    schedule:

        - cron: '0 8-17 * * 1-5'

Os agendamentos cron são baseados em cinco valores:

  • Minuto (0 a 59)
  • Hora (0 a 23)
  • Dia do mês (1 a 31)
  • Mês (1 a 12)
  • Dia da semana (0 a 6)

Os aliases para os meses são JAN-DEC e para os dias da semana são SUN-SAT.

Um curinga significa qualquer um. (* é um valor especial em YAML, portanto, a cadeia de caracteres cron precisará estar entre aspas)

Portanto, no exemplo acima, o agendamento seria das 8:00 às 17:00 de segunda a sexta-feira.

Eventos de código

Eventos de código dispararão a maioria das ações. Ocorre quando ocorre um evento de interesse no repositório.

on:
    pull_request

O evento acima seria acionado quando um pull request ocorresse.

on:
    [push, pull_request]

O evento acima seria acionado quando ocorrisse um push ou um pull request.

on:
    pull_request:
        branches:

            - develop

O evento mostra como ser específico sobre a seção do código relevante.

Nesse caso, será disparado quando uma solicitação de pull for feita na ramificação de desenvolvimento.

Eventos manuais

Há um evento exclusivo que é usado para disparar execuções de fluxo de trabalho manualmente. Você deve usar o evento workflow_dispatch.

Seu fluxo de trabalho deve estar no branch padrão do repositório.

Eventos do webhook

Os fluxos de trabalho podem ser executados quando um webhook do GitHub é chamado.

on:
    gollum

Esse evento será acionado quando alguém atualizar (ou criar pela primeira vez) uma página wiki.

Eventos externos

Os eventos podem estar em repository_dispatch. Isso permite que os eventos sejam disparados de sistemas externos.

Para obter mais informações sobre eventos, consulte Eventos que disparam fluxos de trabalho.