Como configurar programações de cron jobs

Esta página fornece uma breve descrição do uso do formato unix-cron para descrever as programações de jobs. Você também pode usar a sintaxe cron legada do Google App Engine para descrever a programação.

Como definir a programação de jobs

Os cron jobs são programados em intervalos recorrentes e especificados no formato unix-cron. É possível definir uma programação para que o job seja executado diversas vezes por dia ou em dias e meses determinados.

Um planejamento é descrito usando o formato de sequência unix-cron (* * * * *), que é um conjunto de cinco valores em uma linha, indicando quando o trabalho deve ser executado.

image

Você pode usar o Console do Google Cloud, a linha de comando gcloud ou a API REST do Cloud Scheduler para definir seus agendamentos.

A tabela a seguir mostra os possíveis valores para os campos de data e hora:

Campo Valores válidos
Minuto 0-59
Hora 0-23
dia do mês 1-31
Mês 1-12
Dia da semana 0-6 (domingo a sábado)

Você pode selecionar o fuso horário para avaliar os agendamentos usando o menu suspenso na tela do Console do Cloud Criar um job ou o sinalizador gcloud --time-zone quando você crie o trabalho. O fuso horário padrão é Etc/UTC.

Exemplos de programação

A tabela a seguir contém exemplos com descrições de programações cron:

Exemplo de programação Formato no Cloud Scheduler
A cada minuto * * * * *
Todo sábado às 23h45 45 23 * * 6
Todas as segundas-feiras às 9h 0 9 * * 1

Horário de verão

Em alguns fusos horários, o horário de verão pode fazer com que os jobs sejam executados fora das cadências esperadas. Isso ocorre porque o Cloud Scheduler é executado no horário normal. Nos casos em que um horário pode ocorrer duas vezes (como no caso de relógios retrocederem) e seu job for agendado nesse momento, ele poderá observar anomalias de execução.

Se o seu job exigir uma cadência muito específica, considere a escolha de fusos horários que não observem o horário de verão. Especificamente, o UTC é recomendado para o Cloud Scheduler para evitar o problema completamente.