CPU-Limits für Worker-Pools konfigurieren

Auf dieser Seite wird beschrieben, wie Sie die Anzahl der zu verwendenden vCPUs für jede Cloud Run-Instanz angeben. Cloud Run-Containerinstanzen sind standardmäßig auf eine vCPU beschränkt. Sie können diesen Wert wie auf dieser Seite beschrieben erhöhen oder verringern.

vCPU-Limits festlegen und aktualisieren

Standardmäßig ist jede Instanz auf eine vCPU beschränkt. Sie können diesen Wert in einen der Werte in der folgenden Tabelle ändern.

Tabelle für vCPUs und Arbeitsspeicher

Im Folgenden sind die Arbeitsspeicheranforderungen für vCPUs aufgeführt:

CPUs	Erforderlicher Arbeitsspeicher
1 vCPU	128 MiB bis 4 GiB
2 vCPU	128 MiB bis 8 GiB
4 vCPU	2 bis 16 GiB
6 vCPU	4 bis 24 GiB
8 vCPU	4 bis 32 GiB

Werte über 1 müssen Ganzzahlen sein.

Maximale Anzahl von vCPUs

Die maximale Anzahl von vCPUs, die Sie konfigurieren können, beträgt 8 vCPUs.

Minimale Anzahl von vCPUs

Die minimale vCPU-Einstellung beträgt 1 vCPU.

Kostengesichtspunkte

Die Kosten für Ihre Cloud Run-Ressource werden unter anderem durch die CPU-Konfiguration und die Dauer der Aktivität der Ressource beeinflusst. Wenn Sie Ihre Ressourcen überdimensionieren, können sich Ihre Kosten erhöhen. So ermitteln Sie, welche CPU-Konfiguration für Ihre Ressource am besten geeignet ist:

Legen Sie eine anfängliche Baseline-Konfiguration für ein CPU-Limit fest, das die CPU-Auslastung und die Kosten ausgleicht.
Behalten Sie die Messwerte zur CPU-Auslastung in Cloud Monitoring im Blick, während Sie das System unter Last testen.
Passen Sie die CPU-Konfiguration nach Bedarf an.

Wenn die CPU-Auslastung unter Spitzenlast konstant niedrig ist, sollten Sie die vCPU-Zuordnung reduzieren. Wenn die Latenz hoch ist, sollten Sie die vCPU-Zuordnung erhöhen.

Auf der Seite Cloud Hub-Optimierung finden Sie zusammenfassende Kostendaten, Auslastungsdaten und Empfehlungen zur Kostenoptimierung für Dienste. Weitere Informationen finden Sie unter Cloud Run-Preise oder schätzen Sie die Kosten mit dem Preisrechner.

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 mit Google 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.

CPU-Limits konfigurieren

Jede Konfigurationsänderung führt zur Erstellung einer neuen Überarbeitung. Für nachfolgende Überarbeitungen gilt automatisch dieselbe Konfigurationseinstellung, sofern Sie sie nicht explizit aktualisieren.

Sie können CPU-Limits für einen Cloud Run-Worker-Pool über die Google Cloud Console, die Google Cloud CLI, YAML oder Terraform festlegen:

Console

Rufen Sie in der Google Cloud Console Cloud Run auf:

Zu Cloud Run
Wählen Sie im Menü Worker-Pools aus und klicken Sie auf Container bereitstellen, um einen neuen Worker-Pool zu konfigurieren. Wenn Sie einen vorhandenen Worker-Pool konfigurieren möchten, klicken Sie auf den Worker-Pool und dann auf Neue Überarbeitung bearbeiten und bereitstellen.
Wenn Sie einen neuen Worker-Pool konfigurieren, füllen Sie die Seite mit den anfänglichen Worker-Pool-Einstellungen aus und klicken Sie dann auf Container, Netzwerk, Sicherheit, um die Seite zur Worker-Pool-Konfiguration zu maximieren.
Klicken Sie auf den Tab Container.
- Wählen Sie das CPU-Limit aus der Drop-down-Liste CPU aus.
Klicken Sie auf Erstellen oder Bereitstellen.

gcloud

Mit folgendem Befehl können Sie die CPU-Limits für einen bestimmten Worker-Pool aktualisieren:

gcloud run worker-pools update WORKER_POOL --cpu CPU

Ersetzen Sie

WORKER_POOL durch den Namen Ihres Worker-Pools.
CPU durch das CPU-Limit. Geben Sie den Wert 1, 2, 4, 6, oder 8 CPUs an. Beachten Sie dabei die Anforderungen in der Tabelle für CPUs und Arbeitsspeicher.

Sie können die CPU auch während der Bereitstellung mit dem folgenden Befehl festlegen:

gcloud run worker-pools deploy --image IMAGE_URL --cpu CPU

Ersetzen Sie

IMAGE_URL durch einen Verweis auf das Container-Image, das den Worker-Pool enthält, z. B. us-docker.pkg.dev/cloudrun/container/worker-pool:latest.
CPU durch den Wert 1, 2, 4, 6 oder 8 CPUs, Beachten Sie dabei die Anforderungen in der Tabelle für CPUs und Arbeitsspeicher.

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 > workerpool.yaml
```
Das folgende Beispiel enthält die YAML-Konfiguration:
```
apiVersion: run.googleapis.com/v1
kind: WorkerPool
metadata:
  name: WORKER_POOL
spec:
  template:
    spec:
      containers:
      - image: IMAGE_URL
        resources:
          limits:
            cpu: `CPU`
```
Ersetzen Sie Folgendes:
- WORKER_POOL: Der Name Ihres Cloud Run-Worker-Pools.
- 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.
- CPU: Der Wert für das CPU-Limit. Geben Sie den Wert 1, 2, 4, 6 oder 8 CPUs oder für weniger als 1 CPU einen Wert zwischen 0,08 und weniger als 1,00 in Schritten von 0,01 an. Die erforderlichen Einstellungen finden Sie in der Tabelle unter CPU-Limits festlegen und aktualisieren.
Erstellen oder aktualisieren Sie den Worker-Pool mit dem folgenden Befehl:
```
gcloud run worker-pools replace workerpool.yaml
```

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"
      resources {
        limits = {
          cpu = "CPU"
        }
      }
    }
  }
}

Ersetzen Sie:

WORKER_POOL durch den Namen des Worker-Pools.
REGION durch die Google Cloud Region. Beispiel: europe-west1.
IMAGE_URL durch einen Verweis auf das Container-Image, das den Worker-Pool enthält, z. B. us-docker.pkg.dev/cloudrun/container/worker-pool:latest.
CPU durch den Wert 1, 2, 4, 6 oder 8 CPUs, Beachten Sie dabei die Anforderungen in der Tabelle für CPUs und Arbeitsspeicher.

CPU-Konfiguration für den Worker-Pool ansehen

Rufen Sie in der Google Cloud Console Cloud Run auf:

Zu Cloud Run
Klicken Sie auf Worker-Pools , um die Liste der bereitgestellten Worker-Pools aufzurufen.
Klicken Sie auf den Worker-Pool, den Sie untersuchen möchten, um den Detailbereich aufzurufen.
Klicken Sie auf den Tab Container , um die CPU-Konfiguration für den Worker-Pool aufzurufen.