Überarbeitungen verwalten

Wenn Sie einen Dienst bereitstellen oder seine Konfiguration ändern, wird eine unveränderliche Überarbeitung erstellt.

Die folgenden Überlegungen gelten für Überarbeitungen:

Sie können angeben, ob eine neue Überarbeitung den gesamten, keinen oder einen Teil des Traffics erhält. Sie können eine neue Überarbeitung nach und nach einführen, den Traffic auf mehrere Überarbeitungen aufteilen und ein Rollback von einer Überarbeitung durchführen. Weitere Informationen finden Sie unter Rollbacks, schrittweise Rollouts und Traffic-Migration.
Optional können Sie Überarbeitungs-Tags verwenden, um eine Überarbeitung zu testen, die keinen Traffic verarbeitet.
Sie müssen Überarbeitungen nicht manuell löschen, aber es ist möglich.
Nicht-Bereitstellungsüberarbeitungen verbrauchen keine Ressourcen und werden nicht in Rechnung gestellt.
Pro Dienst sind maximal 1.000 Überarbeitungen möglich. Wenn Sie dieses Limit überschreiten, werden ältere Überarbeitungen automatisch gelöscht.
Das Überarbeitungssuffix wird automatisch zugewiesen. Wenn Sie ein eigenes Versionssuffix nutzen möchten, verwenden Sie den gcloud CLI-Parameter --revision-suffix.

Liste mit den Überarbeitungen eines Dienstes abrufen

Console

So zeigen Sie eine Liste der Überarbeitungen in Ihrem Projekt an:

Öffnen Sie Cloud Run.
Suchen Sie den Dienst in der Liste der Dienste und klicken Sie darauf.
Klicken Sie auf den Tab Überarbeitungen, um eine Liste der aktuellen Überarbeitungen für diesen Dienst aufzurufen.

Befehlszeile

So zeigen Sie eine Liste der Überarbeitungen für einen bestimmten Dienst an:

Suchen Sie in der Liste der für Ihr Projekt verfügbaren Dienste nach dem Dienstnamen:
```
gcloud run services list
```
Verwenden Sie folgenden Befehl, um alle Überarbeitungen dieses Dienstes abzurufen:
```
gcloud run revisions list --service SERVICE
```
Ersetzen Sie SERVICE durch den Namen Ihres Dienstes.

Cloud Code

Eine Liste der Überarbeitungen mit Cloud Code finden Sie in den Cloud Run Explorer-Leitfäden für IntelliJ und Visual Studio Code.

Clientbibliotheken

So zeigen Sie eine Liste der Code-Versionen an:

REST API

Senden Sie eine GET-HTTP-Anfrage an den Endpunkt revisions der Cloud Run Admin API, um die Liste der Überarbeitungen 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/services/SERVICE-NAME/revisions

Ersetzen Sie:

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

Versionsdetails anzeigen

Console

So zeigen Sie Details einer Überarbeitung in Ihrem Projekt an:

Öffnen Sie Cloud Run.
Wählen Sie Ihren Dienst in der Liste der Dienste aus.
Klicken Sie auf den Tab Überarbeitungen, um eine Liste der aktuellen Überarbeitungen für diesen Dienst aufzurufen.
Wählen Sie die Überarbeitung aus, an der Sie interessiert sind.
Suchen Sie die im Feld DETAILS ganz rechts nach überarbeitungsspezifischen Informationen wie die URL des bereitgestellten Container-Images, die Menge des zugewiesenen Speichers, Umgebungsvariablen und unter Umständen Build- und Quell-Repository-Informationen.

Befehlszeile

So zeigen Sie Details einer Überarbeitung in Ihrem Projekt an:

Suchen Sie in der Liste der für Ihr Projekt verfügbaren Dienste nach dem Dienstnamen:
```
gcloud run services list
```
Verwenden Sie folgenden Befehl, um alle Überarbeitungen dieses Dienstes abzurufen:
```
gcloud run revisions list --service SERVICE
```
Ersetzen Sie SERVICE durch den Namen des Dienstes.
Verwenden Sie folgenden Befehl, um weitere Details zu einer bestimmten Überarbeitung abzurufen:
```
gcloud run revisions describe REVISION
```
Ersetzen Sie REVISION durch den Namen der Überarbeitung, über die Sie mehr erfahren möchten.

Mit dem Flag --format können Sie die Ausgabe formatieren. Zum Beispiel als YAML:
```
gcloud run revisions describe REVISION --format yaml
```

Cloud Code

Eine Liste der Überarbeitungen mit Cloud Code finden Sie in den Cloud Run Explorer-Leitfäden für IntelliJ und Visual Studio Code.

Clientbibliotheken

So zeigen Sie die Details einer Code-Version an:

REST API

Wenn Sie Details zu einer Überarbeitung aufrufen möchten, senden Sie eine HTTP-Anfrage GET an den Endpunkt revisions 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/services/SERVICE-NAME/revisions/REVISION-NAME

Ersetzen Sie:

ACCESS_TOKEN durch ein gültiges Zugriffstoken für ein Konto, das die IAM-Berechtigungen zum Aufrufen von Dienstdetails 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.
SERVICE-NAME durch den Namen des Dienstes.
REVISION-NAME durch den Namen der Überarbeitung.
REGION durch die Google Cloud-Region des Dienstes.
PROJECT-ID durch die Google Cloud-Projekt-ID.

Für eine nicht aktuelle Überarbeitung wird möglicherweise der Status RETIRED angezeigt. Das bedeutet, dass Cloud Run die für diese Überarbeitung benötigte Infrastruktur deaktiviert hat.

Über Build- und Quell-Repository-Informationen im Feld Details

Wenn die Artifact Analysis API aktiviert ist und der Container mit Cloud Build erstellt wurde, werden die Build-Informationen im Feld Details angezeigt.

Wenn außerdem ein Cloud Build-Trigger zum Erstellen des Containers verwendet wurde, werden die Informationen zum Quell-Repository auch im Feld Details angezeigt.

Versionen löschen

Ein häufiger Anwendungsfall für das Löschen einer Überarbeitung ist, wenn eine bestimmte Überarbeitung nicht versehentlich verwendet werden soll.

In folgenden Fällen können Sie eine Überarbeitung nicht löschen:

Sie kann Traffic erhalten
Sie ist die einzige Überarbeitung des Dienstes
Sie ist die neueste Überarbeitung des Dienstes

Beim Löschen einer Überarbeitung wird das von ihr verwendete Container-Image nicht automatisch aus Container Registry oder Artifact Registry gelöscht. Informationen zum Löschen eines Container-Images aus einer Registry finden Sie in der Anleitung zum Löschen für Container Registry oder Artifact Registry.

Das Löschen einer Überarbeitung kann nicht rückgängig gemacht werden.

Sie können entweder die Konsole oder die Befehlszeile verwenden:

Console

So löschen Sie eine Überarbeitung:

Öffnen Sie Cloud Run.
Suchen Sie den Dienst in der Liste der Dienste und klicken Sie darauf.
Klicken Sie auf den Tab Überarbeitungen, um eine Liste der aktuellen Überarbeitungen für diesen Dienst aufzurufen.
Suchen Sie die Dienstüberarbeitung, die Sie löschen möchten.
Klicken Sie links neben der Überarbeitung auf das Dreipunkt-Menü, um das Menü Löschen aufzurufen.
Klicken Sie auf Löschen, um die Überarbeitung zu löschen.

Befehlszeile

Löschen Sie eine Überarbeitung mit dem folgenden Befehl:

gcloud run revisions delete REVISION

Ersetzen Sie REVISION durch den Namen der Überarbeitung, die Sie löschen möchten.

Clientbibliotheken

So löschen Sie eine Code-Version:

REST API

Senden Sie zum Löschen einer Überarbeitung eine DELETE-HTTP-Anfrage an den Endpunkt revisions 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/services/SERVICE-NAME/revisions/REVISION-NAME

Ersetzen Sie:

ACCESS_TOKEN durch ein gültiges Zugriffstoken für ein Konto, das die IAM-Berechtigungen zum Löschen eines Dienstes 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.
SERVICE-NAME durch den Namen des Dienstes.
REVISION-NAME durch den Namen der Überarbeitung.
REGION durch die Google Cloud-Region des Dienstes.
PROJECT-ID durch die Google Cloud-Projekt-ID.

Nächste Schritte

Nach der Bereitstellung einer Überarbeitung haben Sie folgende Möglichkeit: