Imposta parallelismo (job)

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

La riduzione del parallelismo limita il numero di attività eseguite in parallelo. Ciò è utile nei casi in cui una delle risorse di supporto, ad esempio un database, abbia una scalabilità limitata e non sia in grado di 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 dei ruoli e delle autorizzazioni IAM associati a Cloud Run, consulta Ruoli IAM di Cloud Run e Autorizzazioni IAM di Cloud Run. Se il job Cloud Run si interfaccia con le API Google Cloud, ad esempio le librerie client di Cloud, consulta la guida alla configurazione dell'identità del servizio. Per ulteriori informazioni sulla concessione dei ruoli, consulta Autorizzazioni di deployment e Gestire l'accesso.

Configura il parallelismo

Per specificare il parallelismo per un job Cloud Run:

Console

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

    Vai a Cloud Run

  2. Se stai configurando un nuovo job, fai clic sulla scheda Job e compila la pagina iniziale delle impostazioni del job come preferisci. Se stai configurando un job esistente, fai clic sul job e poi su Modifica.

  3. Fai clic su Contenitore, variabili e secret, connessioni, sicurezza per espandere la pagina delle proprietà del job.

  4. Fai clic sulla scheda Generale.

    immagine

    • Seleziona Esegui il maggior numero possibile di attività contemporaneamente per ottenere le migliori prestazioni. Se devi ridurre il numero di attività simultanee, ad esempio se le tue risorse di supporto sono limitate, seleziona Limita il numero di attività simultanee e specifica un numero intero compreso tra 0 e 100 nella casella di testo.

  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 tuo job.
    • IMAGE_URL con un riferimento all'immagine container, ad esempio us-docker.pkg.dev/cloudrun/container/job:latest.
    • PARALLELISM Specifica un numero intero compreso tra 0 e 100 che non superi 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, salta 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 100 che non superi il numero di attività.

    Puoi anche specificare ulteriori 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, vedi Comandi Terraform di base.

Per specificare il parallelismo per un job Cloud Run, utilizza risorsa google_cloud_run_v2_job e applica il seguente snippet al file 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"
      }
    }
  }
}

Visualizza impostazioni di parallelismo

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

Console

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

    Vai ai job Cloud Run

  2. Fai clic sul lavoro che ti interessa per aprire la pagina Dettagli offerta di lavoro.

  3. Fai clic sulla scheda Configuration (Configurazione).

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

gcloud

  1. Utilizza questo comando:

    gcloud run jobs describe JOB_NAME

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