Repetir jobs

Por padrão, se um job do Cloud Scheduler não receber uma confirmação do gerenciador, ele será considerado como falho e tentará novamente de acordo com a espera exponencial que você configurou. É possível determinar esse comportamento de repetição das seguintes maneiras ao criar ou atualizar um job do Cloud Scheduler:

Configurações de nova tentativa

As tabelas a seguir descrevem as configurações de nova tentativa que podem ser definidas.

Máximo de tentativas de repetição

O número de tentativas que o sistema fará para executar um job usando o procedimento de espera exponencial descrito por maxDoublings.

Descrição

Se retryCount for definido como um número diferente de zero, o Cloud Scheduler vai tentar executar o job com falha novamente, usando a espera exponencial, por retryCount vezes até que o job seja bem-sucedido ou o número de novas tentativas seja esgotado. A próxima execução programada pode ser ignorada se as novas tentativas continuarem durante esse período.

Se retryCount for 0 (e se maxRetryDuration também for 0), uma tentativa de job não será repetida em caso de falha. Em vez disso, o Cloud Scheduler vai aguardar o próximo horário de execução programado.

Valores maiores que 5 e valores negativos não são permitidos.

Padrão O padrão é 0.
Rótulo do console Máximo de tentativas de repetição
Sinalização da CLI --max-retry-attempts
Campo da API retryCount

Duração máxima da nova tentativa

O limite de tempo para tentar novamente um job com falha, medido a partir do momento em que uma execução foi tentada pela primeira vez. Se especificado com retryCount, o job será repetido até que ambos os limites sejam atingidos.

Descrição

Uma duração em segundos com até nove dígitos fracionários, terminando com "s", por exemplo, "3.5s".

Uma duração de 0 significa que a duração da nova tentativa é ilimitada. No entanto, se retryCount também for 0, uma tentativa de job não será repetida se falhar.

Padrão O padrão é 0 segundo.
Rótulo do console Duração máxima da nova tentativa
Sinalização da CLI --max-retry-duration
Campo da API maxRetryDuration

Duração mínima de espera

O tempo mínimo de espera antes de tentar novamente depois que o job falhar.

Descrição

Uma duração em segundos com até nove dígitos fracionários, terminando com "s", por exemplo, "3.5s".

Padrão O padrão é 5 segundos.
Rótulo do console Duração mínima de espera
Sinalização da CLI --min-backoff
Campo da API minBackoffDuration

Duração máxima de espera

O tempo máximo de espera antes de tentar novamente depois que o job falhar.

Descrição

Uma duração em segundos com até nove dígitos fracionários, terminando com "s", por exemplo, "3.5s".

Padrão O padrão é 3.600 segundos (1 hora).
Rótulo do console Duração máxima de espera
Sinalização da CLI --max-backoff
Campo da API maxBackoffDuration

Número máximo de duplicações

Número máximo de vezes que o intervalo entre as novas tentativas de job com falha será dobrado antes que o aumento se torne constante.

Descrição O tempo entre novas tentativas será duplicado maxDoublings vezes.

O intervalo de nova tentativa de um job começa em minBackoffDuration, dobra maxDoublings vezes, aumenta linearmente e, por fim, tenta novamente em intervalos de maxBackoffDuration até retryCount vezes. Exemplo:

Se minBackoffDuration for 10s, maxBackoffDuration for 300s e maxDoublings for 3:

  1. O job será repetido em 10 segundos.
  2. O intervalo de repetição será duplicado três vezes.
  3. O intervalo de repetição aumentará linearmente em 2^3 * 10s.
  4. Se aplicável, o job será repetido em intervalos de maxBackoffDuration até que o job tenha sido tentado retryCount vezes (até um máximo de 5 vezes).

Assim, as solicitações serão repetidas em 10s, 20s, 40s, 80s, 160s.

Se minBackoffDuration for 10s, maxBackoffDuration for 120s e maxDoublings for 2:

  1. O job será repetido em 10 segundos.
  2. O intervalo de repetição será duplicado duas vezes.
  3. O intervalo de repetição vai aumentar linearmente em 2^2 * 10s.
  4. Se aplicável, o job será repetido em intervalos de maxBackoffDuration até que o job tenha sido tentado retryCount vezes (até um máximo de 5 vezes).

Assim, as solicitações serão repetidas em 10s, 20s, 40s, 80s, 120s.

Padrão O padrão é 5.
Rótulo do console Nº máximo de duplicações
Sinalização da CLI --max-doublings
Campo da API maxDoublings

Exemplos de repetição

Os exemplos a seguir demonstram o comportamento de repetição quando um job do Cloud Scheduler não é concluído com sucesso.

Se retryCount e maxRetryDuration não estiverem definidos,

As duas configurações têm o valor padrão 0, e o job não é repetido.

O Cloud Scheduler vai tentar executar o job no próximo horário de execução programado.

Se retryCount e maxRetryDuration forem definidos

O job vai tentar novamente pelo menos retryCount vezes até atingir maxRetryDuration.

O job pode tentar mais vezes do que o retryCount.

Se retryCount estiver definido e maxRetryDuration não estiver definido

A configuração maxRetryDuration é definida como 0 por padrão, e o job vai tentar novamente exatamente o número de vezes definido em retryCount.

Se retryCount não estiver definido e maxRetryDuration estiver definido

O job vai tentar novamente quantas vezes forem necessárias (até um máximo de 5 vezes) ou até chegar a maxRetryDuration.

A seguir