Configura i limiti di CPU per i pool di worker

Questa pagina descrive come specificare il numero di vCPU da utilizzare per ogni istanza Cloud Run. Per impostazione predefinita, le istanze container di 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 valori interi.

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:

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

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 worker pool di Cloud Run, chiedi all'amministratore di concederti i seguenti ruoli IAM:

Sviluppatore Cloud Run (roles/run.developer) sul worker pool di 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 worker pool di Cloud Run interagisce con Google Cloud le 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 worker pool di Cloud Run utilizzando la Google Cloud console, Google Cloud CLI, YAML o Terraform:

Console

Nella Google Cloud console, vai a Cloud Run:

Vai a Cloud Run
Seleziona Worker pool dal menu e fai clic su Esegui il deployment del container per configurare un nuovo worker pool. Se stai configurando un worker pool esistente, fai clic sul worker pool, quindi su Modifica ed esegui il deployment di una nuova revisione.
Se stai configurando un nuovo worker pool, compila la pagina iniziale del worker pool, quindi fai clic su Container, Networking, sicurezza per espandere la pagina di configurazione dei worker pool.
Fai clic sulla scheda Container.
- Seleziona il limite di CPU dall'elenco a discesa CPU.
Fai clic su Crea o Esegui il deployment.

gcloud

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

gcloud run worker-pools update WORKER_POOL --cpu CPU

Sostituisci

WORKER_POOL con il nome del worker pool
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 run worker-pools deploy --image IMAGE_URL --cpu CPU

Sostituisci

IMAGE_URL: un riferimento all'immagine container che contiene il worker pool, 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

Se stai creando un nuovo worker pool, salta questo passaggio. Se stai aggiornando un worker pool esistente, scarica la relativa configurazione YAML:
```
gcloud run worker-pools describe WORKER_POOL --format export > workerpool.yaml
```
L'esempio seguente contiene la configurazione YAML:
```
apiVersion: run.googleapis.com/v1
kind: WorkerPool
metadata:
  name: WORKER_POOL
spec:
  template:
    spec:
      containers:
      - image: IMAGE_URL
        resources:
          limits:
            cpu: `CPU`
```
Sostituisci quanto segue:
- WORKER_POOL: il nome del worker pool di Cloud Run.
- IMAGE_URL: un riferimento all'immagine container che contiene il worker pool, 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.
Crea o aggiorna il worker pool utilizzando il seguente comando:
```
gcloud 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"

  template {
    containers {
      image = "IMAGE_URL"
      resources {
        limits = {
          cpu = "CPU"
        }
      }
    }
  }
}

Sostituisci:

WORKER_POOL con il nome del worker pool.
REGION con la Google Cloud regione. Ad esempio, europe-west1.
IMAGE_URL: un riferimento all'immagine container che contiene il worker pool, 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 worker pool

Nella Google Cloud console, vai a Cloud Run:

Vai a Cloud Run
Fai clic su Worker pool per visualizzare l'elenco dei worker pool di cui è stato eseguito il deployment.
Fai clic sul worker pool che vuoi esaminare per visualizzare il riquadro dei dettagli.
Fai clic sulla scheda Container per visualizzare la configurazione della CPU per il worker pool.