Jobausführungen verwalten

Auf dieser Seite wird beschrieben, wie Sie Jobausführungen anzeigen und löschen. Informationen zum Ausführen, Abbrechen oder Überschreiben einer Jobkonfiguration 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.

Jobausführungen in Ihrem Projekt ansehen

Sie können eine Liste der Jobausführungen in Ihrem Projekt mit der Google Cloud Console oder der Google Cloud CLI aufrufen:

Console

So zeigen Sie die Liste der Ausführungen für einen Job an:

  1. Zur Seite „Cloud Run“

  2. Suchen Sie den Job in der Liste, dessen Ausführungen Sie verwalten möchten.

  3. Klicken Sie auf den Job, um die Liste der Ausführungen aufzurufen.

  4. Suchen Sie auf der Seite mit den Ausführungsdetails in der Liste nach der Ausführung, die Sie interessiert. Optional können Sie den Filter auf ein gewünschtes Kriterium einstellen, z. B. Status mit dem Wert completed:

gcloud

So listen Sie alle Jobausführungen für alle Jobs in Ihrem Projekt auf:

gcloud run jobs executions list

So listen Sie nur die Ausführungen für einen bestimmten Job auf:

gcloud run jobs executions list --job JOB_NAME

Ersetzen Sie JOB_NAME durch den Namen des Jobs, nach dem Sie filtern.

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

Mit dem Flag --format können Sie den Namen der letzten Ausführung für einen bestimmten Job abrufen:

gcloud run jobs describe JOB_NAME --format="value(status.latestCreatedExecution.name)"

Ersetzen Sie JOB_NAME durch den Namen des Jobs, nach dem Sie filtern.

Clientbibliotheken

So listen Sie alle Jobausführungen aus Code auf:

REST API

Senden Sie zum Auflisten von Jobausführungen 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/executions

Ersetzen Sie:

  • ACCESS_TOKEN durch ein gültiges Zugriffstoken für ein Konto, das die IAM-Berechtigungen zum Aufrufen von Jobausführungen 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.

Details zur Jobausführung aufrufen

Mit dem Bereich "Ausführungsdetails" können Sie Details zur Jobausführung für die letzten 10000 Ausführungen eines Jobs aufrufen sowie alle Ausführungen, die in den letzten sieben Tagen aufgetreten sind. Ältere Ausführungsdetails werden entfernt und sind nicht mehr im Bereich der Ausführungsdetails sichtbar. Die Logs- und Monitoring-Daten für ältere Ausführungen sind jedoch weiterhin in Cloud Logging und Cloud Monitoring verfügbar, unterliegen den Aufbewahrungsrichtlinien für diese Produkte.

Mit der Google Cloud Console oder der Google Cloud-CLI können Sie weitere Details zu einer Jobausführung aufrufen.

Console

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

  1. Zur Seite „Cloud Run“

  2. Suchen Sie die gewünschte Jobausführung.

  3. Klicken Sie auf die Jobausführung, um die Seite mit den Ausführungsdetails aufzurufen.

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

    • Aufgaben zeigt Informationen zu den Aufgaben der Jobausführung an.
    • Logs zeigt die Logs an, die sich auf die Ausführung beziehen.
    • Unter Konfiguration werden Informationen zum Job, zum Container, zur Sicherheit, zur Konnektivität usw. angezeigt, die bei der Ausführung verwendet wurden.
    • YAML zeigt die Konfiguration des Jobs im YAML-Format an.

gcloud

So rufen Sie Details zu einer Jobausführung auf:

Führen Sie den Befehl aus:

gcloud run jobs executions describe EXECUTION_NAME

Ersetzen Sie EXECUTION_NAME durch den Namen der Ausführung.

Mit dem Flag --format können Sie die Ausgabe formatieren und zusätzliche Informationen abrufen. Zum Beispiel als YAML:

gcloud run jobs executions describe EXECUTION_NAME --format yaml

Clientbibliotheken

So rufen Sie Details zur Jobausführung aus Code auf:

REST API

Senden Sie eine GET-HTTP-Anfrage an den Endpunkt jobs der Cloud Run Admin API, um Details zur Jobausführung 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/JOB-NAME/executions/EXECUTION-NAME

Ersetzen Sie:

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

Jobausführung löschen

Sie können eine Jobausführung auch während einer Ausführung löschen. Wenn Sie eine Ausführung löschen, wird die Ausführung beendet.

Obwohl eine gelöschte Ausführung nicht in der Liste der Ausführungen angezeigt wird, sind ihre Logs für den Rest der Logaufbewahrungsdauer und die Monitoring-Daten weiterhin in Cloud Logging und in Cloud Monitoring verfügbar.

Console

So löschen Sie eine Jobausführung:

  1. Zur Seite „Cloud Run“

  2. Suchen Sie die Jobausführung, die Sie löschen möchten.

  3. Klicken Sie auf Löschen.

  4. Wenn Sie aufgefordert werden, das Löschen zu bestätigen, klicken Sie auf Bestätigen.

gcloud

So löschen Sie eine Jobausführung:

  1. Führen Sie den Befehl aus:

    gcloud run jobs executions delete EXECUTION_NAME

    Ersetzen Sie EXECUTION_NAME durch den Namen der Ausführung.

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

Clientbibliotheken

So löschen Sie eine Jobausführung aus Code:

REST API

Senden Sie zum Löschen einer Jobausführung 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/executions/EXECUTION-NAME

Ersetzen Sie:

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