Impostare il parallelismo per i job

Utilizza parallelism per specificare il numero massimo di attività in un'esecuzione del job che possono essere eseguite in parallelo. Per impostazione predefinita, le attività vengono avviate il più rapidamente possibile, fino a un massimo che varia a seconda del numero di CPU in uso.

La riduzione del parallelismo limita il numero di attività eseguite in parallelo. Questa opzione è utile nei casi in cui una delle risorse di backend, ad esempio un database, ha una scalabilità limitata e non può gestire un numero elevato di richieste parallele.

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per configurare i job Cloud Run, chiedi all'amministratore di concederti i seguenti ruoli IAM:

Per un elenco di ruoli e autorizzazioni IAM associati a Cloud Run, consulta Ruoli IAM di Cloud Run e Autorizzazioni IAM di Cloud Run. Se il tuo job Cloud Run interagisce con Google Cloud le API, come le librerie client Cloud, consulta la guida alla configurazione dell'identità del servizio. Per saperne di più sulla concessione dei ruoli, consulta Autorizzazioni di deployment e Gestisci l'accesso.

Configura il parallelismo

Per specificare il parallelismo per un job Cloud Run:

Console

  1. Nella Google Cloud console, vai alla pagina Job di Cloud Run:

    Vai a Cloud Run

  2. Fai clic su Esegui il deployment del container per compilare la pagina delle impostazioni iniziali del job. Se stai configurando un job esistente, selezionalo e fai clic su Visualizza e modifica la configurazione del job.

  3. Fai clic su Container, connessioni, sicurezza per espandere la pagina delle proprietà del job.

  4. Fai clic sulla scheda Generale.

    immagine

    • Seleziona Esegui simultaneamente il maggior numero di attività possibile per ottenere prestazioni ottimali. Se devi ridurre il numero di attività simultanee, per esempio se le risorse di backend sono limitate, seleziona Limita il numero di attività simultanee e poi specifica un numero intero compreso tra 0 e il numero massimo di attività eseguite in parallelo consentito dalla quota che non supera il numero di attività.

  5. Fai clic su Crea o Aggiorna.

gcloud

  1. Per un job che stai creando:

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

    Sostituisci

    • JOB_NAME con il nome del job.
    • IMAGE_URL: un riferimento all'immagine container, ad esempio us-docker.pkg.dev/cloudrun/container/job:latest.
    • PARALLELISM con un numero intero compreso tra 0 e il numero massimo di attività eseguite in parallelo, consentito dalla quota, che non supera il numero di attività.

  2. Per un job che stai aggiornando:

    gcloud run jobs update JOB_NAME --parallelism PARALLELISM

YAML

  1. Se stai creando un nuovo job, ignora questo passaggio. Se stai aggiornando un job esistente, scarica la relativa configurazione YAML:

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

  2. Aggiorna l'attributo parallelism::

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

    Sostituisci PARALLELISM. Specifica un numero intero compreso tra 0 e il numero massimo di attività eseguite in parallelo consentito dalla quota che non supera il numero di attività.

    Puoi anche specificare altre configurazioni, come le variabili di ambiente o i limiti di memoria.

  3. Aggiorna la configurazione del job esistente:

    gcloud run jobs replace job.yaml

Terraform

Per scoprire come applicare o rimuovere una configurazione Terraform, consulta Comandi Terraform di base.

Aggiungi quanto segue a una google_cloud_run_v2_job risorsa nella configurazione 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"
      }
    }
  }
}

Visualizza le impostazioni di parallelismo

Per visualizzare le impostazioni di parallelismo correnti per il job Cloud Run:

Console

  1. Nella Google Cloud console, vai alla pagina dei job Cloud Run:

    Vai ai job Cloud Run

  2. Fai clic sul job che ti interessa per aprire la pagina Dettagli job.

  3. Fai clic su Visualizza e modifica la configurazione del job.

  4. Individua l'impostazione di parallelismo nei dettagli della configurazione.

gcloud

  1. Utilizza il seguente comando:

    gcloud run jobs describe JOB_NAME

  2. Individua l'impostazione di parallelismo nella configurazione restituita.