Configurare i limiti della CPU per i job

Questa pagina descrive come specificare il numero di CPU da utilizzare per ogni istanza 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.

Impostare e aggiornare i limiti della CPU

Per impostazione predefinita, ogni istanza è limitata a 1 CPU. Puoi impostare uno qualsiasi dei valori mostrati nella tabella seguente.

Tabella CPU e memoria

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

CPU Memoria minima
1 512 MiB
2 512 MiB
4 2 GiB
6 4 GiB
8 4 GiB

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per configurare i job Cloud Run, chiedi all'amministratore di concederti i seguenti ruoli IAM:

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 le APIGoogle Cloud , come le librerie client Cloud, consulta la guida alla configurazione dell'identità del servizio. Per ulteriori informazioni sulla concessione dei ruoli, consulta Autorizzazioni di deployment e Gestire l'accesso.

Configura i limiti di 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 console Google Cloud , vai alla pagina dei job Cloud Run:

    Vai a Cloud Run

  2. Seleziona Job dal menu e fai clic su Deploy container per compilare la pagina iniziale delle impostazioni del job. Se stai configurando un job esistente, seleziona il job e poi fai clic su Visualizza e modifica la configurazione del job.

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

  4. Fai clic sulla scheda Generale.

    immagine

    • Seleziona il limite di CPU che preferisci dall'elenco a discesa. Seleziona un valore di 1, 2, 4, 6 o 8 CPU. I job richiedono almeno 1 CPU. (Consulta la tabella in Impostazione e aggiornamento dei limiti di 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 tuo lavoro
    • CPU con il limite di CPU desiderato. Specifica il valore 1, 2, 4, 6 o 8 CPU. I job richiedono almeno 1 CPU. (Consulta la tabella in Impostazione e aggiornamento dei limiti di 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 almeno 1 CPU. (Consulta la tabella in Impostazione e aggiornamento dei limiti di 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 che preferisci. Specifica il valore 1, 2, 4, 6 o 8 CPU. I job richiedono almeno 1 CPU. (Consulta la tabella in Impostazione e aggiornamento dei limiti di CPU per le impostazioni richieste.)

    Puoi anche specificare una configurazione più dettagliata, ad esempio variabili di ambiente o 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 risorsa google_cloud_run_v2_job 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 regione Google Cloud . 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 almeno 1 CPU. (Consulta la tabella in Impostazione e aggiornamento dei limiti di CPU per le impostazioni richieste.)

Visualizza le impostazioni della CPU

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

Console

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

    Vai ai job Cloud Run

  2. Fai clic sull'offerta di lavoro che ti interessa per aprire la pagina Dettagli offerta di lavoro.

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

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

gcloud

  1. Utilizza questo comando:

    gcloud run jobs describe JOB_NAME

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