Worker-Pool-Versionen verwalten

Wenn Sie einen Worker-Pool bereitstellen oder die Konfiguration eines Worker-Pools ändern, erstellt Cloud Run eine unveränderliche Revision.

Die folgenden Überlegungen gelten für Überarbeitungen:

  • Sie müssen Überarbeitungen nicht manuell löschen, aber es ist möglich.
  • Inaktive Überarbeitungen verbrauchen keine Ressourcen und werden nicht in Rechnung gestellt.
  • Pro Worker-Pool 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

Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Cloud Run Developer (roles/run.developer) für Ihren Cloud Run-Workerpool zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Verwalten von Cloud Run-Workerpools und -Überarbeitungen 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-Workerpool mitGoogle 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 Worker-Pools abrufen

gcloud

So rufen Sie die Liste der Überarbeitungen für einen bestimmten Worker-Pool auf:

  1. Suchen Sie in der Liste der für Ihr Projekt verfügbaren Worker-Pools nach dem Namen des Worker-Pools:

    gcloud beta run worker-pools list

  2. Verwenden Sie den folgenden Befehl, um alle Überarbeitungen für diesen Worker-Pool abzurufen:

    gcloud beta run worker-pools revisions list
   --worker-pool=WORKER_POOL
   --region=REGION

    Ersetzen Sie:

    • Ersetzen Sie WORKER_POOL durch den Namen Ihres Worker-Pools.
    • REGION durch die Google Cloud Region des Worker-Pools.

Versionsdetails anzeigen

gcloud

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

  1. Suchen Sie in der Liste der für Ihr Projekt verfügbaren Worker-Pools nach dem Namen des Worker-Pools:

    gcloud beta run worker-pools list

  2. Verwenden Sie folgenden Befehl, um alle Überarbeitungen des Worker-Pools abzurufen, den Sie gerade aufgerufen haben: 

    gcloud beta run worker-pools revisions list
    --worker-pool=WORKER_POOL
    --region=REGION

    Ersetzen

    • Ersetzen Sie WORKER_POOL durch den Namen Ihres Worker-Pools.
    • REGION durch die Google Cloud Region des Worker-Pools.

  3. Verwenden Sie folgenden Befehl, um weitere Details zu einer bestimmten Überarbeitung abzurufen:

    gcloud beta run worker-pools revisions describe REVISION --region=REGION --worker-pool=WORKER_POOL

    Ersetzen

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

    Mit dem Flag --format können Sie die Ausgabe formatieren. Um die Ausgabe beispielsweise als YAML zu formatieren: 

    gcloud beta run worker-pools revisions describe REVISION
    --region=REGION
    --worker-pool=WORKER_POOL
    --format yaml

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.

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:

  • Die einzige Version des Worker-Pools.
  • Die aktuelle Version des Worker-Pools.

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

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

So löschen Sie eine Überarbeitung mit der Google Cloud CLI:

gcloud

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

gcloud beta run worker-pools revisions delete REVISION 
    --region=REGION
    --worker-pool=WORKER_POOL

Ersetzen

  • REVISION durch den Namen der Überarbeitung, die Sie löschen.
  • Ersetzen Sie WORKER_POOL durch den Namen Ihres Worker-Pools.
  • REGION durch die Google Cloud Region des Worker-Pools.

Nächste Schritte

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