Configurare i limiti della CPU per i job

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 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 è 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	È necessario un minimo di 0,5 vCPU per impostare un limite di memoria maggiore di 512 MiB. È necessario un minimo di 1 vCPU per impostare un limite di memoria maggiore di 1 GiB.
Concorrenza	Il livello massimo di contemporaneità deve essere impostato su 1.
Fatturazione	Le impostazioni di fatturazione devono essere impostate sulla fatturazione basata sulle richieste.
Container	Devi eseguire il deployment di più container (sidecar).

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

• Cloud Run Developer (roles/run.developer) sul job 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 job 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 della CPU

Devi impostare un minimo di 1 CPU per un job Cloud Run.

Per specificare la CPU per un job Cloud Run:

Console

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

   Vai a Cloud Run

2. Fai clic su Esegui il deployment del container per compilare la pagina delle impostazioni iniziali del job. Se stai configurando un job esistente, selezionalo e fai clic su Visualizza e modifica la configurazione del job.

3. Fai clic su Container, connessioni, sicurezza per espandere la pagina delle proprietà del job.

4. Fai clic sulla scheda Generale.

   

   • Seleziona il limite di CPU desiderato dall'elenco a discesa. Seleziona un valore di 1, 2, 4, 6 o 8 CPU. I job richiedono un minimo di 1 CPU. (Consulta la tabella in Impostazione e aggiornamento dei limiti della CPU per le impostazioni richieste.)

5. Fai clic su Crea o Aggiorna.

gcloud

1. Aggiorna i limiti della CPU di un determinato job utilizzando il seguente comando:

   gcloud run jobs update JOB_NAME --cpu CPU

   Sostituisci

   • JOB_NAME con il nome del job
   • CPU con il limite di CPU desiderato. Specifica il valore 1, 2, 4, 6 o 8 CPU. I job richiedono un minimo di 1 CPU. (Consulta la tabella in Impostazione e aggiornamento dei limiti della CPU per le impostazioni richieste.)

   Puoi anche impostare la CPU quando crei un job utilizzando il comando:

   gcloud run jobs create JOB_NAME --image IMAGE_URL --cpu CPU

   Sostituisci

   • JOB_NAME con il nome del job.
   • IMAGE_URL: un riferimento all' immagine container, ad esempio us-docker.pkg.dev/cloudrun/container/job:latest.
   • CPU con il limite di CPU desiderato. Specifica il valore 1, 2, 4, 6 o 8 CPU. I job richiedono un minimo di 1 CPU. (Consulta la tabella in Impostazione e aggiornamento dei limiti della CPU per le impostazioni richieste.)

YAML

1. 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

2. Aggiorna l'attributo cpu:

   apiVersion: run.googleapis.com/v1
   kind: Job
   metadata:
     name: JOB
   spec:
     template:
       spec:
         template:
           spec:
             containers:
             - image: IMAGE
             resources:
               limits:
                 cpu: CPU

   Sostituisci CPU con il limite di CPU desiderato. Specifica il valore 1, 2, 4, 6 o 8 CPU. I job richiedono un minimo di 1 CPU. (Consulta la tabella in Impostazione e aggiornamento dei limiti della CPU per le impostazioni richieste.)

   Puoi anche specificare altre configurazioni, come le variabili di ambiente o i limiti di memoria.

3. Aggiorna la configurazione del job esistente:

   gcloud run jobs replace job.yaml

Terraform

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

Aggiungi quanto segue a una google_cloud_run_v2_job risorsa nella configurazione Terraform:

  resource "google_cloud_run_v2_job" "default" {
    name     = "cloudrun-job"
    location = "REGION"
    deletion_protection = false

    template {
      template {
        containers {
          image = "us-docker.pkg.dev/cloudrun/container/job"
          resources {
            limits = {
              cpu    = "CPU"
            }
          }
        }
      }
    }
  }

Sostituisci:

• REGION con la Google Cloud regione. Ad esempio, europe-west1.
• CPU con il limite di memoria richiesto dal servizio. Specifica il valore 1, 2, 4, 6 o 8 CPU. I job richiedono un minimo di 1 CPU. (Consulta la tabella in Impostazione e aggiornamento dei limiti della CPU per le impostazioni richieste.)

Visualizzare le impostazioni della CPU

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

Console

1. Nella Google Cloud console, vai alla pagina dei job Cloud Run:

   Vai ai job Cloud Run

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

3. Fai clic su Visualizza e modifica la configurazione del job.

4. Individua l'impostazione della CPU nei dettagli della configurazione.

gcloud

1. Utilizza il seguente comando:

   gcloud run jobs describe JOB_NAME

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