Sie können die Menge an Arbeitsspeicher auswählen, die für Ihren Cloud Run-Job bereitgestellt werden soll. Auf dieser Seite wird beschrieben, wie Sie die Menge an Arbeitsspeicher angeben, die für Ihren Job verfügbar ist.
Grundlegendes zur Arbeitsspeichernutzung
Cloud Run-Instanzen, die das zulässige Arbeitsspeicherlimit überschreiten, werden beendet.
Der verfügbare Arbeitsspeicher für Ihre Instanz muss für Folgendes ausreichen:
- Ausführen der ausführbaren Datei des Jobs, da die ausführbare Datei in den Arbeitsspeicher geladen werden muss
- Zuweisen von Arbeitsspeicher im Jobprozess
- Schreiben von Dateien in das Dateisystem
Die Größe des bereitgestellten Container-Images wirkt sich nicht auf den für die Instanz verfügbaren Arbeitsspeicher aus.
Speicherlimits festlegen und aktualisieren
Sie können Arbeitsspeicherlimits für Cloud Run-Jobs festlegen. Standardmäßig beträgt der jedem Job zugewiesene Speicher 512 MiB.
Erforderliche Mindest-CPUs
Die von Ihnen ausgewählte Größe des zugewiesenen Speichers entspricht einer Menge an Mindest-CPU für Ihren Job. Beim Festlegen eines Arbeitsspeicherlimits sind folgende CPU-Mindestlimits erforderlich:
Arbeitsspeicher | Mindestanzahl erforderlicher CPUs |
---|---|
128 MiB | .083 vCPU |
256 MiB | .167 vCPU |
512 MiB | .333 vCPU |
1 GiB | .583 vCPU |
2 GiB | 1 vCPU |
Mehr als 4 GiB | 2 vCPU |
Mehr als 8 GiB | 4 vCPU |
Mehr als 16 GiB | 6 vCPU |
Mehr als 24 GiB | 8 vCPU |
Maximale Arbeitsspeichermenge
Sie können maximal 32 Gibibyte (32 Gi
) Arbeitsspeicher konfigurieren.
Mindestspeicher
Die Mindestspeichermenge, die Sie in der Ausführungsumgebung der zweiten Generation konfigurieren können, beträgt 512 MiB.
Erforderliche Rollen
Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Konfigurieren von Cloud Run-Jobs benötigen:
-
Cloud Run-Entwickler (
roles/run.developer
) im Cloud Run-Job -
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-Job 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
Für einen Cloud Run-Job müssen mindestens 512Mi angegeben werden. So geben Sie den Arbeitsspeicher für einen Cloud Run-Job an:
Console
Wechseln Sie in der Google Cloud -Console zur Seite „Cloud Run-Jobs“:
Wählen Sie im Menü Jobs aus und klicken Sie auf Container bereitstellen, um die Seite mit den anfänglichen Jobeinstellungen auszufüllen. Wenn Sie einen vorhandenen Job konfigurieren, wählen Sie den Job aus und klicken Sie dann auf Bearbeiten.
Klicken Sie auf Container, Volumes, Verbindungen, Sicherheit, um die Seite mit den Jobattributen zu maximieren.
Klicken Sie auf den Tab Container.
- Wählen Sie die gewünschte Arbeitsspeichergröße aus der Drop-down-Liste Arbeitsspeicher aus.
Klicken Sie auf Erstellen oder Aktualisieren.
gcloud
So legen Sie Arbeitsspeicherlimits beim Erstellen eines Jobs fest:
gcloud run jobs create JOB_NAME --image IMAGE_URL --memory SIZE
Ersetzen Sie:
- JOB_NAME durch den Namen des Jobs.
- IMAGE_URL durch einen Verweis auf das Container-Image, z. B.
us-docker.pkg.dev/cloudrun/container/job:latest
. - SIZE durch die gewünschte Arbeitsspeichergröße. Das Format für die Größe ist eine feste oder Gleitkommazahl gefolgt von einer Einheit:
G
oderM
, die dem Gigabyte oder Megabyte entspricht, oder verwenden Sie die Potenz von zwei Entsprechungen:Gi
oderMi
, die Gibibyte bzw. Mebibyte entsprechen.
So legen Sie Arbeitsspeicherlimits beim Aktualisieren eines Jobs fest:
gcloud run jobs update JOB_NAME --memory SIZE
YAML
Wenn Sie einen neuen Job erstellen, überspringen Sie diesen Schritt. Wenn Sie einen vorhandenen Job aktualisieren, laden Sie die zugehörige YAML-Konfiguration herunter:
gcloud run jobs describe JOB_NAME --format export > job.yaml
Aktualisieren Sie das Attribut
memory
:apiVersion: run.googleapis.com/v1 kind: Job metadata: name: JOB spec: template: spec: template: spec: containers: - image: IMAGE resources: limits: memory: SIZE
Ersetzen Sie SIZE durch die gewünschte Speichergröße und geben Sie mindestens 512 Mi an. Das Format ist eine feste Zahl oder Gleitkommazahl gefolgt von der Einheit:
G
oderM
, was Gigabyte oder Megabyte entspricht. Alterntiv verwenden Sie die Potenz von zwei Entsprechungen:Gi
oderMi
, was Gibibyte bzw. Mebibyte entspricht.Sie können auch weitere Konfigurationen angeben, z. B. Umgebungsvariablen oder Speicherlimits.
Aktualisieren Sie die vorhandene Jobkonfiguration:
gcloud run jobs replace job.yaml
Terraform
Informationen zum Anwenden oder Entfernen einer Terraform-Konfiguration finden Sie unter Grundlegende Terraform-Befehle.
Fügen Sie einergoogle_cloud_run_v2_job
-Ressource in Ihrer Terraform-Konfiguration Folgendes hinzu:resource "google_cloud_run_v2_job" "default" {
name = "cloudrun-job"
location = "REGION"
deletion_protection = false
template {
template {
containers {
image = "us-docker.pkg.dev/cloudrun/container/job"
resources {
limits = {
cpu = "2"
memory = "SIZE"
}
}
}
}
}
}
Ersetzen Sie:
- REGION durch die Google Cloud Region. Beispiel:
europe-west1
. - Ersetzen Sie SIZE durch die erforderliche Speichergröße und geben Sie mindestens 512 Mi an.
Das Format ist eine feste Zahl oder Gleitkommazahl gefolgt von der Einheit:
G
oderM
, was Gigabyte oder Megabyte entspricht. Alterntiv verwenden Sie die Potenz von zwei Entsprechungen:Gi
oderMi
, was Gibibyte bzw. Mebibyte entspricht.
Einstellungen für das Speicherlimit anzeigen
So rufen Sie die aktuellen Einstellungen für das Speicherlimit für Ihren Cloud Run-Job auf:
Console
Wechseln Sie in der Google Cloud -Console zur Seite „Cloud Run-Jobs“:
Klicken Sie auf den gewünschten Job, um die Seite Jobdetails zu öffnen.
Klicken Sie auf Jobkonfiguration ansehen und bearbeiten.
Suchen Sie die Einstellung für das Speicherlimit in den Konfigurationsdetails.
gcloud
Verwenden Sie den folgenden Befehl:
gcloud run jobs describe JOB_NAME
Suchen Sie in der zurückgegebenen Konfiguration nach der Einstellung für das Speicherlimit.