Configura i limiti della CPU per i servizi

Questa pagina descrive anche come attivare o disattivare il boosting della CPU all'avvio, una funzionalità che aumenta temporaneamente l'allocazione di vCPU durante l'avvio dell'istanza per ridurre la latenza di avvio.

Impostare e aggiornare i limiti di vCPU

Per impostazione predefinita, ogni istanza è limitata a 1 vCPU. Puoi modificare questo valore con 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
0,08 vCPU Fino a 512 MiB
0,5 vCPU Fino a 1 GiB
1 vCPU Fino a 4 GiB
2 vCPU Fino 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 è 0,08 vCPU.

Se vuoi utilizzare meno di 1 vCPU, puoi selezionare qualsiasi valore compreso tra 0,08 e 1, con incrementi di 0,001.

Se utilizzi meno di 1 vCPU, vengono applicati i seguenti requisiti:

Impostazione Requisito
Memoria Per impostare un limite di memoria maggiore di 512 MiB è necessario un minimo di 0,5 vCPU.
Per impostare un limite di memoria maggiore di 1 GiB è necessario un minimo di 1 vCPU.
Concorrenza Il livello massimo di contemporaneità deve essere impostato su 1.
Fatturazione Le impostazioni di fatturazione devono essere impostate sulla fatturazione basata sulle richieste.
Ambiente di esecuzione Devi utilizzare l'ambiente di esecuzione di prima generazione.

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. Regola la configurazione della CPU in base alle necessità.

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

Puoi visualizzare i dati di riepilogo dei costi, i dati di utilizzo e i consigli per l'ottimizzazione dei costi delle risorse 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 di servizi Cloud Run, chiedi all'amministratore di concederti i seguenti ruoli IAM:

Se esegui il deployment di un servizio o funzione dal codice sorgente, devi disporre anche di ruoli aggiuntivi concessi al tuo progetto e al account di servizio Cloud Build.

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 servizio Cloud Run interagisce con le APIGoogle Cloud , 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 utilizzando la Google Cloud console, la riga di comando gcloud o un file YAML quando crei un nuovo servizio o esegui il deployment di una nuova revisione:

Console

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

    Vai a Cloud Run

  2. Seleziona Servizi dal menu di navigazione di Cloud Run e fai clic su Esegui il deployment del container per configurare un nuovo servizio. Se stai configurando un servizio esistente, fai clic sul servizio.

  3. Se stai configurando un nuovo servizio, compila la pagina delle impostazioni iniziali del servizio, poi fai clic su Container, networking, sicurezza per espandere la pagina di configurazione del servizio.

  4. Fai clic sulla scheda Container.

  5. Seleziona il limite di CPU dall'elenco a discesa, utilizzando Personalizzato se vuoi utilizzare meno di 1 CPU. Seleziona un valore di CPU 1, 2, 4, 6 o 8 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).

  6. Fai clic su Crea o Esegui il deployment.

gcloud

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

gcloud run services update SERVICE --cpu CPU

Sostituisci quanto segue:

  • SERVICE: il nome del servizio.
  • CPU: il limite di CPU desiderato. Specifica il valore di CPU 1, 2, 4, 6 o 8 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).

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

gcloud run deploy --image IMAGE_URL --cpu CPU

Sostituisci quanto segue:

  • IMAGE_URL: un riferimento all'immagine container, ad esempio us-docker.pkg.dev/cloudrun/container/hello:latest. Se utilizzi Artifact Registry, il repository REPO_NAME deve essere già stato creato. L'URL segue il formato di LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/PATH:TAG .
  • CPU: 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).

YAML

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

    gcloud run services describe SERVICE --format export > service.yaml

  2. Aggiorna l'attributo cpu:

    apiVersion: serving.knative.dev/v1
kind: Service
metadata:
  name: SERVICE
spec:
  template:
    metadata:
      name: REVISION
    spec:
      containers:
      - image: IMAGE
        resources:
          limits:
            cpu: CPU

    Sostituisci quanto segue:

    • SERVICE: il nome del servizio Cloud Run.
    • IMAGE_URL: un riferimento all'immagine container, ad esempio us-docker.pkg.dev/cloudrun/container/hello:latest. Se utilizzi Artifact Registry, il repository REPO_NAME deve essere già stato creato. L'URL segue il formato di LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/PATH:TAG .
    • CPU: il valore del limite di CPU desiderato. Specifica il valore di CPU 1, 2, 4, 6 o 8 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).
    • REVISION: un nuovo nome di revisione o eliminalo (se presente). Se fornisci un nuovo nome di revisione, questo deve soddisfare i seguenti criteri:
      • Inizia con SERVICE-
      • Contiene solo lettere minuscole, numeri e -
      • Non termina con un -
      • Non supera i 63 caratteri

  3. Crea o aggiorna il servizio utilizzando il seguente comando:

    gcloud run services replace service.yaml

    Per impostazione predefinita, il comando gcloud run services replace utilizza il file service.yaml, se presente.

Terraform

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

Aggiungi quanto segue a una google_cloud_run_v2_service risorsa nella configurazione Terraform:

resource "google_cloud_run_v2_service" "default" {
  name     = "cloudrun-service-cpu"
  location = "us-central1"

  deletion_protection = false # set to "true" in production

  template {
    containers {
      image = "us-docker.pkg.dev/cloudrun/container/hello"
      resources {
        limits = {
          # CPU usage limit
          cpu = "1"
        }
      }
    }
  }
}

La risorsa google_cloud_run_v2_service precedente specifica un limite di CPU in template.containers.resources.limits.

Sostituisci 1 con il numero di CPU che preferisci. Suggerimento: 1 corrisponde a 1 vCPU.

Impostare il boosting della CPU all'avvio

La funzionalità boosting della CPU all'avvio per le revisioni fornisce CPU aggiuntiva durante il tempo di avvio dell'istanza e per 10 secondi dopo l'avvio dell'istanza.

Il boosting effettivo della CPU varia a seconda delle impostazioni del limite di CPU:

Limite CPU CPU con boosting
0-1 2
2 4
4 8
6 8
8 8

Ti viene addebitato il costo della CPU con boosting allocata per la durata del tempo di avvio del container. Ad esempio, se il tempo di avvio del container è di 15 secondi e allochi 2 CPU, con il boosting della CPU all'avvio ti verranno addebitate 4 CPU durante il tempo di avvio dell'istanza (che potrebbe essere più breve), inclusi i 10 secondi dopo l'avvio del container, e 2 CPU per il resto del ciclo di vita del container.

Se il deployment di Cloud Run utilizza sidecar e attivi il boosting della CPU all'avvio, tutti i container ricevono il boosting della CPU. Cloud Run determina la quantità di CPU con boosting per ogni container in base al limite di CPU.

Puoi attivare o disattivare il boosting della CPU all'avvio utilizzando la Google Cloud console, Google Cloud CLI, un file YAML o un file Terraform.

Console

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

    Vai a Cloud Run

  2. Seleziona Servizi dal menu di navigazione di Cloud Run e fai clic su Esegui il deployment del container per configurare un nuovo servizio. Se stai configurando un servizio esistente, fai clic sul servizio.

  3. Se stai configurando un nuovo servizio, compila la pagina delle impostazioni iniziali del servizio, poi fai clic su Container, networking, sicurezza per espandere la pagina di configurazione del servizio.

  4. Fai clic sulla scheda Container.

  5. Per attivare il boosting della CPU all'avvio, seleziona la casella di controllo Boosting della CPU all'avvio. Per disattivare questa funzionalità, deseleziona la casella di controllo.

  6. Fai clic su Crea o Esegui il deployment.

gcloud

  1. Puoi attivare il boosting della CPU all'avvio per un determinato servizio utilizzando il seguente comando:

    gcloud run services update SERVICE --cpu-boost

    Sostituisci SERVICE con il nome del servizio.

    Puoi attivare il boosting della CPU all'avvio durante il deployment utilizzando il comando:

    gcloud run deploy --image IMAGE_URL --cpu-boost

    Sostituisci IMAGE_URL con un riferimento all'immagine container, ad esempio us-docker.pkg.dev/cloudrun/container/hello:latest. Se utilizzi Artifact Registry, il repository REPO_NAME deve essere già stato creato. L'URL segue il formato di LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/PATH:TAG .

  2. Puoi disattivare il boosting della CPU all'avvio per un determinato servizio utilizzando il seguente comando:

    gcloud run services update SERVICE --no-cpu-boost

    Sostituisci SERVICE con il nome del servizio.

    Puoi disattivare il boosting della CPU all'avvio durante il deployment utilizzando il comando:

    gcloud run deploy --image IMAGE_URL --no-cpu-boost

YAML

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

    gcloud run services describe SERVICE --format export > service.yaml

  2. Aggiorna l'attributo run.googleapis.com/startup-cpu-boost specificando 'true' per attivare il boosting della CPU all'avvio o 'false' per disattivarlo:

    apiVersion: serving.knative.dev/v1
kind: Service
metadata:
  name: SERVICE
spec:
  template:
    metadata:
      annotations:
        run.googleapis.com/startup-cpu-boost: 'true'

    Sostituisci SERVICE con il nome del servizio Cloud Run.

  3. Crea o aggiorna il servizio utilizzando il seguente comando:

    gcloud run services replace service.yaml

    Per impostazione predefinita, il comando gcloud run services replace utilizza il file service.yaml, se presente.

Terraform

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

Aggiungi quanto segue a una google_cloud_run_v2_service risorsa nella configurazione Terraform:
resource "google_cloud_run_v2_service" "default" {
  name     = "SERVICE"
  location = "REGION"

  template {
    containers {
      image = "us-docker.pkg.dev/cloudrun/container/hello"
      resources {
        startup_cpu_boost = CPU_BOOST
      }
    }
  }
}

Sostituisci quanto segue:

  • SERVICE: il nome del servizio Cloud Run.
  • REGION: la Google Cloud regione, ad esempio, europe-west1.
  • CPU_BOOST: true per attivare il boosting della CPU all'avvio o false per disattivarlo.

Scrivi

Per specificare i limiti di CPU nel file compose.yaml, aggiungi l'attributo cpus alla definizione del servizio.

  services:
    web:
      image: IMAGE
      cpus: CPU_VALUE

Sostituisci quanto segue:

  • IMAGE: l'URL dell'immagine container.
  • CPU_VALUE: il limite di CPU necessario, ad esempio 2.

Esegui il deployment dei servizi

  1. Per eseguire il deployment dei servizi, esegui il comando gcloud run compose up:

    gcloud run compose up compose.yaml

  2. Rispondi y a eventuali richieste di installazione dei componenti richiesti o di attivazione delle API.

  3. (Facoltativo) Rendi pubblico il servizio se vuoi consentire l'accesso non autenticato al servizio.

Dopo il deployment, viene visualizzato l'URL del servizio Cloud Run. Copia questo URL e incollalo nel browser per visualizzare il container in esecuzione. Puoi disattivare l'autenticazione predefinita dalla Google Cloud console.

Visualizzare le impostazioni della CPU

Per visualizzare le impostazioni della CPU correnti per il servizio Cloud Run:

Console

  1. Nella Google Cloud console, vai alla pagina Servizi di Cloud Run:

    Vai a Cloud Run

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

  3. Fai clic sulla scheda Cronologia delle revisioni.

  4. Nel riquadro dei dettagli a destra, l'impostazione della CPU è elencata nella scheda Container.

gcloud

  1. Utilizza il seguente comando:

    gcloud run services describe SERVICE

  2. Individua l'impostazione della CPU nella configurazione restituita.

Threading dell'applicazione e utilizzo della CPU

Quando selezioni un limite di CPU maggiore di 1 vCPU, tieni presente il modello di threading dell'applicazione. Durante la scalabilità automatica, Cloud Run utilizza l'utilizzo medio della CPU in tutte le CPU allocate. Se l'applicazione è a thread singolo, potrebbe utilizzare completamente solo un core, il che comporta un utilizzo medio della CPU basso anche sotto carico. Questo può impedire che la scalabilità automatica basata sulla CPU si verifichi come previsto.

Per evitare questo comportamento per un'applicazione a thread singolo, se i requisiti di memoria lo consentono, ti consigliamo di iniziare con 1 vCPU. In questo modo si ottiene una migliore scalabilità automatica basata sulla CPU. Se esigenze di memoria più elevate impongono una selezione multi-CPU per un'applicazione a thread singolo, valuta la possibilità di ottimizzare l'impostazione della concorrenza.