Jobs verwalten

Auf dieser Seite wird beschrieben, wie Sie Jobs verwalten. Informationen zum Erstellen eines Jobs finden Sie unter Jobs erstellen. Informationen zum Ausführen eines Jobs finden Sie unter Jobs ausführen.

Erforderliche Rollen

Bitten Sie Ihren Administrator, Ihnen den IAM-Rolle Cloud Run-Entwickler (roles/run.developer) für Ihren Cloud Run-Job zu gewähren, um die Berechtigungen zu erhalten, die Sie zum Verwalten 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 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.

Jobs im Projekt aufrufen

Mit einer der folgenden Ansätze können Sie eine Liste der Jobs in Ihrem Projekt aufrufen:

Console

So rufen Sie Jobs auf:

  1. Zur Seite „Cloud Run-Jobs“

  2. Optional können Sie den Job nach einem der Kriterien im Drop-down-Menü filtern, z. B. Jobname, Ausführungszeit, Region usw.

gcloud

  1. Alle Jobs in Ihrem Projekt auflisten:

    gcloud run jobs list
  2. So filtern Sie Jobs nach Region:

    gcloud run jobs list --region REGION

    Ersetzen Sie REGION durch den Namen der Region, nach der Sie filtern, z. B. us-central1.

Weitere Möglichkeiten zum Verfeinern der zurückgegebenen Liste, einschließlich der Verwendung von Filtern, finden Sie unter Jobliste.

Clientbibliotheken

So rufen Sie Jobs in Ihrem Projekt aus Code auf:

REST API

Senden Sie eine GET-HTTP-Anfrage an den Endpunkt jobs der Cloud Run Admin API, um die Liste der Jobs in Ihrem Projekt aufzurufen.

Verwenden Sie zum Beispiel curl:

curl -H "Content-Type: application/json" \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -X GET \
  -d '' \
  https://run.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/jobs

Ersetzen Sie:

  • ACCESS_TOKEN durch ein gültiges Zugriffstoken für ein Konto, das die IAM-Berechtigungen zum Aufrufen 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.
  • REGION durch die Google Cloud-Region des Jobs.
  • PROJECT-ID durch die Google Cloud-Projekt-ID.

Auftragsdetails aufrufen

Verwenden Sie die gcloud-Befehlszeile, um weitere Details zu einem Job aufzurufen.

Console

So rufen Sie Details zu einer bestimmten Jobausführung auf:

  1. Zur Seite „Cloud Run“

  2. Suchen Sie den gewünschten Job.

  3. Klicken Sie auf den gewünschten Job, um die Seite mit den Jobdetails aufzurufen.

  4. Beachten Sie die Tabs Verlauf, Konfiguration, Logs und YAML.

    • Unter dem Tab Verlauf finden Sie Informationen zu den Aufgaben in der Jobausführung.
    • Unter Logs werden die Loginformationen angezeigt.
    • Unter Konfiguration werden Informationen zum Job, zum Container, zur Sicherheit, zur Konnektivität usw. angezeigt.
    • YAML zeigt die Konfiguration des Jobs im YAML-Format an.

gcloud

So rufen Sie Details zu einem Job auf:

Führen Sie den Befehl aus:

gcloud run jobs describe  JOB_NAME

Ersetzen Sie JOB_NAME durch den Namen des Jobs.

Clientbibliotheken

So rufen Sie Details zu einem Job aus Code auf:

REST API

Wenn Sie Details zu einem Job aufrufen möchten, senden Sie eine GET-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 GET \
  -d '' \
  https://run.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/jobs/JOB-NAME

Ersetzen Sie:

  • ACCESS_TOKEN durch ein gültiges Zugriffstoken für ein Konto, das die IAM-Berechtigungen zum Aufrufen von Jobdetails 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 durch den Namen des Jobs.
  • REGION durch die Google Cloud-Region des Jobs.
  • PROJECT-ID durch die Google Cloud-Projekt-ID.

Job löschen

Sie können einen Job nur löschen, wenn er derzeit nicht ausgeführt wird.

Obwohl ein gelöschter Job nicht mehr in der Liste der Jobs angezeigt wird, sind seine Logs für den Rest der Logaufbewahrungsdauer und die Monitoring-Daten weiterhin in Cloud Logging verfügbar ist weiterhin in Cloud Monitoring verfügbar.

Console

So löschen Sie einen Job:

  1. Zur Seite „Cloud Run“

  2. Wählen Sie den Job aus.

  3. Klicken Sie auf Löschen.

gcloud

So löschen Sie einen Job:

  1. Führen Sie den Befehl aus:

    gcloud run jobs delete JOB_NAME

    Ersetzen Sie JOB_NAME durch den Namen des Jobs.

  2. Wenn Sie zur Bestätigung aufgefordert werden, antworten Sie mit y. Bei Erfolg wird eine Erfolgsmeldung angezeigt.

Clientbibliotheken

So löschen Sie einen Job aus Code:

REST API

Um einen Job zu löschen, senden Sie eine DELETE-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 DELETE \
  -d '' \
  https://run.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/jobs/JOB-NAME

Ersetzen Sie:

  • ACCESS_TOKEN durch ein gültiges Zugriffstoken für ein Konto, das die IAM-Berechtigungen zum Löschen 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 durch den Namen des Jobs.
  • REGION durch die Google Cloud-Region des Jobs.
  • PROJECT-ID durch die Google Cloud-Projekt-ID.