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