Jobs erstellen

Console

So erstellen Sie einen neuen Job:

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

   Zu Cloud Run

2. Wählen Sie im Menü Jobs aus und klicken Sie auf Container bereitstellen, um das Formular Job erstellen aufzurufen.

   1. Geben Sie im Formular das Container-Image an, das den Jobcode enthält, oder wählen Sie es aus einer Liste von Containern aus, die zuvor bereitgestellt wurden.
   2. Der Jobname wird automatisch aus dem Container-Image generiert. Sie haben aber die Möglichkeit, den Jobnamen nach Bedarf zu bearbeiten oder zu ändern. Nach dem Erstellen des Jobs kann der Jobname nicht mehr geändert werden.
   3. Wählen Sie die Region aus, in der sich Ihr Job befinden soll. In der Regionsauswahl sind die Regionen mit dem niedrigsten CO2-Ausstoß hervorgehoben.
   4. Geben Sie an, wie viele Aufgaben im Job ausgeführt werden sollen. Ein Job ist erst erfolgreich, wenn alle Aufgaben erfolgreich ausgeführt werden. Die Aufgaben werden standardmäßig parallel ausgeführt.

3. Klicken Sie auf Container, Volumes, Netzwerk, Sicherheit, um zusätzliche Jobattribute festzulegen.

   • Unter „Aufgabenkapazität“ können Sie Folgendes angeben:
   1. Im Menü Arbeitsspeicher geben Sie an, wie viel Arbeitsspeicher erforderlich ist. Der Standardwert ist der Mindestwert von 512 MiB.
   2. Im Menü CPU geben Sie die erforderliche CPU-Menge an. Der Standardwert ist der Mindestwert von 1 CPU.

   3. Geben Sie unter Zeitlimit der Aufgabe die maximale Zeit in Sekunden an, in der die Aufgabe ausgeführt werden soll (bis zu 168 Stunden bzw. 7 Tage). Die Unterstützung für Zeitüberschreitungen von mehr als 24 Stunden ist in der Vorschau verfügbar. Jede Aufgabe muss innerhalb dieses Zeitraums abgeschlossen werden. Der Standardwert beträgt 10 Minuten (600 Sekunden).

   4. Unter Anzahl der Wiederholungsversuche pro fehlgeschlagener Aufgabe geben Sie die Anzahl der Wiederholungen im Fall von Aufgabenfehlern an. Der Standardwert beträgt 3 Wiederholungsversuche.

   • Unter „Parallelität“ können Sie Folgendes angeben:

     1. In den meisten Fällen können Sie So viele Aufgaben wie möglich gleichzeitig ausführen auswählen.
     2. Wenn Sie aufgrund von Skalierungsbeschränkungen für Ressourcen, auf die Ihr Auftrag zugreift, eine niedrigere Grenze festlegen müssen, wählen Sie die Option Maximale Anzahl gleichzeitiger Aufgaben begrenzen und geben Sie die Anzahl der gleichzeitigen Aufgaben im Feld Benutzerdefinierte Parallelitätsgrenze an.

4. Konfigurieren Sie optional weitere Einstellungen auf den entsprechenden Tabs:

   • Containerkonfiguration
   • CPU-Beschränkungen
   • Speicherlimits
   • Secrets
   • Umgebungsvariablen
   • Labels
   • Dienstkonten
   • Cloud SQL-Verbindungen
   • VPC-Konnektivität

5. Wenn Sie die Konfiguration Ihres Jobs abgeschlossen haben, klicken Sie auf Erstellen, um den Job in Cloud Run zu erstellen.

6. Informationen zum Ausführen des Jobs finden Sie unter Jobs ausführen oder Jobs nach einem Zeitplan ausführen.

gcloud

Um die Befehlszeile zu verwenden, müssen Sie bereits die gcloud-CLI eingerichtet haben.

So erstellen Sie einen neuen Job:

1. Führen Sie diesen Befehl aus:

   gcloud run jobs create JOB_NAME --image IMAGE_URL OPTIONS

   Alternativ können Sie den Bereitstellungsbefehl verwenden:

   gcloud run jobs deploy JOB_NAME --image IMAGE_URL OPTIONS

   Ersetzen Sie Folgendes:

   • JOB_NAME: der Name des Jobs, den Sie erstellen möchten. Wenn Sie diesen Parameter weglassen, werden Sie beim Ausführen des Befehls nach dem Jobnamen gefragt.
   • IMAGE_URL: Ein Verweis auf das Container-Image, z. B. us-docker.pkg.dev/cloudrun/container/job:latest.

   • Ersetzen Sie optional OPTIONS durch eine der folgenden Optionen:

     Option	Beschreibung
     --tasks	Akzeptiert Ganzzahlen, die größer oder gleich 1 sind. Der Standardwert ist 1. Maximum ist 10.000. Jeder Aufgabe werden die Umgebungsvariablen CLOUD_RUN_TASK_INDEX mit einem Wert zwischen 0 und der Anzahl der Aufgaben minus 1 zusammen mit CLOUD_RUN_TASK_COUNT bereitgestellt (die Anzahl der Aufgaben).
     --max-retries	Die Anzahl der Ausführungsversuche einer fehlgeschlagenen Aufgabe. Sobald eine Aufgabe dieses Limit überschreitet, wird der gesamte Job als fehlgeschlagen markiert. Wenn beispielsweise 1 festgelegt ist, wird eine fehlgeschlagene Aufgabe einmal für insgesamt zwei Versuche wiederholt. Der Standardwert ist 3. Akzeptiert Ganzzahlen von 0 bis 10.
     --task-timeout	Akzeptiert eine Dauer wie "2s". Der Standardwert ist 10 Minuten. Der Höchstwert beträgt 168 Stunden (7 Tage). Die Unterstützung für Zeitüberschreitungen von mehr als 24 Stunden ist in der Vorschau verfügbar.
     --parallelism	Die maximale Anzahl von Aufgaben, die parallel ausgeführt werden können. Aufgaben werden standardmäßig so schnell wie möglich parallel gestartet. Weitere Informationen finden Sie unter Parallelverarbeitung.
     --execute-now	Wenn festgelegt, wird unmittelbar nach dem Erstellen des Jobs eine Jobausführung gestartet. Entspricht dem Aufruf von gcloud run jobs create gefolgt von gcloud run jobs execute.

     Zusätzlich zu den oben genannten Optionen können Sie auch weitere Konfigurationen angeben, z. B. Umgebungsvariablen oder Speicherlimits.

     Eine vollständige Liste der verfügbaren Optionen beim Erstellen eines Jobs finden Sie in der Dokumentation zur Befehlszeilenschnittstelle gcloud run jobs create.

2. Warten Sie, bis die Joberstellung abgeschlossen ist. Nach erfolgreichem Abschluss wird eine Erfolgsmeldung angezeigt.

3. Informationen zum Ausführen des Jobs finden Sie unter Jobs ausführen oder Jobs nach einem Zeitplan ausführen.

YAML

Sie können Ihre Jobspezifikation in einer YAML-Datei speichern und dann mit der gcloud CLI bereitstellen.

1. Erstellen Sie eine neue job.yaml-Datei mit folgendem Inhalt:

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

   Ersetzen Sie Folgendes:

   • JOB: Der Name Ihres Cloud Run-Jobs. Jobnamen dürfen maximal 49 Zeichen lang sein und pro Region und Projekt nur einmal vorkommen.
   • IMAGE_URL: Ein Verweis auf das Container-Image, z. B. us-docker.pkg.dev/cloudrun/container/job:latest.

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

2. Stellen Sie den neuen Job mit dem folgenden Befehl bereit:

   gcloud run jobs replace job.yaml

Terraform

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

resource "google_cloud_run_v2_job" "default" {
  name     = "cloud-run-job"
  location = "us-central1"

  deletion_protection = false # set to "true" in production

  template {
    template {
      containers {
        image = "us-docker.pkg.dev/cloudrun/container/job:latest"
      }
    }
  }
}

Clientbibliotheken

So erstellen Sie einen Job aus Code:

• Go
• Java
• Node.js
• Python
• Ruby
• PHP
• .NET

REST API

Senden Sie zum Erstellen eines Jobs eine POST-HTTP-Anfrage an den Endpunkt jobs der Cloud Run Admin API.

Verwenden Sie zum Beispiel curl:

curl -H "Content-Type: application/json" \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -X POST \
  -d '{template: {template: {containers: [{image: "IMAGE_URL"}]}}}' \
  https://run.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/jobs?jobId=JOB_NAME

Ersetzen Sie Folgendes:

• ACCESS_TOKEN: Ein gültiges Zugriffstoken für ein Konto, das die IAM-Berechtigungen zum Erstellen von Jobs hat. Wenn Sie beispielsweise in gcloud angemeldet sind, können Sie ein Zugriffstoken mit gcloud auth print-access-token abrufen. Innerhalb einer Cloud Run-Containerinstanz können Sie ein Zugriffstoken über den Metadatenserver der Containerinstanz abrufen.
• JOB_NAME: der Name des Jobs, den Sie erstellen möchten.
• IMAGE_URL: Ein Verweis auf das Container-Image, z. B. us-docker.pkg.dev/cloudrun/container/job:latest.
• REGION: die Google Cloud Region des Jobs.
• PROJECT_ID: die Google Cloud Projekt-ID.