Worker-Pools verwalten

Auf dieser Seite wird beschrieben, wie Sie Informationen zu einem Worker-Pool aufrufen und Worker-Pools löschen.

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.

Worker-Pool erstellen

Cloud Run erstellt einen neuen Worker-Pool, wenn Sie zum ersten Mal ein Container-Image bereitstellen. Weitere Informationen finden Sie unter Neuen Worker-Pool bereitstellen.

Liste der Worker-Pools in Ihrem Projekt ansehen

Verwenden Sie die Google Cloud Console oder die Google Cloud CLI, um eine Liste der verfügbaren Worker-Pools in Ihrem Projekt aufzurufen:

Console

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

    Zu Cloud Run

  2. Wählen Sie im Menü Worker-Pools aus. Die verfügbaren Worker-Pools werden auf der Seite aufgeführt.

gcloud

So listen Sie die Worker-Pools in Ihrem Projekt auf:

gcloud beta run worker-pools list

Sie können diese Liste nach Attributen der Worker-Pool-Definition filtern, z. B. einem zugewiesenen Label.

Weitere Details zu einem Worker-Pool ansehen

Mit der Google Cloud Console, der Google Cloud CLI oder YAML können Sie weitere Details zu einem Worker-Pool aufrufen:

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 rufen Sie Details zu einem Worker-Pool auf: 

gcloud beta run worker-pools describe WORKER_POOL
 Ersetzen Sie 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 describe WORKER_POOL
    --region REGION
    --format yaml

Ersetzen Sie:

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

YAML

Wenn Sie Details zu einem Worker-Pool aufrufen möchten, laden Sie die zugehörige YAML-Konfiguration herunter:

gcloud beta run worker-pools describe WORKER_POOL --format export > workerpool.yaml

Vorhandenen Worker-Pool deaktivieren

Wenn Sie einen Worker-Pool deaktivieren, werden alle Instanzen für diesen Worker-Pool heruntergefahren. Wenn Sie einen Worker-Pool deaktivieren möchten, setzen Sie die Skalierung auf null:

Console

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

    Zu Cloud Run

  2. Wählen Sie im Menü Worker-Pools aus und klicken Sie dann in der Liste der Worker-Pools auf den Worker-Pool, den Sie deaktivieren möchten.

  3. Klicken Sie rechts neben Skalierung: Manuell (Instanzen: ) auf das Stiftsymbol und ändern Sie den Wert in „0“.

  4. Klicken Sie auf Speichern, um den Worker-Pool zu aktualisieren und zu deaktivieren.

gcloud 

gcloud beta run worker-pools update WORKER_POOL --scaling=0

Ersetzen Sie WORKER_POOL durch den Namen Ihres Worker-Pools.

YAML

  1. Wenn Sie einen neuen Worker-Pool erstellen, überspringen Sie diesen Schritt. Wenn Sie einen vorhandenen Worker-Pool aktualisieren, laden Sie die zugehörige YAML-Konfiguration herunter:

    gcloud beta run worker-pools describe WORKER_POOL --format export > workerpool.yaml

  2. Legen Sie für „scale“ den Wert 0 fest, um den Worker-Pool zu deaktivieren. Das folgende Beispiel enthält die YAML-Konfiguration:

    apiVersion: run.googleapis.com/v1
kind: WorkerPool
metadata:
  name: WORKER_POOL
  annotations:
    run.googleapis.com/launch-stage: BETA
    run.googleapis.com/scalingMode: manual
    run.googleapis.com/manualInstanceCount: `0`

    Ersetzen Sie Folgendes:

    • WORKER_POOL: Der Name Ihres Cloud Run-Worker-Pools.

  3. Erstellen oder aktualisieren Sie den Worker-Pool mit dem folgenden Befehl:

    gcloud beta run worker-pools replace workerpool.yaml

Vorhandene Worker-Pools löschen

Die folgenden Überlegungen gelten für das Löschen eines Worker-Pools:

  • Wenn Sie einen Worker-Pool löschen, werden alle damit verbundenen Ressourcen gelöscht. Dies gilt auch für alle Überarbeitungen des Worker-Pools, ungeachtet dessen, ob darüber Arbeitslasten verarbeitet werden.
  • Durch das Löschen eines Worker-Pools werden Container-Images nicht automatisch aus Artifact Registry entfernt. Informationen zum Löschen von Container-Images, die von den gelöschten Überarbeitungen aus Artifact Registry verwendet wurden, finden Sie unter Images löschen.
  • Nach dem Löschen eines Worker-Pools bleibt er in der Google Cloud CLI sichtbar, bis der Löschvorgang vollständig abgeschlossen ist. Sie können den Worker-Pool jedoch nicht aktualisieren.

  • Das Löschen eines Worker-Pools ist endgültig. Es gibt keine Möglichkeit, den Vorgang rückgängig zu machen oder die Daten wiederherzustellen.

Console

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

    Zu Cloud Run

  2. Wählen Sie im Menü Worker-Pools und dann in der Liste der Worker-Pools den Worker-Pool aus, den Sie löschen möchten.

  3. Klicken Sie auf Löschen.

gcloud

Verwenden Sie zum Löschen eines Worker-Pools den folgenden Befehl:

gcloud beta run worker-pools delete 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.