Parallelität für Jobs festlegen

Mit parallelism geben Sie die maximale Anzahl von Aufgaben in einer Jobausführung an, die parallel ausgeführt werden können. Standardmäßig werden Aufgaben so schnell wie möglich gestartet. Der Höchstwert hängt von der Anzahl der verwendeten CPUs ab:

Durch das Senken der Parallelität wird die Anzahl der parallel ausgeführten Aufgaben begrenzt. Dies ist nützlich, wenn eine Ihrer Sicherungsressourcen, z. B. eine Datenbank, nur begrenzt skaliert wird und eine große Anzahl paralleler Anfragen nicht verarbeiten kann.

Erforderliche Rollen

Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Konfigurieren von Cloud Run-Jobs benötigen:

Eine Liste der IAM-Rollen und -Berechtigungen im Zusammenhang mit Cloud Run finden Sie unter IAM-Rollen für Cloud Run und IAM-Berechtigungen für Cloud Run. Wenn Ihr Cloud Run-Job mitGoogle Cloud APIs wie Cloud-Clientbibliotheken verknüpft ist, lesen Sie die Konfigurationsanleitung für Dienstidentitäten. Weitere Informationen zum Zuweisen von Rollen finden Sie unter Bereitstellungsberechtigungen und Zugriff verwalten.

Parallelität konfigurieren

Sie können die Parallelität für einen Cloud Run-Job über dieGoogle Cloud Console, die gcloud CLI, YAML oder Terraform konfigurieren:

Console

  1. Rufen Sie in der Google Cloud Console die Seite „Cloud Run“ auf:

    Zu Cloud Run

  2. Wählen Sie im Cloud Run-Navigationsmenü Jobs aus:

    1. Wenn Sie einen neuen Job erstellen, klicken Sie auf Container bereitstellen, um die Seite mit den anfänglichen Jobeinstellungen auszufüllen.

    2. Wenn Sie einen vorhandenen Job konfigurieren, wählen Sie den Job aus und klicken Sie dann auf Jobkonfiguration ansehen und bearbeiten.

  3. Klicken Sie auf Container, Verbindungen, Sicherheit, um die Seite mit den Jobattributen zu maximieren.

  4. Wählen Sie im Bereich Parallelität die Option So viele Aufgaben wie möglich gleichzeitig ausführen aus, um die Leistung zu optimieren. Wenn Sie die Anzahl der gleichzeitigen Aufgaben verringern müssen, z. B. wenn Ihre Sicherungsressourcen begrenzt sind, wählen Sie Anzahl der gleichzeitigen Aufgaben begrenzen aus. Geben Sie dann eine Ganzzahl zwischen 0 und der maximalen Anzahl von Aufgaben an, die parallel ausgeführt werden können und die durch das Kontingent nicht überschritten wird.

  5. Klicken Sie auf Erstellen oder Aktualisieren.

gcloud

  • Führen Sie den folgenden Befehl aus, um Parallelität festzulegen, wenn Sie einen neuen Job erstellen:

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

    Ersetzen Sie Folgendes:

    • JOB: Der Name Ihres Cloud Run-Jobs.
    • IMAGE_URL: Ein Verweis auf das Container-Image, z. B. us-docker.pkg.dev/cloudrun/container/job:latest.
    • PARALLELISM: Eine Ganzzahl zwischen 0 und der maximalen Anzahl von parallel ausgeführten Aufgaben, die durch das Kontingent zulässig sind und die Anzahl der Aufgaben nicht überschreiten.
  • Führen Sie den folgenden Befehl aus, um die Parallelität zu aktualisieren:

    gcloud run jobs update JOB --parallelism PARALLELISM

YAML

  1. Wenn Sie einen neuen Job erstellen, überspringen Sie diesen Schritt. Wenn Sie einen vorhandenen Job aktualisieren, laden Sie die zugehörige YAML-Konfiguration herunter:

    gcloud run jobs describe JOB --format export > job.yaml
  2. Aktualisieren Sie das Attribut parallelism::

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

    Ersetzen Sie Folgendes:

    • JOB: Der Name Ihres Cloud Run-Jobs.
    • IMAGE_URL: Ein Verweis auf das Container-Image, z. B. us-docker.pkg.dev/cloudrun/container/job:latest.
    • PARALLELISM: Eine Ganzzahl zwischen 0 und der maximalen Anzahl von parallel ausgeführten Aufgaben, die durch das Kontingent zulässig sind und die Anzahl der Aufgaben nicht überschreiten.

    Sie können auch weitere Konfigurationen angeben, z. B. Umgebungsvariablen oder Speicherlimits.

  3. Erstellen oder aktualisieren Sie den Dienst mit dem folgenden Befehl:

    gcloud run jobs replace job.yaml

    Standardmäßig wird mit dem Befehl gcloud run jobs replace die Datei job.yaml verwendet, sofern sie vorhanden ist.

Terraform

Informationen zum Anwenden oder Entfernen einer Terraform-Konfiguration finden Sie unter Grundlegende Terraform-Befehle.

Fügen Sie einer google_cloud_run_v2_job-Ressource in Ihrer Terraform-Konfiguration Folgendes hinzu:
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"
      }
    }
  }
}

Parallelitätseinstellungen aufrufen

So rufen Sie die aktuellen Parallelitätseinstellungen für Ihren Cloud Run-Job auf: Google Cloud

Console

  1. Wechseln Sie in der Google Cloud -Console zur Seite „Cloud Run-Jobs“:

    Zu Cloud Run-Jobs

  2. Klicken Sie auf den Job, um die Seite Jobdetails zu öffnen.

  3. Klicken Sie auf Jobkonfiguration ansehen und bearbeiten.

  4. Suchen Sie in den Konfigurationsdetails nach der Einstellung für die Parallelität.

gcloud

  1. Führen Sie dazu diesen Befehl aus:

    gcloud run jobs describe JOB
  2. Suchen Sie in der zurückgegebenen Konfiguration nach der Parallelitätseinstellungen.