O Que É um Cron Schedule no GitHub Actions?

Um cron schedule executa um workflow em horários recorrentes usando a sintaxe cron, por meio do trigger schedule.

Alguns trabalhos são baseados em tempo, não em eventos: builds noturnos, verificações semanais de dependências, health probes de hora em hora. O trigger schedule com sintaxe cron executa workflows em um relógio recorrente.

O que é

Um trigger schedule com uma ou mais entradas cron:. Cada entrada é uma expressão cron de cinco campos em UTC descrevendo quando o workflow deve ser executado.

on:
  schedule:
    - cron: '0 2 * * *'   # daily at 02:00 UTC
    - cron: '0 */6 * * *' # every 6 hours

Como funciona

O GitHub avalia as expressões cron em UTC e enfileira o workflow nos horários correspondentes. Execuções agendadas sempre usam o arquivo de workflow da branch padrão.

Ressalvas

• Os horários são em UTC, não no seu fuso local.
• Execuções podem sofrer atraso sob alta carga; o horário exato não é garantido.
• Schedules em repos inativos podem ser desativados automaticamente.

Por que importa

Workflows agendados cuidam de manutenções que não devem esperar por um push. Confiabilidade importa aqui; os runners gerenciados da Latchkey pegam jobs agendados em uma frota com autocorreção, de modo que uma instância ruim não pule silenciosamente uma execução noturna.

Conceitos relacionados

O evento schedule é um de muitos triggers e é executado apenas a partir da branch padrão.

Principais conclusões

• Um cron schedule executa um workflow em um relógio recorrente.
• Expressões cron têm cinco campos, em UTC.
• Execuções agendadas usam a branch padrão e podem sofrer atraso.

Guias relacionados