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 do Cron são baseados em cinco valores:

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

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 8h às 17h de segunda a sexta-feira.

Eventos de código

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

on:
    pull_request

O evento acima seria disparado quando ocorresse uma solicitação de pull.

on:
    [push, pull_request]

O evento acima seria disparado quando ocorresse uma solicitação de pull ou push.

on:
    pull_request:
        branches:

            - develop

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

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

Eventos manuais

Há um evento exclusivo usado para disparar as execuções de fluxo de trabalho manualmente. Use o evento workflow_dispatch.

Seu fluxo de trabalho deve estar na ramificação padrão do repositório.

Eventos do webhook

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

on:
    gollum

Esse evento seria disparado quando alguém atualizasse (ou criasse primeiro) uma página do 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, confira Eventos que disparam fluxos de trabalho.