In questa pagina viene descritto come impostare i limiti di memoria.
Informazioni sull'utilizzo della memoria
Le istanze Cloud Run che superano il limite di memoria consentito vengono terminate.
I seguenti elementi vengono conteggiati per la 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 del 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 ciascun job è di 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 seguenti ruoli IAM:
-
Sviluppatore Cloud Run (
roles/run.developer
) sul job Cloud Run -
Utente account di servizio (
roles/iam.serviceAccountUser
) sull'identità del servizio
Per un elenco dei ruoli e delle 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 dell'identità del servizio. Per ulteriori informazioni sulla concessione dei ruoli, consulta Autorizzazioni di deployment e Gestire l'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
Nella console Google Cloud, vai alla pagina dei job Cloud Run:
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.
Fai clic su Contenitore, variabili e secret, connessioni, sicurezza per espandere la pagina delle proprietà del job.
Fai clic sulla scheda Contenitore.
- Seleziona la dimensione della memoria che preferisci dall'elenco a discesa Memoria.
Fai clic su Crea o Aggiorna.
Riga di comando
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 tuo job.
- IMAGE_URL con un riferimento all'immagine container,
ad esempio
us-docker.pkg.dev/cloudrun/container/job:latest
. - SIZE con le dimensioni di memoria desiderate. Il formato della dimensione è un numero fisso o in virgola mobile seguito da un'unità:
G
oM
corrispondenti rispettivamente a gigabyte o megabyte oppure utilizza la potenza di due equivalenti:Gi
oMi
corrispondenti rispettivamente a gibibyte o mebibyte.
Per impostare i limiti di memoria quando aggiorni un job:
gcloud run jobs update JOB_NAME --memory SIZE
YAML
Se stai creando un nuovo job, salta questo passaggio. Se stai aggiornando un job esistente, scarica la relativa configurazione YAML:
gcloud run jobs describe JOB_NAME --format export > job.yaml
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 la dimensione della memoria desiderata, specificando almeno 512 Mi. Il formato è un numero in virgola mobile o fisso seguito da un'unità:
G
oM
corrispondenti rispettivamente a gigabyte o megabyte oppure utilizza la potenza di due equivalenti:Gi
oMi
corrispondenti rispettivamente a gibibyte o mebibyte.Puoi anche specificare ulteriori configurazioni, come le variabili di ambiente o i limiti di memoria.
Aggiorna la configurazione del job esistente:
gcloud run jobs replace job.yaml
Visualizza le impostazioni dei limiti di memoria
Per visualizzare le impostazioni attuali del limite di memoria per il tuo job Cloud Run:
Console
Nella console Google Cloud, vai alla pagina dei job Cloud Run:
Fai clic sul lavoro che ti interessa per aprire la pagina Dettagli offerta di lavoro.
Fai clic sulla scheda Configuration (Configurazione).
Individua l'impostazione del limite di memoria nei dettagli della configurazione.
Riga di comando
Utilizza questo comando:
gcloud run jobs describe JOB_NAME
Individua l'impostazione del limite di memoria nella configurazione restituita.