Mit der manuellen Skalierung können Sie eine bestimmte Anzahl von Instanzen festlegen, ohne dass eine erneute Bereitstellung erforderlich ist. Verwenden Sie die manuelle Skalierung, wenn Ihre Arbeitslast eine feste Anzahl von Instanzen erfordert oder wenn Sie die Anzahl der Instanzen über Ihr eigenes System steuern möchten.
Wenn Sie Instanzen automatisch anhand der CPU-Auslastung skalieren möchten, anstatt eine feste Anzahl von Instanzen festzulegen, lesen Sie den Hilfeartikel CPU-Autoscaling für Worker-Pools konfigurieren.
Abrechnungsaspekte bei der Verwendung der manuellen Skalierung
Wenn Sie die manuelle Skalierung verwenden, werden alle von Ihnen angeforderten Instanzen als aktive Instanzen abgerechnet, auch wenn sie inaktiv sind. Ausführliche Informationen zur Abrechnung 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 Konfigurieren und Bereitstellen von Cloud Run-Worker-Pools benötigen:
- Cloud Run-Entwickler (
roles/run.developer) für den Cloud Run-Worker-Pool - Dienstkontonutzer (
roles/iam.serviceAccountUser) für die Dienstidentität
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-Worker-Pool 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 Version erstellt.
Verwenden Sie zum Konfigurieren des Skalierungsmodus die Google Cloud Console, die Google Cloud CLI, YAML, Terraform oder die REST API:
Console
Rufen Sie in der Google Cloud Console Cloud Run auf:
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 den Detailbereich aufzurufen, und dann oben rechts im Detailbereich auf das Stiftsymbol neben Skalierung.
Suchen Sie das Formular Skalierung (für einen neuen Worker-Pool) oder das Formular Skalierung bearbeiten für einen vorhandenen Worker-Pool.
Geben Sie im Feld Anzahl der Instanzen die Anzahl der Containerinstanzen für den Worker-Pool an.
Spezifikation fertigstellen
Klicken Sie für einen neuen Worker-Pool auf Erstellen oder für einen vorhandenen Worker-Pool auf Speichern.
gcloud
- Wenn Sie die manuelle Skalierung für einen neuen Worker-Pool angeben möchten, führen Sie den folgenden Befehl mit dem Flag
--scalingaus:
gcloud beta run worker-pools deploy WORKER_POOL \ --scaling=INSTANCE_COUNT \ --image IMAGE_URL
Ersetzen Sie Folgendes:
- WORKER_POOL: der Name des Worker-Pools.
- INSTANCE_COUNT: die Anzahl der Instanzen für den Worker-Pool.
Dadurch wird der Worker-Pool auf manuelle Skalierung festgelegt. Geben Sie den Wert
0an, 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.Wenn Sie die manuelle Skalierung für einen vorhandenen Worker-Pool festlegen möchten, führen Sie den folgenden Befehl mit dem Flag
--scalingaus:
gcloud beta run worker-pools update WORKER_POOL \ --scaling=INSTANCE_COUNT
Ersetzen Sie Folgendes:
- WORKER_POOL: der Name des Worker-Pools.
- INSTANCE_COUNT: die Anzahl der Instanzen für den Worker-Pool.
YAML
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 run worker-pools describe WORKER_POOL --format export > worker-pool.yaml
Legen Sie
scalingModeaufmanualfest und geben SiemanualInstanceCountan:apiVersion: run.googleapis.com/v1 kind: WorkerPool metadata: name: WORKER_POOL annotations: run.googleapis.com/scalingMode: manual run.googleapis.com/manualInstanceCount: "INSTANCE_COUNT"
Ersetzen Sie Folgendes:
- WORKER_POOL: Der Name Ihres Cloud Run-Worker-Pools.
- INSTANCE_COUNT: die Anzahl der Instanzen, die Sie manuell für den Worker-Pool skalieren. Geben Sie den Wert
0an, um den Worker-Pool zu deaktivieren.
Erstellen oder aktualisieren Sie den Worker-Pool mit dem folgenden Befehl:
gcloud run worker-pools replace worker-pool.yaml
Der Befehl
gcloud run worker-pools replaceverwendet standardmäßig die Dateiworker-pool.yaml, falls vorhanden.
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"
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 manuelle Skalierung festgelegt. Geben Sie den Wert
0an, um den Worker-Pool zu deaktivieren.
REST API
Wenn Sie die Anzahl der Instanzen für einen bestimmten Worker-Pool aktualisieren möchten, senden Sie eine PATCH-HTTP-Anfrage an den Endpunkt workerPools.patch der Cloud Run Admin API:
curl -H "Content-Type: application/json" \ -H "Authorization: Bearer ACCESS_TOKEN" \ -X PATCH \ -d '{"scaling":{"scalingMode":"MANUAL","manualInstanceCount":INSTANCE_COUNT}}' \ https://run.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/workerPools/WORKER_POOL?update_mask=scaling.scalingMode,scaling.manualInstanceCount
Ersetzen Sie Folgendes:
- ACCESS_TOKEN: ein gültiges Zugriffstoken für ein Konto, das die IAM-Berechtigungen zum Aktualisieren eines Worker-Pools hat.
Wenn Sie beispielsweise in
gcloudangemeldet sind, können Sie ein Zugriffstoken mitgcloud auth print-access-tokenabrufen. Innerhalb einer Cloud Run-Containerinstanz können Sie ein Zugriffstoken über den Metadatenserver der Containerinstanz abrufen. - INSTANCE_COUNT: die Anzahl der Instanzen für den Worker-Pool.
- PROJECT_ID: die Projekt-ID von Google Cloud .
- REGION: die Google Cloud -Region, in der der Worker-Pool bereitgestellt wird.
- WORKER_POOL: der Name des Worker-Pools.
Skalierungskonfiguration für einen Worker-Pool ansehen
Rufen Sie in der Google Cloud Console Cloud Run auf:
Klicken Sie auf Worker-Pools, um die Liste der bereitgestellten Worker-Pools aufzurufen.
Klicken Sie auf den Worker-Pool, den Sie prüfen möchten, um den Detailbereich aufzurufen.
Die aktuelle Skalierungseinstellung wird über der Liste der Worker-Pool-Versionen angezeigt: Skalierung: Manuell (Instanzen: ).
Worker-Pool deaktivieren
Führen Sie den folgenden Befehl mit dem Flag --scaling=0 aus, um einen Worker-Pool zu deaktivieren:
gcloud beta run worker-pools update WORKER_POOL --scaling=0
Ersetzen Sie WORKER_POOL durch den Namen Ihres Worker-Pools.