Manuelle Skalierung für Worker-Pools

Auf dieser Seite wird beschrieben, wie Sie Ihren Worker-Pool manuell skalieren.

Übersicht

Bei der manuellen Skalierung können Sie eine bestimmte Anzahl von Instanzen festlegen, ohne dass eine erneute Bereitstellung erforderlich ist. So haben Sie die Möglichkeit, Ihre eigene Skalierungslogik mit einem externen System zu schreiben. Ein Beispiel hierfür finden Sie unter Kafka Autoscaler.

Abrechnung bei Verwendung der manuellen Skalierung

Wenn Sie die manuelle Skalierung verwenden, werden alle von Ihnen angeforderten Instanzen als aktive Instanzen abgerechnet, auch wenn sie sich im Leerlauf befinden. Vollständige Abrechnungsdetails finden Sie auf der Preisseite.

Erforderliche Rollen

Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Bereitstellen von Cloud Run-Worker-Pools 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.

Skalierung konfigurieren

Wenn Sie den Skalierungsmodus oder die Anzahl der manuellen Instanzen ändern, wird keine neue Revision erstellt.

Verwenden Sie die Google Cloud Console oder die Google Cloud CLI, um den Skalierungsmodus zu konfigurieren:

Konsole

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

    Zu Cloud Run

  2. Wenn Sie einen neuen Worker-Pool konfigurieren, wählen Sie im Menü Worker-Pools aus und klicken Sie auf Container bereitstellen. Wenn Sie einen vorhandenen Worker-Pool konfigurieren, klicken Sie auf den Worker-Pool, um das Detailfeld aufzurufen, und dann oben rechts im Detailfeld auf das Stiftsymbol neben Skalierung.

  3. Suchen Sie das Formular Skalierung (für einen neuen Worker-Pool) oder das Formular Skalierung bearbeiten für einen vorhandenen Worker-Pool.

    Image

  4. Geben Sie im Feld Anzahl der Instanzen die Anzahl der Containerinstanzen für den Dienst an.

  5. Schließen Sie die Spezifikation ab.

  6. Klicken Sie auf Erstellen, um einen neuen Worker-Pool zu erstellen, oder auf Speichern, um einen vorhandenen Worker-Pool zu speichern.

gcloud

Verwenden Sie den Befehl deploy, um die Skalierung für einen neuen Worker-Pool anzugeben:

gcloud beta run worker-pools deploy WORKER_POOL \
    --scaling=INSTANCE_COUNT \
    --image IMAGE_URL

Ersetzen Sie Folgendes:

  • WORKER_POOL: Der Name Ihres Worker-Pools.
  • INSTANCE_COUNT: Die Anzahl der Instanzen für den Worker-Pool. Dadurch wird der Worker-Pool auf die manuelle Skalierung festgelegt. Geben Sie den Wert 0 an, um den Worker-Pool zu deaktivieren.
  • IMAGE_URL: Ein Verweis auf das Container-Image, das den Worker-Pool enthält, z. B. us-docker.pkg.dev/cloudrun/container/worker-pool:latest.

Mit dem folgenden update-Befehl können Sie die Skalierung für einen vorhandenen Worker-Pool angeben:

gcloud beta run worker-pools update WORKER_POOL \
   --scaling=INSTANCE_COUNT

Terraform

Informationen zum Anwenden oder Entfernen einer Terraform-Konfiguration finden Sie unter Grundlegende Terraform-Befehle.

resource "google_cloud_run_v2_worker_pool" "default" {
  name     = "WORKER_POOL"
  location = "REGION"
  launch_stage = "BETA"

  template {
    containers {
      image = "IMAGE_URL"
    }
  }
  scaling {
    scaling_mode = "MANUAL"
    manual_instance_count = "INSTANCE_COUNT"
  }
}

Ersetzen Sie Folgendes:

  • WORKER_POOL: der Name des Worker-Pools.
  • REGION: die Google Cloud Region, z. B. europe-west1.
  • IMAGE_URL: Ein Verweis auf das Container-Image, das den Worker-Pool enthält, z. B. us-docker.pkg.dev/cloudrun/container/worker-pool:latest.
  • INSTANCE_COUNT: Die Anzahl der Instanzen für den Worker-Pool. Dadurch wird der Worker-Pool auf die manuelle Skalierung festgelegt. Geben Sie den Wert 0 an, um den Worker-Pool zu deaktivieren.

Skalierungskonfiguration für einen Worker-Pool ansehen

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

    Zu Cloud Run

  2. Klicken Sie auf Worker-Pools, um die Liste der bereitgestellten Worker-Pools aufzurufen.

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

  4. Die aktuelle Skalierungseinstellung wird über der Revisionsliste für Worker-Pools angezeigt: Skalierung: Manuell (Instanzen: ).

Worker-Pool deaktivieren

Verwenden Sie den folgenden Befehl, um einen Worker-Pool zu deaktivieren und die Skalierung auf null zu setzen:

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

Ersetzen Sie WORKER_POOL durch den Namen Ihres Worker-Pools.