Configura i limiti di memoria per i pool di worker

Puoi scegliere la quantità di memoria da fornire per il pool di worker Cloud Run. Questa pagina descrive come specificare la quantità di memoria disponibile per il tuo pool di worker.

Informazioni sull'utilizzo della memoria

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

La memoria disponibile per l'istanza deve essere sufficiente per:

  • Esecuzione dell'eseguibile del worker pool, perché l'eseguibile deve essere caricato in memoria
  • Allocazione della memoria nel processo del pool di worker
  • Scrittura di file nel file system

Le dimensioni dell'immagine container di cui è stato eseguito il deployment non influiscono sulla memoria disponibile per l'istanza.

Impostare e aggiornare i limiti di memoria

Puoi impostare limiti di memoria sui pool di worker Cloud Run. Per impostazione predefinita, la memoria allocata a ogni pool di worker è 512 MiB.

CPU minime richieste

La quantità di memoria allocata che scegli corrisponde a una quantità minima di CPU per il tuo pool di worker. Quando imposti un limite di memoria, sono necessari i seguenti limiti minimi di CPU:

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

Quantità massima di memoria

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

Puoi applicare un limite massimo di memoria utilizzando policy dell'organizzazione personalizzate.

Memoria minima

L'impostazione della memoria minima è 512 MiB.

Ruoli obbligatori

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

Per un elenco di ruoli e autorizzazioni IAM associati a Cloud Run, consulta Ruoli IAM Cloud Run e Autorizzazioni IAM Cloud Run. Se il tuo pool di worker Cloud Run interagisce con le APIGoogle Cloud , come le librerie client 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.

Configurare i limiti di memoria

Qualsiasi modifica alla configurazione comporta la creazione di una nuova revisione. Anche le revisioni successive riceveranno automaticamente questa impostazione di configurazione, a meno che tu non apporti aggiornamenti espliciti per modificarla.

Puoi impostare limiti di memoria per un pool di worker Cloud Run utilizzando Google Cloud CLI o Terraform:

gcloud

Puoi aggiornare l'allocazione di memoria di un determinato pool di worker utilizzando il seguente comando:

gcloud beta run worker-pools update WORKER_POOL --memory SIZE

Sostituisci:

  • WORKER_POOL con il nome del tuo pool di worker
  • SIZE con una dimensione della memoria dalla tabella CPU e memoria. Il formato per le dimensioni è un numero intero o in virgola mobile seguito da un'unità: G o M corrispondenti rispettivamente a gigabyte o megabyte oppure utilizza gli equivalenti in base 2: Gi o Mi corrispondenti rispettivamente a gibibyte o mebibyte.

Puoi anche impostare i limiti di memoria durante l'implementazione utilizzando il comando:

gcloud beta run worker-pools deploy --image IMAGE_URL --memory SIZE

Sostituisci:

  • IMAGE_URL con un riferimento all'immagine container che contiene il pool di worker, ad esempio us-docker.pkg.dev/cloudrun/container/worker-pool:latest.
  • SIZE con una dimensione della memoria dalla tabella CPU e memoria. Il formato per le dimensioni è un numero a virgola fissa o mobile seguito da un'unità: G o M corrispondenti rispettivamente a gigabyte o megabyte oppure utilizza gli equivalenti in base 2: Gi o Mi corrispondenti rispettivamente a gibibyte o mebibyte.

Terraform

Per scoprire come applicare o rimuovere una configurazione Terraform, consulta Comandi Terraform di base.

resource "google_cloud_run_v2_worker_pool" "default" {
  name     = "WORKER_POOL"
  location = "REGION"
  launch_stage = "BETA"

  template {
    containers {
      image = "IMAGE_URL"
      resources {
        limits = {
          memory = "SIZE"
        }
      }
    }
  }
}

Sostituisci:

  • WORKER_POOL con il nome del pool di worker.
  • REGION con la regione Google Cloud . Ad esempio, europe-west1.
  • IMAGE_URL con un riferimento all'immagine container che contiene il pool di worker, ad esempio us-docker.pkg.dev/cloudrun/container/worker-pool:latest
  • SIZE con una dimensione della memoria dalla tabella CPU e memoria. Il formato per le dimensioni è un numero intero o in virgola mobile seguito da un'unità: G o M corrispondenti rispettivamente a gigabyte o megabyte oppure utilizza gli equivalenti in base 2: Gi o Mi corrispondenti rispettivamente a gibibyte o mebibyte.

Visualizza la configurazione della memoria per il worker pool

  1. Nella console Google Cloud , vai a Cloud Run:

    Vai a Cloud Run

  2. Fai clic su Pool di worker per visualizzare l'elenco dei pool di worker di cui è stato eseguito il deployment.

  3. Fai clic sul pool di worker che vuoi esaminare per visualizzare il riquadro dei dettagli.

  4. Fai clic sulla scheda Container per visualizzare la configurazione della memoria del pool di worker per ogni contenitore.