Parallelität festlegen (Jobs)

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 zu gewähren, um die zum Konfigurieren von Cloud Run-Jobs erforderlichen Berechtigungen zu erhalten:

Rolle Cloud Run Entwickler (roles/run.developer) im Cloud Run-Job
Dienstkontonutzer (roles/iam.serviceAccountUser) für die Dienstidentität

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 mit Google 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

So legen Sie die Parallelität für einen Cloud Run-Job fest:

Console

Wechseln Sie in der Google Cloud Console zur Seite "Cloud Run-Jobs":

Öffnen Sie Cloud Run.
Klicken Sie auf den Tab Jobs und füllen Sie die Seite mit den anfänglichen Jobeinstellungen wie gewünscht aus, wenn Sie einen neuen Job konfigurieren. Klicken Sie auf den Job und dann auf Bearbeiten, wenn Sie einen vorhandenen Job konfigurieren.
Klicken Sie auf Container, Variablen und Secrets, Verbindungen, Sicherheit, um die Seite mit den Jobattributen zu maximieren.
Klicken Sie auf den Tab Allgemein.
- Wählen Sie 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 und geben Sie dann eine Ganzzahl zwischen 0 und 100 in das Textfeld ein.
Klicken Sie auf Erstellen oder Aktualisieren.

Befehlszeile

Für einen Job, den Sie erstellen:
```
gcloud run jobs create JOB_NAME --image IMAGE_URL --parallelism PARALLELISM
```
Ersetzen
- JOB_NAME durch den Namen des Jobs.
- IMAGE_URL durch einen Verweis auf das Container-Image, z. B. us-docker.pkg.dev/cloudrun/container/job:latest.
- PARALLELISM Geben Sie eine Ganzzahl zwischen 0 und 100 an, die die Anzahl der Aufgaben nicht überschreitet.

Für einen Job, den Sie aktualisieren:

gcloud run jobs update JOB_NAME --parallelism PARALLELISM

YAML

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_NAME --format export > job.yaml
```
Aktualisieren Sie das Attribut parallelism::
```
apiVersion: run.googleapis.com/v1
kind: Job
metadata:
  name: JOB_NAME
spec:
  template:
    spec:
      parallelism: PARALLELISM
      template:
        spec:
          containers:
          - image: IMAGE
```
Ersetzen Sie PARALLELISM. Geben Sie eine Ganzzahl zwischen 0 und 100 an, die die Anzahl der Aufgaben nicht überschreitet.

Sie können auch weitere Konfigurationen angeben, z. B. Umgebungsvariablen oder Speicherlimits.
Aktualisieren Sie die vorhandene Jobkonfiguration:
```
gcloud run jobs replace job.yaml
```

Terraform

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

Verwenden Sie die Ressource google_cloud_run_v2_job und wenden Sie das folgende Snippet auf Ihre main.tf-Datei an, um die Parallelität für einen Cloud Run-Job anzugeben:

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"
      }
    }
  }
}

Parallelitätseinstellungen aufrufen

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

Console

Wechseln Sie in der Google Cloud Console zur Seite "Cloud Run-Jobs":

Zu Cloud Run-Jobs
Klicken Sie auf den gewünschten Job, um die Seite Jobdetails zu öffnen.
Klicken Sie auf den Tab Konfiguration.
Suchen Sie in den Konfigurationsdetails nach der Einstellung für die Parallelität.

Befehlszeile

Verwenden Sie den folgenden Befehl:
```
gcloud run jobs describe JOB_NAME
```
Suchen Sie in der zurückgegebenen Konfiguration nach der Parallelitätseinstellungen.