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.

Container-Image-Digest und -Tags für Cloud Run-Jobs

Wie Sie Ihren Job zur Ausführung der neuesten Version des Codes aktualisieren, hängt davon ab, ob Sie ein Container-Image mit einem Tag oder einem Digest angegeben haben.

Wenn Sie einen Job erstellen, können Sie ein Container-Image mit einem Tag wie gcr.io/my-project/my-image:tag oder mit einem genauen Digest wie gcr.io/my-project/my-image@sha256:41f34ab970ee... angeben. Wenn Sie keines von beiden angeben, wird das Tag :latest verwendet.

Wenn Sie ein Container-Image mit einem Tag angegeben haben, löst Cloud Run das Image bei der Ausführung des Jobs in einen bestimmten Digest auf. Dies bedeutet, dass Sie Ihren Job nicht explizit aktualisieren müssen, um bei der nächsten Ausführung Ihres Jobs die neueste Version Ihres Containers zu übernehmen.

Wenn Sie möchten, dass Ihr Job bei jeder Ausführung einen bestimmten Container-Digest verwendet, können Sie ein Container-Image mit einem genauen Digest angeben. In diesem Fall müssen Sie den Job explizit so aktualisieren, dass ein anderer Digest verwendet wird, wenn der Job Codeänderungen übernehmen soll:

gcloud run jobs update JOB_NAME --image IMAGE_URL

Ersetzen

JOB_NAME durch einen Kleinbuchstaben ohne Unterstriche
IMAGE_URL durch einen Verweis auf das Container-Image, z. B. us-docker.pkg.dev/cloudrun/container/job:latest.

Unabhängig davon, wie Sie Ihr Container-Image angeben, verwenden alle Aufgaben einer Ausführung immer denselben Container-Image-Digest.

Jobs im Projekt aufrufen

Sie können eine Liste der Jobs in Ihrem Projekt über die gcloud-Befehlszeile aufrufen:

Console

So rufen Sie Jobs auf:

Zur Seite „Cloud Run-Jobs“
Optional können Sie den Job nach einem der Kriterien im Drop-down-Menü filtern, z. B. Jobname, Ausführungszeit, Region usw.

Befehlszeile

Alle Jobs in Ihrem Projekt auflisten:
```
gcloud run jobs list
```
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:

Zur Seite „Cloud Run“
Suchen Sie den gewünschten Job.
Klicken Sie auf den gewünschten Job, um die Seite mit den Jobdetails aufzurufen.
Beachten Sie die Tabs Verlauf, Konfiguration, Logs und YAML.
- Unter dem Tab Verlauf finden Sie Informationen zu den Aufgaben in der Jobausführung.
- Logs zeigt die Loginformationen an.
- 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.

Befehlszeile

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:

Zur Seite „Cloud Run“
Wählen Sie den Job aus.
Klicken Sie auf Löschen.

Befehlszeile

So löschen Sie einen Job:

Führen Sie den Befehl aus:
```
gcloud run jobs delete JOB_NAME
```
Ersetzen Sie JOB_NAME durch den Namen des Jobs.
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.