Definir paralelismo para 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.

Funções exigidas

Para receber as permissões necessárias para configurar jobs do Cloud Run, peça ao administrador para conceder a você os seguintes papéis do IAM:

Para uma lista de papéis e permissões do IAM associados ao Cloud Run, consulte Papéis do IAM do Cloud Run e Permissões do IAM do Cloud Run. Se o job do Cloud Run interagir com APIs doGoogle Cloud , como as bibliotecas de cliente do Cloud, consulte o guia de configuração de identidade de serviço. Para mais informações sobre como conceder papéis, consulte permissões de implantação e gerenciar acesso.

Configurar paralelismo

É possível configurar o paralelismo para um job do Cloud Run usando o Google Cloud console, a CLI gcloud, o YAML ou o Terraform:

Console

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

    Acessar o Cloud Run

  2. Selecione Jobs no menu de navegação do Cloud Run:

    1. Se você estiver criando um job, clique em Implantar contêiner para preencher a página inicial de configurações do job.

    2. Se você estiver configurando um job, selecione-o e clique em Ver e editar a configuração do job.

  3. Clique em Contêineres, conexões, segurança para expandir a página de propriedades do job.

  4. Na seção Paralelismo, 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. Em seguida, especifique um número inteiro entre 0 e o número máximo de tarefas em execução em paralelo permitido pela cota que não exceda o número de tarefas.

  5. Clique em Criar ou Atualizar.

gcloud

  • Para definir o paralelismo ao criar um job, execute o seguinte comando:

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

    Substitua:

    • JOB: o nome do seu job do Cloud Run;
    • IMAGE_URL: uma referência à imagem do contêiner. Por exemplo, us-docker.pkg.dev/cloudrun/container/job:latest.
    • PARALLELISM: um número inteiro entre 0 e o número máximo de tarefas em execução em paralelo, permitido pela cota, que não exceda o número de tarefas.

  • Para atualizar o paralelismo de um job atual, execute o seguinte comando:

    gcloud run jobs update JOB --parallelism PARALLELISM

YAML

  1. Se você estiver criando um novo serviço, pule esta etapa. Se você estiver atualizando um serviço existente, faça o download da configuração YAML correspondente:

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

  2. Atualize o atributo parallelism::

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

    Substitua:

    • JOB: o nome do seu job do Cloud Run;
    • IMAGE_URL: uma referência à imagem do contêiner. Por exemplo, us-docker.pkg.dev/cloudrun/container/job:latest.
    • PARALLELISM: um número inteiro entre 0 e o número máximo de tarefas em execução em paralelo, permitido pela cota, 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. Crie ou atualize o serviço usando o seguinte comando:

    gcloud run jobs replace job.yaml

    Por padrão, o comando gcloud run jobs replace usa o arquivo job.yaml, se ele estiver presente.

Terraform

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

Adicione o seguinte a um recurso google_cloud_run_v2_job na configuração do Terraform:
resource "google_cloud_run_v2_job" "default" {
  name     = "cloud-run-job-parallelism"
  location = "us-central1"

  deletion_protection = false # set to "true" in production

  template {
    task_count  = 3
    parallelism = 3

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

Ver configurações do paralelismo

Para conferir as configurações atuais de paralelismo do job do Cloud Run, use o console Google Cloud ou a Google Cloud CLI:

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 para abrir a página Detalhes do job.

  3. Clique em Ver e editar a configuração do job.

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

gcloud

  1. Execute este comando:

    gcloud run jobs describe JOB

  2. Localize a configuração de paralelismo na configuração retornada.