Sie können die Menge an Arbeitsspeicher auswählen, die für Ihren Cloud Run-Dienst bereitgestellt werden soll. Auf dieser Seite wird beschrieben, wie Sie die für Ihren Dienst verfügbare Arbeitsspeichermenge angeben.
Grundlegendes zur Arbeitsspeichernutzung
Cloud Run-Instanzen, die das zulässige Arbeitsspeicherlimit überschreiten, werden beendet.
Der verfügbare Arbeitsspeicher Ihrer Instanz muss für Folgendes ausreichen:
- Ausführen der ausführbaren Datei des Dienstes, da die ausführbare Datei in den Arbeitsspeicher geladen werden muss
- Arbeitsspeicher im Dienstprozess zuweisen
- Dateien in das Dateisystem schreiben
Die Größe des bereitgestellten Container-Images hat keinen Einfluss auf den für die Instanz verfügbaren Arbeitsspeicher.
Speicherlimits festlegen und aktualisieren
Sie können Arbeitsspeicherlimits für Cloud Run-Dienste festlegen. Standardmäßig beträgt der jeder Instanz einer Überarbeitung zugewiesene Speicher 512 MiB.
Erforderlicher Arbeitsspeicher beim Festlegen eines CPU-Werts
Beim Festlegen eines CPU-Werts ist der folgende Arbeitsspeicher erforderlich:
| CPUs | Arbeitsspeicher erforderlich |
|---|---|
| 0,08 vCPU | Bis zu 512 MiB |
| 0,5 vCPU | Bis zu 1 GiB |
| 1 vCPU | Bis zu 4 GiB |
| 2 vCPU | Bis zu 8 GiB |
| 4 vCPU | 2 bis 16 GiB |
| 6 vCPUs | 4 bis 24 GiB |
| 8 vCPUs | 4 bis 32 GiB |
Maximale Arbeitsspeichermenge
Sie können maximal 32 Gibibyte (32 Gi) Arbeitsspeicher konfigurieren.
Mindestspeicher
Die Mindestspeichereinstellung hängt davon ab, ob Sie die Ausführungsumgebung der ersten Generation oder der zweiten Generation verwenden:
- 128 MiB für die erste Generation
- 512 MiB für die zweite Generation
Kostengesichtspunkte
Die Kosten für Ihren Cloud Run-Dienst hängen unter anderem von der Speicherkonfiguration und der Dauer der Aktivität der Ressource ab. Eine Überdimensionierung Ihrer Ressourcen kann die Kosten erhöhen. So ermitteln Sie, welche Arbeitsspeicherkonfiguration für Ihre Ressource am besten geeignet ist:
- Erstellen Sie eine erste Baseline-Konfiguration.
- Behalten Sie die Messwerte zur Arbeitsspeicherauslastung in Cloud Monitoring im Blick, während Sie das System unter Last testen.
- Passen Sie die Konfiguration nach Bedarf an.
Wenn die Arbeitsspeicherauslastung durchgehend niedrig ist, sollten Sie den zugewiesenen Arbeitsspeicher reduzieren. Wenn die Latenz hoch ist und die Arbeitsspeicherauslastung fast 100 % beträgt, sollten Sie den zugewiesenen Arbeitsspeicher erhöhen. Wenn Out of Memory (OOM)-Fehler auftreten, sollten Sie den zugewiesenen Arbeitsspeicher erhöhen oder Ihre Anwendung so ändern, dass Speicherlecks vermieden werden und weniger Arbeitsspeicher verwendet wird. Weitere Informationen zur Arbeitsspeicherauslastung finden Sie im Cloud Monitoring-Dashboard.
Weitere Informationen finden Sie unter Cloud Run – Preise. Sie können die Kosten auch mit dem Preisrechner schätzen.
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-Diensten benötigen:
- Cloud Run-Entwickler (
roles/run.developer) für den Cloud Run-Dienst - Dienstkontonutzer (
roles/iam.serviceAccountUser) für die Dienstidentität
Wenn Sie einen Dienst oder eine Funktion aus dem Quellcode bereitstellen, müssen Ihnen außerdem zusätzliche Rollen für Ihr Projekt und Ihr Cloud Build-Dienstkonto zugewiesen sein.
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-Dienst 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.
Speicherlimits 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.
Für Cloud Run-Dienste können Sie Arbeitsspeicherlimits über die Google Cloud Console, die gcloud-Befehlszeile oder eine YAML-Datei festlegen, wenn Sie einen neuen Dienst erstellen oder eine neue Überarbeitung bereitstellen:
Console
Rufen Sie in der Google Cloud Console die Seite „Cloud Run“ auf:
Wählen Sie im Cloud Run-Navigationsmenü die Option Dienste aus:
Wenn Sie einen neuen Dienst konfigurieren, klicken Sie auf Container bereitstellen und füllen Sie die Seite mit den anfänglichen Diensteinstellungen aus. Klicken Sie dann auf Container, Netzwerk, Sicherheit, um die Seite zur Dienstkonfiguration zu maximieren.
Wenn Sie einen vorhandenen Dienst konfigurieren, klicken Sie auf den Dienst.
Klicken Sie auf den Tab Container.
Wählen Sie die Arbeitsspeichergröße aus der Liste Arbeitsspeicher aus.
Klicken Sie auf Erstellen, um einen neuen Dienst zu erstellen. Klicken Sie für einen vorhandenen Dienst auf Unterschied ansehen und erneut bereitstellen und dann auf Änderungen bereitstellen.
gcloud
Mit dem folgenden Befehl können Sie die Arbeitsspeicherzuweisung eines bestimmten Dienstes aktualisieren:
gcloud run services update SERVICE --memory SIZE
Ersetzen Sie SERVICE durch den Dienstnamen und SIZE durch die gewünschte Speichergröße. Das Format für die Größe ist eine feste oder Gleitkommazahl gefolgt von einer Einheit: G oder M, die dem Gigabyte oder Megabyte entspricht, oder verwenden Sie die Potenz von zwei Entsprechungen: Gi oder Mi, die Gibibyte bzw. Mebibyte entsprechen.
Sie können die Speicherlimits auch während der Bereitstellung festlegen. Verwenden Sie folgenden Befehl:
gcloud run deploy --image IMAGE_URL --memory SIZE
Ersetzen Sie Folgendes:
IMAGE_URL: ein Verweis auf das Container-Image, z. B.us-docker.pkg.dev/cloudrun/container/hello:latestWenn Sie Artifact Registry verwenden, muss das Repository REPO_NAME bereits erstellt sein. Die URL hat das FormatLOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/PATH:TAG.- SIZE: die zuvor beschriebenen Werte.
YAML
Wenn Sie einen neuen Dienst erstellen, überspringen Sie diesen Schritt. Wenn Sie einen vorhandenen Dienst aktualisieren, laden Sie die zugehörige YAML-Konfiguration herunter:
gcloud run services describe SERVICE --format export > service.yaml
Aktualisieren Sie das Attribut
memory:apiVersion: serving.knative.dev/v1 kind: Service metadata: name: SERVICE spec: template: metadata: name: REVISION spec: containers: - image: IMAGE resources: limits: memory: SIZE
Ersetzen Sie Folgendes:
- SERVICE: Der Name Ihres Cloud Run-Dienstes.
IMAGE_URL: ein Verweis auf das Container-Image, z. B.us-docker.pkg.dev/cloudrun/container/hello:latestWenn Sie Artifact Registry verwenden, muss das Repository REPO_NAME bereits erstellt sein. Die URL hat das FormatLOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/PATH:TAG.- SIZE: die erforderliche Arbeitsspeichergröße.
Das Format ist eine feste oder Gleitkommazahl gefolgt von einer Einheit:
GoderMdem Gigabyte oder Megabyte entspricht, oder verwenden Sie die Potenz von zwei Entsprechungen:GioderMi, die Gibibyte bzw. Mebibyte entsprechen. REVISION: ein neuer Versionsname oder löschen Sie ihn (falls vorhanden). Wenn Sie einen neuen Überarbeitungsnamen angeben, muss er die folgenden Kriterien erfüllen:- Beginnt mit
SERVICE- - Enthält nur Kleinbuchstaben, Ziffern und
- - Endet nicht mit
- - Darf nicht mehr als 63 Zeichen enthalten
- Beginnt mit
Erstellen oder aktualisieren Sie den Dienst mit dem folgenden Befehl:
gcloud run services replace service.yaml
Der Befehl
gcloud run services replaceverwendet standardmäßig die Dateiservice.yaml, falls vorhanden.
Terraform
Informationen zum Anwenden oder Entfernen einer Terraform-Konfiguration finden Sie unter Grundlegende Terraform-Befehle.
Fügen Sie einergoogle_cloud_run_v2_service-Ressource in Ihrer Terraform-Konfiguration Folgendes hinzu:Ersetzen Sie unter template.containers.resources.limits den Wert 512Mi durch das erforderliche Speicherlimit Ihres Dienstes.
Schreiben
Wenn Sie CPU- und Arbeitsspeicherhinweise in Ihrer compose.yaml-Datei angeben möchten, fügen Sie Ihrer Dienstdefinition das Attribut cpus hinzu. Cloud Run weist automatisch den erforderlichen Arbeitsspeicher zu, wenn ein CPU-Wert festgelegt wird.
services: web: image: IMAGE cpus: CPU_VALUE
Ersetzen Sie Folgendes:
- IMAGE: die URL Ihres Container-Images
- CPU_VALUE: das erforderliche CPU-Limit, z. B.
2. Dieser Wert bestimmt den erforderlichen Arbeitsspeicher.
Dienste bereitstellen
Führen Sie den Befehl
gcloud run compose upaus, um die Dienste bereitzustellen:gcloud run compose up compose.yamlAntworten Sie auf alle Aufforderungen, erforderliche Komponenten zu installieren oder APIs zu aktivieren, mit
y.Optional: Veröffentlichen Sie Ihren Dienst, wenn Sie den nicht authentifizierten Zugriff auf den Dienst zulassen möchten.
Nach der Bereitstellung wird die Cloud Run-Dienst-URL angezeigt. Kopieren Sie diese URL und fügen Sie sie in Ihren Browser ein, um den ausgeführten Container anzusehen. Sie können die Standardauthentifizierung in der Google Cloud Console deaktivieren.
Speicher für Dienste optimieren
So können Sie für einen Cloud Run-Dienst den maximalen Arbeitsspeicherbedarf für einen Dienst ermitteln: (Vorhandener Arbeitsspeicher) + (Angeforderter Speicher) * (Gleichzeitigkeit des Dienstes).
Entsprechend gilt:
Zusammen mit der Gleichzeitigkeit eines Dienstes sollten Sie auch das Speicherlimit erhöhen, um Spitzenlasten abzufangen.
Wenn Sie die Nebenläufigkeit Ihres Dienstes verringern, sollten Sie das Speicherlimit reduzieren, um Kosten für die Speichernutzung zu sparen.
Weitere Informationen dazu, wie Sie die Arbeitsspeichernutzung pro Anfrage minimieren können, finden Sie unter Tipps für Entwickler: globale Variablen.
Einstellungen für das Speicherlimit anzeigen
So rufen Sie die aktuellen Einstellungen für das Speicherlimit für Ihren Cloud Run-Dienst auf:
Console
Rufen Sie in der Google Cloud Console die Seite Cloud Run-Dienste auf:
Klicken Sie auf den gewünschten Dienst, um die Seite Dienstdetails zu öffnen.
Klicken Sie auf den Tab Container, um die Einstellungen aufzurufen.
gcloud
Verwenden Sie den folgenden Befehl:
gcloud run services describe SERVICE
Suchen Sie in der zurückgegebenen Konfiguration nach der Einstellung für das Speicherlimit.