Defina o paralelismo para tarefas

Use parallelism para especificar o número máximo de tarefas numa execução de trabalho que podem ser executadas em paralelo. Por predefinição, as tarefas são iniciadas o mais rapidamente possível, até um máximo que varia consoante o número de CPUs que estiver a usar.

A redução do paralelismo limita o número de tarefas executadas em paralelo. Isto é útil nos casos em que um dos seus recursos de apoio, como uma base de dados, tem uma escalabilidade limitada e não consegue processar um grande número de pedidos paralelos.

Funções necessárias

Para receber as autorizações de que precisa para configurar tarefas do Cloud Run, peça ao seu administrador para lhe conceder as seguintes funções de IAM:

Para ver uma lista de funções e autorizações de IAM associadas ao Cloud Run, consulte os artigos Funções de IAM do Cloud Run e Autorizações de IAM do Cloud Run. Se a sua tarefa do Cloud Run interagir com Google Cloud APIs, como as bibliotecas de cliente da Google Cloud, consulte o guia de configuração da identidade do serviço. Para mais informações sobre a atribuição de funções, consulte as autorizações de implementação e faça a gestão do acesso.

Configure o paralelismo

Para especificar o paralelismo de uma tarefa do Cloud Run:

Consola

  1. Na Google Cloud consola, aceda à página Tarefas do Cloud Run:

    Aceda ao Cloud Run

  2. Selecione Tarefas no menu e clique em Implementar contentor para preencher a página de definições iniciais da tarefa. Se estiver a configurar uma tarefa existente, selecione a tarefa e, de seguida, clique em Editar.

  3. Clique em Recipientes, volumes, ligações, segurança para expandir a página de propriedades da tarefa.

  4. Clique no separador Geral.

    imagem

    • Selecione Executar o maior número possível de tarefas em simultâneo para ter o melhor desempenho. Se precisar de diminuir o número de tarefas simultâneas, por exemplo, se os seus recursos de apoio forem limitados, selecione Limitar o número de tarefas simultâneas e, em seguida, especifique um número inteiro entre 0 e o número máximo de tarefas em execução em paralelo permitidas pela quota que não exceda o número de tarefas.

  5. Clique em Criar ou Atualizar.

gcloud

  1. Para um trabalho que está a criar:

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

    Substituir

    • JOB_NAME com o nome do seu trabalho.
    • IMAGE_URL: uma referência à imagem do contentor, por exemplo, us-docker.pkg.dev/cloudrun/container/job:latest.
    • PARALLELISM com um número inteiro entre 0 e o número máximo de tarefas em execução em paralelo, permitido pela quota, que não excede o número de tarefas.

  2. Para um trabalho que está a atualizar:

    gcloud run jobs update JOB_NAME --parallelism PARALLELISM

YAML

  1. Se estiver a criar uma nova tarefa, ignore este passo. Se estiver a atualizar uma tarefa existente, transfira a respetiva configuração YAML:

    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

    Substituir PARALLELISM. Especifique um número inteiro entre 0 e o número máximo de tarefas em execução em paralelo permitido pela quota que não excede o número de tarefas.

    Também pode especificar mais configurações, como variáveis de ambiente ou limites de memória.

  3. Atualize a configuração da tarefa existente:

    gcloud run jobs replace job.yaml

Terraform

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

Adicione o seguinte a um recurso google_cloud_run_v2_job na sua 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"
      }
    }
  }
}

Veja as definições de paralelismo

Para ver as definições de paralelismo atuais para a sua tarefa do Cloud Run:

Consola

  1. Na Google Cloud consola, aceda à página Tarefas do Cloud Run:

    Aceda às tarefas do Cloud Run

  2. Clique no trabalho que lhe interessa para abrir a página Detalhes do trabalho.

  3. Clique em Ver e editar configuração da tarefa.

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

gcloud

  1. Use o seguinte comando:

    gcloud run jobs describe JOB_NAME

  2. Localize a definição de paralelismo na configuração devolvida.