Limiti di CPU

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

In questa pagina viene descritto anche come abilitare o disabilitare l'avvio CPU boost, una funzionalità che aumenta temporaneamente l'allocazione della CPU durante l'avvio dell'istanza per ridurre la latenza di avvio.

Impostare e aggiornare i limiti di CPU

Puoi impostare limiti di CPU per i servizi e i job Cloud Run.

Per impostazione predefinita, ogni istanza è limitata a 1 CPU. Puoi aumentarlo utilizzando qualsiasi valore intero fino a un massimo di 8 CPU.

CPU e memoria

Di seguito sono riportati i requisiti minimi di memoria per le CPU:

CPU	Memoria minima
4	2 GiB
6	3 GiB
8	4 GiB

In alternativa, solo per i servizi Cloud Run, se vuoi utilizzare meno di 1 CPU, puoi selezionare qualsiasi valore compreso tra 0,08 e 1, con incrementi di 0,01. Qualsiasi valore superiore a 1 deve essere un valore intero. Se utilizzi meno di 1 CPU, vengono applicati i seguenti requisiti:

Impostazione	Requisito
Memoria	È richiesto un minimo di 0,5 CPU per impostare un limite di memoria maggiore di 512 MiB. È richiesto almeno 1 CPU per impostare un limite di memoria superiore a 1 GiB.
Contemporaneità	La massimità massima deve essere impostata su `1`.
CPU allocata	L'allocazione della CPU deve essere impostata su CPU allocata solo durante l'elaborazione delle richieste.
Ambiente di esecuzione	Devi utilizzare l'ambiente di esecuzione di prima generazione.

Per i servizi Cloud Run

Qualsiasi modifica alla configurazione porta alla creazione di una nuova revisione. Le revisioni successive riceveranno automaticamente questa impostazione di configurazione, a meno che non apporti aggiornamenti espliciti per modificarla.

Puoi impostare i limiti di CPU utilizzando la console Google Cloud, la riga di comando gcloud o un file YAML quando crei un nuovo servizio o esegui il deployment di una nuova revisione:

Console

Vai a Cloud Run
Fai clic su Crea servizio se stai configurando un nuovo servizio in cui stai eseguendo il deployment. Se stai configurando un servizio esistente, fai clic sul servizio e poi su Modifica ed esegui il deployment di una nuova revisione.
Se stai configurando un nuovo servizio, compila la pagina delle impostazioni del servizio iniziale come preferisci, quindi fai clic su Container, Networking, Security per espandere la pagina di configurazione del servizio.
Fai clic sulla scheda Contenitore.
- Seleziona il limite di CPU desiderato 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. Per le impostazioni richieste, consulta la tabella nella sezione Impostazione e aggiornamento dei limiti della CPU.
Fai clic su Crea o Esegui il deployment.

Riga di comando

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

gcloud run services update SERVICE --cpu CPU

Sostituisci

SERVICE il nome del tuo servizio
CPU con il limite di CPU desiderato. Specifica il valore 1, 2, 4, 6 o 8 o le CPU oppure, per meno di 1 CPU, specifica un valore compreso tra 0,08 e meno di 1,00, con incrementi di 0,01. Per le impostazioni richieste, consulta la tabella nella sezione Impostazione e aggiornamento dei limiti della CPU.

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

gcloud run deploy --image IMAGE_URL --cpu CPU

Sostituisci

IMAGE_URL con un riferimento all'immagine container, ad esempio us-docker.pkg.dev/cloudrun/container/hello:latest. Quando utilizzi Artifact Registry, l'URL ha il formato: REGION-docker.pkg.dev/PROJECT_ID/REPO_NAME/PATH:TAG. .
CPU con il valore 1, 2, 4, 6 o 8 CPU, o per meno di 1 CPU, specifica un valore compreso tra 0,08 e meno di 1,00, con incrementi di 0,01. Per le impostazioni richieste, consulta la tabella nella sezione Impostazione e aggiornamento dei limiti della CPU.

YAML

Puoi scaricare e visualizzare le configurazioni di servizio esistenti utilizzando il comando gcloud run services describe --format export, che genera risultati puliti in formato YAML. Successivamente, potrai modificare i campi descritti di seguito e caricare il file YAML modificato utilizzando il comando gcloud run services replace. Assicurati di modificare solo i campi come documentato.

Per visualizzare e scaricare la configurazione:

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

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
- SERVICE con il nome del tuo servizio Cloud Run
- IMAGE_URL con un riferimento all'immagine container, ad esempio us-docker.pkg.dev/cloudrun/container/hello:latest. Quando utilizzi Artifact Registry, l'URL ha il formato: REGION-docker.pkg.dev/PROJECT_ID/REPO_NAME/PATH:TAG.
- CPU con il valore desiderato per il limite di CPU. Specifica il valore 1, 2, 4, 6 o 8 o le CPU oppure, per meno di 1 CPU, specifica un valore compreso tra 0,08 e meno di 1,00, con incrementi di 0,01. Per le impostazioni richieste, consulta la tabella nella sezione Impostazione e aggiornamento dei limiti della CPU.
- REVISION con un nuovo nome di revisione o eliminalo (se presente). Se fornisci un nuovo nome della revisione, deve soddisfare i seguenti criteri:
  - Inizia con SERVICE-
  - Contiene solo lettere minuscole, numeri e -
  - Non termina con -
  - Non superare i 63 caratteri.
Sostituisci il servizio con la nuova configurazione utilizzando il seguente comando:
```
gcloud run services replace service.yaml
```

Terraform

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

Aggiungi quanto segue a una risorsa google_cloud_run_service nella configurazione di Terraform, in template.spec.containers. Sostituisci 1000m con il numero di CPU desiderato.

run/container_template/main.tf

Visualizza su GitHub Feedback

resources {
  limits = {
    # CPU usage limit
    # https://cloud.google.com/run/docs/configuring/cpu
    cpu = "1000m" # 1 vCPU

    # Memory usage limit (per container)
    # https://cloud.google.com/run/docs/configuring/memory-limits
    memory = "512Mi"
  }
}

Per job Cloud Run

Devi impostare almeno 1 CPU per un job Cloud Run.

Per specificare la CPU per un job Cloud Run:

Console

Vai a Cloud Run
Se stai configurando un nuovo job, fai clic sulla scheda Job e compila la pagina delle impostazioni del job iniziale come preferisci. Se stai configurando un job esistente, fai clic sul job e poi su Modifica.
Fai clic su Container, variabili e secret, connessioni, sicurezza per espandere la pagina delle proprietà del job.
Fai clic sulla scheda Generale.
- Seleziona il limite di CPU desiderato dall'elenco a discesa. Seleziona un valore di CPU 1, 2, 4, 6 o 8. I job richiedono almeno 1 CPU. Per le impostazioni richieste, consulta la tabella nella sezione Impostazione e aggiornamento dei limiti della CPU.
Fai clic su Crea o Aggiorna.

Riga di comando

Aggiorna i limiti di 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 1CPU, 2, 4, 6 o 8. I job richiedono almeno 1 CPU. Per le impostazioni richieste, consulta la tabella nella sezione Impostazione e aggiornamento dei limiti della CPU.
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 con 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 1CPU, 2, 4, 6 o 8. I job richiedono almeno 1 CPU. Per le impostazioni richieste, consulta la tabella nella sezione Impostazione e aggiornamento dei limiti della CPU.

YAML

Scarica e visualizza la configurazione del job esistente utilizzando il comando gcloud run jobs describe --format export, che genera risultati puliti in formato YAML. Successivamente, modifica i campi descritti di seguito e carica il file YAML modificato utilizzando il comando gcloud run jobs replace. Assicurati di modificare solo i campi come documentato.

Per visualizzare e scaricare la configurazione:

gcloud run jobs describe JOB_NAME --format export > job.yaml

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 1CPU, 2, 4, 6 o 8 CPU. I job richiedono almeno 1 CPU. Per le impostazioni richieste, consulta la tabella nella sezione Impostazione e aggiornamento dei limiti della CPU.

Puoi anche specificare altre configurazioni come variabili di ambiente o limiti di memoria.
Aggiorna la configurazione del job esistente:
```
gcloud run jobs replace job.yaml
```

Imposta il boosting della CPU all'avvio (servizi)

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

L'aumento effettivo della CPU varia in base alle impostazioni del limite della CPU:

Limite CPU	CPU potenziata
0-1	2
2	4
4	8
6	8
8	8

Ti viene addebitata la CPU incrementata allocata per la durata del tempo di avvio del container. Ad esempio, se il tempo di avvio del tuo container è di 15 secondi e assegni 2 CPU, con il boosting della CPU all'avvio, ti verranno addebitati 4 CPU durante il tempo di avvio dell'istanza (forse più breve), inclusi i 10 secondi dopo l'avvio del container e 2 CPU per il resto del ciclo di vita del container.

Puoi abilitare o disabilitare il boosting della CPU all'avvio utilizzando la console Google Cloud o Google Cloud CLI.

Console

Vai a Cloud Run
Fai clic su Crea servizio se stai configurando un nuovo servizio in cui stai eseguendo il deployment. Se stai configurando un servizio esistente, fai clic sul servizio e poi su Modifica ed esegui il deployment di una nuova revisione.
Se stai configurando un nuovo servizio, compila la pagina delle impostazioni del servizio iniziale come preferisci, quindi fai clic su Container, Networking, Security per espandere la pagina di configurazione del servizio.
Fai clic sulla scheda Contenitore.
- Per attivare il boosting della CPU all'avvio, seleziona la casella di controllo Boost della CPU all'avvio. Per disattivare questa funzionalità, deseleziona la casella di controllo.
Fai clic su Crea o Esegui il deployment.

Riga di comando

Puoi attivare il boost 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 tuo servizio

Puoi abilitare 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. Quando utilizzi Artifact Registry, l'URL ha il formato: REGION-docker.pkg.dev/PROJECT_ID/REPO_NAME/PATH:TAG. .
Puoi disabilitare l'incremento di 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 tuo 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

Per visualizzare e scaricare la configurazione:

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

Aggiorna l'attributo run.googleapis.com/startup-cpu-boost specificando 'true' per abilitare 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 tuo servizio Cloud Run

Sostituisci il servizio con la nuova configurazione utilizzando il seguente comando:
```
gcloud run services replace service.yaml
```

Visualizza impostazioni CPU

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

Console

Vai a Cloud Run
Fai clic sul servizio che ti interessa per aprire la pagina Dettagli del servizio.
Fai clic sulla scheda Revisioni.
Nel riquadro dei dettagli a destra, l'impostazione della CPU è elencata nella scheda Container.

Riga di comando

Utilizza il comando seguente:
```
gcloud run services describe SERVICE
```
Individua l'impostazione della CPU nella configurazione restituita.

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

Console

Vai ai job Cloud Run
Fai clic sul job che ti interessa per aprire la pagina Dettagli job.
Fai clic sulla scheda Configuration (Configurazione).
Individua l'impostazione della CPU nei dettagli di configurazione.

Riga di comando

Utilizza il comando seguente:
```
gcloud run jobs describe JOB_NAME
```
Individua l'impostazione della CPU nella configurazione restituita.