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.
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.