Configura limiti di memoria

In questa pagina viene descritto come impostare i limiti di memoria.

Informazioni sull'utilizzo della memoria

Le istanze di Cloud Run che superano il limite di memoria consentito vengono terminate.

Quanto segue viene conteggiato ai fini della memoria disponibile dell'istanza:

  • Esecuzione dell'eseguibile dell'applicazione (poiché l'eseguibile deve essere caricato in memoria)
  • Allocazione della memoria nel processo di applicazione
  • Scrittura di file nel file system

Le dimensioni dell'immagine container di cui è stato eseguito il deployment non vengono conteggiate ai fini della memoria disponibile.

Impostare e aggiornare i limiti di memoria

Puoi impostare limiti di memoria per i job Cloud Run. Per impostazione predefinita, la memoria allocata a ogni job è 512 MiB.

CPU minime richieste

Quando imposti un limite di memoria, sono richiesti i seguenti limiti minimi di CPU:

Memoria Numero minimo di CPU richieste
Più di 4 GiB 2
Più di 8 GiB 4
Più di 16 GiB 6
Più di 24 GiB 8

Quantità massima di memoria

La quantità massima di memoria che puoi configurare è 32 gibibyte (32 Gi).

Memoria minima

La quantità minima di memoria che puoi configurare nell'ambiente di esecuzione di seconda generazione è 512 MiB.

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per configurare i job Cloud Run, chiedi all'amministratore di concederti i ruoli IAM seguenti:

Per un elenco di ruoli e autorizzazioni IAM associati a Cloud Run, consulta Ruoli IAM di Cloud Run e Autorizzazioni IAM di Cloud Run. Se il job Cloud Run si interfaccia con le API Google Cloud, ad esempio le librerie client di Cloud, consulta la guida alla configurazione delle identità dei servizi. Per ulteriori informazioni sulla concessione dei ruoli, consulta Autorizzazioni di deployment e Gestione dell'accesso.

Configura limiti di memoria

Devi specificare un minimo di 512 Mi per un job Cloud Run. Per specificare la memoria per un job Cloud Run:

Console

  1. Nella console Google Cloud, vai alla pagina dei job Cloud Run:

    Vai a Cloud Run

  2. Se stai configurando un nuovo job, fai clic sulla scheda Job e compila la pagina iniziale delle impostazioni del job come preferisci. Se stai configurando un job esistente, fai clic sul job e poi su Modifica.

  3. Fai clic su Container, variabili e secret, connessioni, sicurezza per espandere la pagina delle proprietà del job.

  4. Fai clic sulla scheda Contenitore.

    immagine

    • Seleziona le dimensioni della memoria che preferisci dall'elenco a discesa Memoria.
  5. Fai clic su Crea o Aggiorna.

Riga di comando

  1. Per impostare i limiti di memoria quando crei un job:

    gcloud run jobs create JOB_NAME --image IMAGE_URL --memory SIZE

    Sostituisci

    • JOB_NAME con il nome del job.
    • IMAGE_URL con un riferimento all'immagine container, ad esempio us-docker.pkg.dev/cloudrun/container/job:latest.
    • SIZE con le dimensioni della memoria desiderate. Il formato delle dimensioni è un numero fisso o in virgola mobile seguito da un'unità: G o M, corrispondenti rispettivamente a gigabyte o megabyte, oppure usa la potenza di due equivalenti: Gi o Mi corrispondenti rispettivamente a gibibyte o mebibyte.
  2. Per impostare i limiti di memoria quando aggiorni un job:

    gcloud run jobs update JOB_NAME --memory SIZE

YAML

Scarica e visualizza la configurazione esistente dei job utilizzando il comando gcloud run jobs describe --format export, che restituisce risultati puliti in formato YAML. Quindi modifica i campi descritti di seguito e carica il file YAML modificato utilizzando il comando gcloud run jobs replace. Assicurati di modificare i campi solo come documentato.

  1. Per visualizzare e scaricare la configurazione:

    gcloud run jobs describe JOB_NAME --format export > job.yaml
  2. Aggiorna l'attributo memory:

    apiVersion: run.googleapis.com/v1
    kind: Job
    metadata:
      name: JOB
    spec:
      template:
        spec:
          template:
            spec:
          containers:
          - image: IMAGE
            resources:
              limits:
                memory: SIZE

    Sostituisci SIZE con le dimensioni della memoria desiderate, specificando un minimo di 512 Mi. Il formato è un numero fisso o in virgola mobile seguito da un'unità: G o M, corrispondenti rispettivamente a gigabyte o megabyte, o utilizza l'equivalente Power of 2: Gi o Mi, corrispondenti rispettivamente a gibibyte o mebibyte.

    Puoi anche specificare ulteriori configurazioni, ad esempio variabili di ambiente o limiti di memoria.

  3. Aggiorna la configurazione del job esistente:

    gcloud run jobs replace job.yaml

Visualizza le impostazioni del limite di memoria

Per visualizzare le impostazioni attuali dei limiti di memoria per il job Cloud Run:

Console

  1. Nella console Google Cloud, vai alla pagina dei job Cloud Run:

    Vai ai job Cloud Run

  2. Fai clic sul job che ti interessa per aprire la pagina Dettagli job.

  3. Fai clic sulla scheda Configuration (Configurazione).

  4. Individua l'impostazione del limite di memoria nei dettagli della configurazione.

Riga di comando

  1. Utilizza il seguente comando:

    gcloud run jobs describe JOB_NAME
  2. Individua l'impostazione del limite di memoria nella configurazione restituita.