Definir novas tentativas (jobs)

Um job do Cloud Run consiste em uma ou mais tarefas. A configuração de número máximo de tentativas especifica o número de vezes que uma tarefa pode ser reiniciada em caso de falha antes de falhar permanentemente. O padrão é 3.

Essa configuração se aplica por tarefa, não por job. Se você definir esse valor como 0, as tarefas vão ser executadas apenas uma vez e não serão repetidas em caso de falha.

Para especificar o número máximo de novas tentativas, faça o seguinte:

Console

No console do Google Cloud, acesse a página de jobs do Cloud Run:

Acesse o Cloud Run
Se você estiver configurando um novo job, clique na guia Jobs e preencha a página inicial de configurações do job conforme quiser. Se você estiver configurando um job, clique nele e em Editar.
Clique em Contêiner, variáveis e secrets, conexões e segurança para expandir a página de propriedades do job.
Clique na guia Geral.
- Especifique o número de novas tentativas usando um número inteiro de 0 a 10.
Clique em Criar ou Atualizar.

Linha de comando

Para um job que você está criando:
```
gcloud run jobs create JOB_NAME --image IMAGE_URL --max-retries RETRY
```
Substituir
- JOB_NAME pelo nome do job;
- IMAGE_URL por uma referência à imagem de contêiner. Por exemplo, us-docker.pkg.dev/cloudrun/container/job:latest;
- RETRY com o número de novas tentativas: especifique um número inteiro de 0 a 10.
Para um job que você está atualizando, faça o seguinte:
```
gcloud run jobs update JOB_NAME --max-retries RETRY
```

YAML

Faça o download e consulte a configuração do job que já existe usando o comando gcloud run jobs describe --format export, que gera resultados limpos no formato YAML. Em seguida, modifique os campos descritos abaixo e faça upload do YAML modificado usando o comando gcloud run jobs replace. Modifique os campos somente conforme documentado.

Para visualizar e fazer o download da configuração:

gcloud run jobs describe JOB_NAME --format export > job.yaml

Atualize o atributo maxRetries::
```
apiVersion: run.googleapis.com/v1
kind: Job
metadata:
  name: JOB
spec:
  template:
    spec:
      template:
        spec:
          containers:
          - image: IMAGE
          maxRetries: RETRIES
```
Substitua RETRIES pelo número de novas tentativas: especifique um número inteiro de 0 a 10.

Também é possível definir outras configurações, como variáveis de ambiente ou limites de memória.
Atualize a configuração do job que já existe:
```
gcloud run jobs replace job.yaml
```

Terraform

Para saber como aplicar ou remover uma configuração do Terraform, consulte Comandos básicos do Terraform.

Para especificar o máximo de tentativas para um job do Cloud Run, use o recurso google_cloud_run_v2_job e aplique o seguinte snippet ao seu arquivo main.tf:

resource "google_cloud_run_v2_job" "default" {
  name         = "cloud-run-job-retries"
  location     = "us-central1"
  launch_stage = "BETA"

  template {
    template {
      max_retries = 3

      containers {
        image = "us-docker.pkg.dev/cloudrun/container/job:latest"
      }
    }
  }
}

Ver configurações do máximo de novas tentativas

Para ver as configurações atuais de novas tentativas máximas para seu job do Cloud Run:

Console

No console do Google Cloud, acesse a página de jobs do Cloud Run:

Acessar jobs do Cloud Run
Clique no job em que você tem interesse para abrir a página Detalhes do job.
Clique na guia Configuração.
Localize a definição de novas tentativas nos detalhes de configuração.

Linha de comando

Use o comando a seguir:
```
gcloud run jobs describe JOB_NAME
```
Localize o número máximo de configuração de tentativas na configuração retornada.