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

Console

  1. Rufen Sie in der Google Cloud Console Cloud Run auf:

    Zu Cloud Run

  2. Wählen Sie im Menü Worker-Pools aus, um die Liste der Worker-Pools aufzurufen.

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

Console

  1. Rufen Sie in der Google Cloud Console Cloud Run auf:

    Zu Cloud Run

  2. Wählen Sie im Menü Worker-Pools aus, um die verfügbaren Worker-Pools aufzurufen.

  3. Klicken Sie auf den Worker-Pool, um den zugehörigen Detailbereich aufzurufen.

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 dieses Worker-Pools abzurufen:

    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. So formatieren Sie die Ausgabe beispielsweise als YAML:

    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.

Verwenden Sie die Google Cloud Console oder die Google Cloud CLI, um eine Revision zu löschen:

Console

  1. Rufen Sie in der Google Cloud Console Cloud Run auf:

    Zu Cloud Run

  2. Wählen Sie im Menü Worker-Pools aus, um die verfügbaren Worker-Pools aufzurufen.

  3. Klicken Sie auf den Worker-Pool, um den zugehörigen Detailbereich aufzurufen.

  4. Klicken Sie auf Überarbeitungen.

  5. Wählen Sie die Überarbeitung aus, die Sie löschen möchten.

  6. Klicken Sie unter Aktionen auf das Dreipunkt-Menü und dann auf Löschen, um die Überarbeitung zu löschen.

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: