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.