Auf dieser Seite wird beschrieben, wie Sie Cloud Run-Jobs mit einem Cloud Scheduler nach einem Zeitplan ausführen.
Erforderliche Rollen
Bitten Sie Ihren Administrator, Ihnen die IAM-Rollen für Ihren Cloud Run-Job zuzuweisen, um die Berechtigungen zu erhalten, die Sie für die auf dieser Seite beschriebenen Vorgänge benötigen:
- Cloud Scheduler-Administrator (
roles/cloudscheduler.admin) oder eine benutzerdefinierte Rolle mit der Berechtigungcloudscheduler.jobs.create. - Cloud Run-Invoker (
roles/run.invoker), um Jobs mithilfe der Google Cloud CLI auszuführen, oder Cloud Run-Entwickler (roles/run.developer), um Jobs mit der Google Cloud Console auszuführen.
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.
Hinweis
- Erstellen Sie einen Cloud Run-Job, falls Sie noch keinen erstellt haben.
Aktivieren Sie die Cloud Scheduler API für Ihr Projekt:
gcloud services enable cloudscheduler.googleapis.com
Cloud Run-Job für die zeitgesteuerte Ausführung konfigurieren
Sie können einen Cloud Run-Job so konfigurieren, dass er nach einem Zeitplan ausgeführt wird. Verwenden Sie dazu dieGoogle Cloud Console, die gcloud CLI oder Terraform:
Console
Wechseln Sie in der Google Cloud Console zur Seite „Cloud Run-Jobs“:
Klicken Sie auf den Job, den Sie nach einem Zeitplan ausführen möchten.
Klicken Sie auf den Tab Trigger.
Klicken Sie auf Planer-Trigger hinzufügen.
Führen Sie im Cloud Scheduler-Jobformular die folgenden Schritte aus:
Geben Sie unter Name einen Namen für den Cloud Scheduler-Job ein.
Wählen Sie unter Region eine Region für Ihren Cloud Scheduler-Job aus. Es muss nicht mit der Region übereinstimmen, die für den Cloud Run-Job verwendet wird.
Geben Sie die Häufigkeit der Ausführung des Jobs im Format unix-cron an, z. B.
0 12 * * *.Wählen Sie Ihre Zeitzone aus.
Klicken Sie auf Weiter.
Wählen Sie im Abschnitt Ausführung konfigurieren das Dienstkonto aus, das die Berechtigung zum Aufrufen des aktuellen Cloud Run-Jobs hat.
Klicken Sie auf Erstellen, um den Cloud Scheduler-Job zu erstellen, der den Cloud Run-Job dann mit der angegebenen Häufigkeit ausführt.
gcloud
Führen Sie dazu diesen Befehl aus:
gcloud scheduler jobs create http SCHEDULER_JOB_NAME \
--location SCHEDULER_REGION \
--schedule="SCHEDULE" \
--uri="https://run.googleapis.com/v2/projects/PROJECT_ID/locations/CLOUD_RUN_REGION/jobs/JOB:run" \
--http-method POST \
--oauth-service-account-email PROJECT_NUMBER-compute@
Ersetzen Sie Folgendes:
SCHEDULER_JOB_NAME: der Name, den Sie dem Planerjob geben möchten.SCHEDULER_REGION: eine von Cloud Scheduler unterstützte Region, z. B.europe-west2.SCHEDULE: die erforderliche Häufigkeit, z. B.0 12 * * *.PROJECT_ID: Ihre Projekt-ID.CLOUD_RUN_REGION: Die Region für Ihren Cloud Run-Job. Beispiel:europe-west1.JOB: Der Name Ihres Cloud Run-Jobs.PROJECT_NUMBER: Ihre Projektnummer.
Terraform
Informationen zum Anwenden oder Entfernen einer Terraform-Konfiguration finden Sie unter Grundlegende Terraform-Befehle.
Fügen Sie einergoogle_cloud_run_v2_job-Ressource in Ihrer Terraform-Konfiguration Folgendes hinzu:Cloud Scheduler führt den Cloud Run-Job dann mit der angegebenen Häufigkeit aus. Informationen dazu, wie Sie doppelte Jobausführungen verhindern, wenn Cloud Scheduler eine Anfrage wiederholt, finden Sie unter Doppelte Anfragen an Google Cloud -API-Ziele verhindern.
Job innerhalb eines VPC Service Controls-Perimeters planen
Wenn sich Ihr Google Cloud -Projekt innerhalb eines VPC Service Controls-Perimeters in einem Virtual Private Cloud-Netzwerk befindet, unterstützt die Cloud Scheduler-Integration in VPC Service Controls Cloud Run-Jobs als Ziel im folgenden URI-Format:
https://run.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/jobs/JOB:run
Ersetzen Sie Folgendes:
PROJECT_ID: die Projekt-ID von Google Cloud .REGION: die Google Cloud -Region des Jobs.JOB: Der Name Ihres Cloud Run-Jobs.
Weitere Informationen zum Konfigurieren von VPC Service Controls für Cloud Run finden Sie unter VPC Service Controls (VPC SC) verwenden. Weitere Informationen zur Verwendung von Cloud Scheduler mit VPC Service Controls finden Sie unter Cronjobs mit VPC Service Controls sichern.
Nächste Schritte
Nachdem Sie dieses Feature verwendet haben, können Sie Folgendes tun: