Configura i limiti di CPU per i pool di worker

Anteprima — pool di worker Cloud Run

Questa funzionalità è soggetta ai "Termini dell'offerta pre-GA" nella sezione dei Termini di servizio generali dei Termini specifici dei servizi. Le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per ulteriori informazioni, consulta le descrizioni della fase di lancio.

Questa pagina descrive come specificare il numero di vCPU da utilizzare per ogni istanza di Cloud Run. Per impostazione predefinita, le istanze di container Cloud Run sono limitate a 1 vCPU. Puoi aumentare o diminuire questo valore come descritto in questa pagina.

Impostare e aggiornare i limiti di vCPU

Per impostazione predefinita, ogni istanza è limitata a 1 vCPU. Puoi modificare questo valore in uno qualsiasi dei valori mostrati nella tabella seguente.

Tabella vCPU e memoria

Di seguito sono riportati i requisiti di memoria per le vCPU:

CPU	Memoria richiesta
1 vCPU	Da 128 MiB a 4 GiB
2 vCPU	Da 128 MiB a 8 GiB
4 vCPU	Da 2 a 16 GiB
6 vCPU	Da 4 a 24 GiB
8 vCPU	Da 4 a 32 GiB

I valori maggiori di 1 devono essere numeri interi.

Nota: quando selezioni un limite di vCPU maggiore di 1 vCPU, tieni presente il modello di threading della tua applicazione. Se la tua applicazione è a thread singolo, potrebbe utilizzare completamente solo una vCPU.

Quantità massima di vCPU

La quantità massima di vCPU che puoi configurare è 8 vCPU.

Quantità minima di vCPU

L'impostazione minima di vCPU è 1 vCPU.

Considerazioni sui costi

Il costo della risorsa Cloud Run è influenzato, tra gli altri fattori, dalla configurazione della CPU e dalla durata di attività della risorsa. Il provisioning eccessivo delle risorse può aumentare i costi. Per determinare la configurazione della CPU più adatta alla tua risorsa:

1. Stabilisci una configurazione di base iniziale per un limite di CPU che bilanci l'utilizzo della CPU e i costi.
2. Monitora le metriche di utilizzo della CPU in Cloud Monitoring durante il test del sistema sotto carico.
3. Modifica la configurazione della CPU in base alle esigenze.

Se l'utilizzo della CPU è costantemente basso durante il carico di picco, valuta la possibilità di ridurre l'allocazione della vCPU. Se la latenza è elevata, valuta la possibilità di aumentare l'allocazione della vCPU.

Puoi visualizzare i dati di riepilogo dei costi, i dati di utilizzo e i suggerimenti per l'ottimizzazione dei costi per i servizi nella pagina Ottimizzazione di Cloud Hub. Per ulteriori informazioni, consulta i prezzi di Cloud Run o stima i costi con il calcolatore prezzi.

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per configurare ed eseguire il deployment dei pool di worker Cloud Run, chiedi all'amministratore di concederti i seguenti ruoli IAM:

• Cloud Run Developer (roles/run.developer) sul pool di worker Cloud Run
• Utente account di servizio (roles/iam.serviceAccountUser) sull'identità di servizio

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 tuo pool di worker Cloud Run interagisce con Google Cloud API, come le librerie client Cloud, consulta la guida alla configurazione dell'identità del servizio. Per saperne di più sulla concessione dei ruoli, consulta Autorizzazioni di deployment e Gestisci l'accesso.

Configurare i limiti di CPU

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 i limiti di CPU per un pool di worker Cloud Run utilizzando la Google Cloud console, Google Cloud CLI, YAML o Terraform:

Console

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

   Vai a Cloud Run

2. Seleziona Pool di worker dal menu e fai clic su Esegui il deployment del container per configurare un nuovo pool di worker. Se stai configurando un pool di worker esistente, fai clic sul pool di worker, quindi su Modifica ed esegui il deployment di una nuova revisione.

3. Se stai configurando un nuovo pool di worker, compila la pagina iniziale del pool di worker, quindi fai clic su Container, Networking, sicurezza per espandere la pagina di configurazione dei pool di worker.

4. Fai clic sulla scheda Container.

   

   • Seleziona il limite di CPU dall'elenco a discesa CPU.

5. Fai clic su Crea o Esegui il deployment.

gcloud

Puoi aggiornare i limiti di CPU per un determinato pool di worker utilizzando il seguente comando:

gcloud beta run worker-pools update WORKER_POOL --cpu CPU

Sostituisci

• WORKER_POOL con il nome del tuo pool di worker
• CPU con il limite di CPU. Specifica il valore 1, 2, 4, 6, o 8 CPU, seguendo i requisiti mostrati nella tabella CPU e memoria.

Puoi anche impostare la CPU durante il deployment utilizzando il comando:

gcloud beta run worker-pools deploy --image IMAGE_URL --cpu CPU

Sostituisci

• IMAGE_URL: un riferimento all'immagine container che contiene il pool di worker, ad esempio us-docker.pkg.dev/cloudrun/container/worker-pool:latest.
• CPU con il valore 1, 2, 4, 6, o 8 CPU, seguendo i requisiti mostrati nella tabella CPU e memoria.

YAML

1. Se stai creando un nuovo pool di worker, salta questo passaggio. Se stai aggiornando un pool di worker esistente, scarica la relativa configurazione YAML:

   gcloud beta run worker-pools describe WORKER_POOL --format export > workerpool.yaml

2. L'esempio seguente contiene la configurazione YAML:

   apiVersion: run.googleapis.com/v1
   kind: WorkerPool
   metadata:
     name: WORKER_POOL
     annotations:
       run.googleapis.com/launch-stage: BETA
   spec:
     template:
       spec:
         containers:
         - image: IMAGE_URL
           resources:
             limits:
               cpu: `CPU`

   Sostituisci quanto segue:

   • WORKER_POOL: il nome del tuo pool di worker Cloud Run.
   • IMAGE_URL: un riferimento all'immagine container che contiene il pool di worker, ad esempio us-docker.pkg.dev/cloudrun/container/worker-pool:latest.
   • CPU: il valore del limite di CPU. Specifica il valore 1, 2, 4, 6 o 8 CPU oppure, per meno di 1 CPU, specifica un valore compreso tra 0,08 e meno di 1,00, con incrementi di 0,01. (Consulta la tabella in Impostare e aggiornare i limiti di CPU per le impostazioni obbligatorie.)

3. Crea o aggiorna il pool di worker utilizzando il seguente comando:

   gcloud beta run worker-pools replace workerpool.yaml

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 = {
          cpu = "CPU"
        }
      }
    }
  }
}

Sostituisci:

• WORKER_POOL con il nome del pool di worker.
• REGION con la Google Cloud regione. Ad esempio, europe-west1.
• IMAGE_URL: un riferimento all'immagine container che contiene il pool di worker, ad esempio us-docker.pkg.dev/cloudrun/container/worker-pool:latest
• CPU con il valore 1, 2, 4, 6, o 8 CPU, seguendo i requisiti mostrati nella tabella CPU e memoria.

Visualizzare la configurazione della CPU per il pool di worker

1. Nella Google Cloud console, 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 CPU per il pool di worker.

Nota: puoi anche utilizzare il comando Google Cloud CLI gcloud beta run worker-pools describe per visualizzare i dettagli della configurazione.