Speicherlimits konfigurieren

Auf dieser Seite wird beschrieben, wie Sie Speicherlimits festlegen.

Grundlegendes zur Arbeitsspeichernutzung

Cloud Run-Instanzen, die das zulässige Arbeitsspeicherlimit überschreiten, werden beendet.

Folgendes wird auf den verfügbaren Arbeitsspeicher Ihrer Instanz angerechnet:

Ausführen der ausführbaren Datei einer Anwendung, da die ausführbare Datei in den Arbeitsspeicher geladen werden muss
Zuweisen von Arbeitsspeicher im Anwendungsprozess
Schreiben von Dateien in das Dateisystem

Die Größe des bereitgestellten Container-Images wird nicht auf den verfügbaren Arbeitsspeicher angerechnet.

Speicherlimits festlegen und aktualisieren

Sie können Arbeitsspeicherlimits für Cloud Run-Jobs festlegen. Standardmäßig beträgt der jedem Job zugewiesene Arbeits-Speicher 512 MiB.

Erforderliche Mindest-CPUs

Beim Festlegen eines Arbeitsspeicherlimits sind folgende CPU-Mindestlimits erforderlich:

Speicher	Mindestanzahl erforderlicher CPUs
Mehr als 4 GiB	2
Mehr als 8 GiB	4
Mehr als 16 GiB	6
Mehr als 24 GiB	8

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 zu gewähren, um die Berechtigungen zu erhalten, die Sie zum Konfigurieren von Cloud Run-Jobs benötigen:

Cloud Run Developer (roles/run.developer) für den 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 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.

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":

Öffnen Sie Cloud Run.
Klicken Sie auf den Tab Jobs und füllen Sie die Seite mit den anfänglichen Jobeinstellungen wie gewünscht aus, wenn Sie einen neuen Job konfigurieren. Klicken Sie auf den Job und dann auf Bearbeiten, wenn Sie einen vorhandenen Job konfigurieren.
Klicken Sie auf Container, Variablen und Secrets, 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.

Befehlszeile

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 oder M, die dem Gigabyte oder Megabyte entspricht, oder verwenden Sie die Potenz von zwei Entsprechungen: Gi oder Mi, die Gibibyte bzw. Mebibyte entsprechen.
So legen Sie Arbeitsspeicherlimits beim Aktualisieren eines Jobs fest:
```
gcloud run jobs update JOB_NAME --memory SIZE
```

YAML

Laden Sie die vorhandene Jobkonfiguration herunter und verwenden Sie den Befehl gcloud run jobs describe --format export, um bereinigte Ergebnisse im YAML-Format zu erhalten. Ändern Sie dann die unten beschriebenen Felder und laden Sie die geänderte YAML-Datei mit dem Befehl gcloud run jobs replace hoch. Achten Sie darauf, dass Sie die Felder nur wie dokumentiert ändern.

So rufen Sie die Konfiguration auf und laden sie 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 oder M, was Gigabyte oder Megabyte entspricht. Alterntiv verwenden Sie die Potenz von zwei Entsprechungen: Gi oder Mi, 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
```

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":

Zu Cloud Run-Jobs
Klicken Sie auf den gewünschten Job, um die Seite Jobdetails zu öffnen.
Klicken Sie auf den Tab Konfiguration.
Suchen Sie die Einstellung für das Speicherlimit in den Konfigurationsdetails.

Befehlszeile

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.