Ü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, und außerdem 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 Trafficmigration.
  • 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.

Erforderliche Rollen

Um die Berechtigungen zu erhalten, die Sie für die Verwaltung von Cloud Run-Diensten und -Überarbeitungen benötigen, bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Cloud Run Developer (roles/run.developer) für Ihren Cloud Run-Dienst zu gewä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 Service 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.

Liste mit den Versionen eines Dienstes abrufen

Console

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

  1. Öffnen Sie Cloud Run.

  2. Suchen Sie den Dienst in der Liste der Dienste und klicken Sie darauf.

  3. Klicken Sie auf den Tab Überarbeitungen, um eine Liste der aktuellen Überarbeitungen für diesen Dienst aufzurufen.

    Überarbeitungsliste

Befehlszeile

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

  1. Suchen Sie in der Liste der für Ihr Projekt verfügbaren Dienste nach dem Dienstnamen:

    gcloud run services list

  2. Verwenden Sie folgenden Befehl, um alle Überarbeitungen dieses Dienstes abzurufen:

    gcloud run revisions list --service SERVICE --region REGION

    Ersetzen

    • SERVICE durch den Namen des Dienstes.
    • REGION durch die Google Cloud-Region des 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:

  1. Öffnen Sie Cloud Run.

  2. Wählen Sie Ihren Dienst in der Liste der Dienste aus.

  3. Klicken Sie auf den Tab Überarbeitungen, um eine Liste der aktuellen Überarbeitungen für diesen Dienst aufzurufen.

  4. Wählen Sie die Überarbeitung aus, an der Sie interessiert sind.

  5. 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.

    Bild

Befehlszeile

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

  1. Suchen Sie in der Liste der für Ihr Projekt verfügbaren Dienste nach dem Dienstnamen:

    gcloud run services list

  2. Verwenden Sie folgenden Befehl, um alle Überarbeitungen dieses Dienstes abzurufen: 

    gcloud run revisions list --service SERVICE --region REGION

    Ersetzen

    • SERVICE durch den Namen des Dienstes.
    • REGION durch die Google Cloud-Region des Dienstes.

  3. Verwenden Sie den folgenden Befehl, um weitere Details zu einer bestimmten Version aufzurufen: 

    gcloud run revisions describe REVISION --region REGION
    Ersetzen Sie

    • REVISION durch den Namen der Überarbeitung, über die Sie mehr erfahren möchten.
    • REGION durch die Google Cloud-Region des Dienstes.

    Mit dem Flag --format können Sie die Ausgabe formatieren. Zum Beispiel als YAML: 

    gcloud run revisions describe REVISION --region REGION --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:

  1. Öffnen Sie Cloud Run.

  2. Suchen Sie den Dienst in der Liste der Dienste und klicken Sie darauf.

  3. Klicken Sie auf den Tab Überarbeitungen, um eine Liste der aktuellen Überarbeitungen für diesen Dienst aufzurufen.

  4. Suchen Sie die Dienstüberarbeitung, die Sie löschen möchten.

  5. Klicken Sie links neben der Überarbeitung auf das Dreipunkt-Menü, um das Menü Löschen aufzurufen.

    revision-delete

  6. 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 --region REGION

Ersetzen

  • REVISION ist der Name der Version, die Sie löschen möchten.
  • REGION durch die Google Cloud-Region des Dienstes.

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: