Paralelismo (jobs)

Use parallelism para especificar o número máximo de tarefas em uma execução de job que podem ser executadas em paralelo. Por padrão, as tarefas serão iniciadas o mais rápido possível, até um máximo que varia de acordo com a quantidade de CPUs que você está usando:

A redução do paralelismo limita quantas tarefas são executadas em paralelo. Isso é útil nos casos em que um dos recursos de apoio, como um banco de dados, tem escalonamento limitado e não pode lidar com um grande número de solicitações paralelas.

Para especificar o paralelismo de um job do Cloud Run, faça o seguinte:

Console

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

    Acesse o Cloud Run

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

  3. Clique em Contêiner, variáveis e secrets, conexões e segurança para expandir a página de propriedades do job.

  4. Clique na guia Geral.

    imagem

    • Selecione Executar o maior número possível de tarefas simultaneamente para ter o melhor desempenho. Se você precisar diminuir o número de tarefas simultâneas, por exemplo, se os recursos de apoio forem limitados, selecione Limitar o número de tarefas simultâneas e especifique um número inteiro entre 0 e 100 na caixa de texto.
  5. Clique em Criar ou Atualizar.

Linha de comando

  1. Para um job que você está criando:

    gcloud run jobs create JOB_NAME --image IMAGE_URL --parallelism PARALLELISM

    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;
    • PARALLELISM Especifique um número inteiro entre 0 e 100 que não exceda o número de tarefas.
  2. Para um job que você está atualizando, faça o seguinte:

    gcloud run jobs update JOB_NAME --parallelism PARALLELISM

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.

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

    gcloud run jobs describe JOB_NAME --format export > job.yaml
  2. Atualize o atributo parallelism::

    apiVersion: run.googleapis.com/v1
    kind: Job
    metadata:
      name: JOB_NAME
    spec:
      template:
        spec:
          parallelism: PARALLELISM
          template:
            spec:
              containers:
              - image: IMAGE

    Substitua PARALLELISM. Especifique um número inteiro entre 0 e 100 que não exceda o número de tarefas.

    Também é possível definir outras configurações, como variáveis de ambiente ou limites de memória.

  3. 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 paralelismo 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-parallelism"
  location     = "us-central1"
  launch_stage = "BETA"

  template {
    task_count  = 3
    parallelism = 3

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

Ver configurações do paralelismo

Para ver as configurações atuais de paralelismo do job do Cloud Run:

Console

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

    Acessar jobs do Cloud Run

  2. Clique no job em que você tem interesse para abrir a página Detalhes do job.

  3. Clique na guia Configuração.

  4. Localize a definição do paralelismo nos detalhes da configuração.

Linha de comando

  1. Use o comando a seguir:

    gcloud run jobs describe JOB_NAME
  2. Localize a configuração de paralelismo na configuração retornada.