Creare job

Console

Per creare un nuovo lavoro:

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

   Vai a Cloud Run

2. Seleziona Job dal menu e fai clic su Deploy container per visualizzare il modulo Crea job.

   1. Nel modulo, specifica l'immagine container contenente il codice del job o seleziona un'immagine da un elenco di container di cui è stato eseguito il deployment in precedenza.
   2. Il nome del job viene generato automaticamente dall'immagine container. Puoi modificare o cambiare il nome del job in base alle tue esigenze. Il nome di un job non può essere modificato dopo la creazione.
   3. Seleziona la regione in cui vuoi che si trovi il job. Il selettore delle regioni evidenzia le regioni con l'impatto delle emissioni di carbonio più basso.
   4. Specifica il numero di attività da eseguire nel job. Tutte le attività devono avere esito positivo affinché il job riesca. Per impostazione predefinita, le attività vengono eseguite in parallelo.

3. Fai clic su Container, volumi, networking, sicurezza per impostare proprietà aggiuntive del job.

   • In Capacità dell'attività:
   1. Nel menu Memoria, specifica la quantità di memoria richiesta. Il valore predefinito è il minimo richiesto, ovvero 512 MiB.
   2. Nel menu CPU, specifica la quantità di CPU richiesta. Il valore predefinito è il minimo richiesto, ovvero 1 CPU.

   3. In Timeout attività, specifica il periodo di tempo massimo in secondi durante il quale l'attività può essere eseguita, fino a 168 ore (7 giorni). Il supporto per i timeout superiori a 24 ore è disponibile in anteprima. Ogni attività deve essere completata entro questo periodo di tempo. Il valore predefinito è 10 minuti (600 secondi).

   4. In Numero di nuovi tentativi per attività non riuscita, specifica il numero di nuovi tentativi in caso di errori dell'attività. Il valore predefinito è 3 tentativi.

   • In Parallelismo:

     1. Nella maggior parte dei casi puoi selezionare Esegui simultaneamente il maggior numero di attività possibile.
     2. Se devi impostare un limite inferiore a causa di vincoli di scalabilità sulle risorse a cui accede il job, seleziona Limita il numero massimo di attività simultanee e specifica il numero di attività simultanee nel campo Limite di parallelismo personalizzato.

4. (Facoltativo) Configura altre impostazioni nelle schede appropriate:

   • Configurazione del container
   • Limiti di CPU
   • Limiti di memoria
   • Secret
   • Variabili di ambiente
   • Etichette
   • Service account
   • Connessioni Cloud SQL
   • Connettività VPC

5. Al termine della configurazione del job, fai clic su Crea per crearlo in Cloud Run.

6. Per eseguire il job, consulta Eseguire job o Eseguire job in base a una pianificazione.

gcloud

Per utilizzare la riga di comando, devi aver già configurato gcloud CLI.

Per creare un nuovo lavoro:

1. Esegui il comando:

   gcloud run jobs create JOB_NAME --image IMAGE_URL OPTIONS

   In alternativa, utilizza il comando di deployment:

   gcloud run jobs deploy JOB_NAME --image IMAGE_URL OPTIONS

   • Sostituisci JOB_NAME con il nome del job che vuoi creare. Se ometti questo parametro, ti verrà chiesto il nome del job quando esegui il comando.
   • Sostituisci IMAGE_URL con un riferimento all'immagine container, ad esempio us-docker.pkg.dev/cloudrun/container/job:latest.

   • (Facoltativo) Sostituisci OPTIONS con una delle seguenti opzioni:

     Opzione	Descrizione
     --tasks	Accetta numeri interi maggiori o uguali a 1. Il valore predefinito è 1; il valore massimo è 10.000. A ogni attività vengono fornite le variabili di ambiente CLOUD_RUN_TASK_INDEX con un valore compreso tra 0 e il numero di attività meno 1, insieme a CLOUD_RUN_TASK_COUNT, che è il numero di attività
     --max-retries	Il numero di volte in cui viene eseguito un nuovo tentativo per un'attività non riuscita. Se una qualsiasi attività non riesce a superare questo limite, l'intero job viene contrassegnato come non riuscito. Ad esempio, se impostato su 1, un'attività non riuscita verrà ritentata una volta, per un totale di due tentativi. Il valore predefinito è 3. Accetta numeri interi compresi tra 0 e 10.
     --task-timeout	Accetta una durata come "2s". Il valore predefinito è 10 minuti; il massimo è 168 ore (7 giorni). Il supporto per i timeout superiori a 24 ore è disponibile in anteprima.
     --parallelism	Il numero massimo di attività che possono essere eseguite in parallelo. Per impostazione predefinita, le attività verranno avviate il più rapidamente possibile in parallelo. Per l'intervallo di valori, consulta la sezione Parallelismo.
     --execute-now	Se impostata, immediatamente dopo la creazione del job viene avviata un'esecuzione del job. Equivalente a chiamare il numero gcloud run jobs create seguito da gcloud run jobs execute.

     Oltre alle opzioni precedenti, puoi specificare anche altre configurazioni, come le variabili di ambiente o i limiti di memoria.

     Per un elenco completo delle opzioni disponibili durante la creazione di un job, consulta la documentazione della riga di comando gcloud run jobs create.

2. Attendi il completamento della creazione del job. Al termine dell'operazione, verrà visualizzato un messaggio di conferma.

3. Per eseguire il job, consulta Eseguire job o Eseguire job in base a una pianificazione.

YAML

Puoi archiviare la specifica del job in un file YAML e poi eseguirne il deployment utilizzando gcloud CLI.

1. Crea un nuovo file job.yaml con questi contenuti:

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

   Sostituisci

   • JOB con il nome del tuo job Cloud Run. I nomi dei job devono contenere al massimo 49 caratteri e devono essere univoci per regione e progetto.
   • IMAGE con l'URL dell'immagine container del job.

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

2. Esegui il deployment del nuovo job utilizzando il seguente comando:

   gcloud run jobs replace job.yaml

Terraform

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

resource "google_cloud_run_v2_job" "default" {
  name     = "cloud-run-job"
  location = "us-central1"

  deletion_protection = false # set to "true" in production

  template {
    template {
      containers {
        image = "us-docker.pkg.dev/cloudrun/container/job:latest"
      }
    }
  }
}

Librerie client

Per creare un job dal codice:

• Go
• Java
• Node.js
• Python
• Ruby
• PHP
• .NET

API REST

Per creare un job, invia una richiesta HTTP POST all'endpoint jobs dell'API Cloud Run Admin.

Ad esempio, utilizzando curl:

curl -H "Content-Type: application/json" \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -X POST \
  -d '{template: {template: {containers: [{image: "IMAGE_URL"}]}}}' \
  https://run.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/jobs?jobId=JOB_NAME

Sostituisci:

• ACCESS_TOKEN con un token di accesso valido per un account che dispone delle autorizzazioni IAM per creare job. Ad esempio, se hai eseguito l'accesso a gcloud, puoi recuperare un token di accesso utilizzando gcloud auth print-access-token. Da un'istanza container Cloud Run, puoi recuperare un token di accesso utilizzando il server di metadati dell'istanza container.
• JOB_NAME con il nome del job che vuoi creare.
• IMAGE_URL con l'URL dell'immagine container del job, ad esempio, us-docker.pkg.dev/cloudrun/container/job:latest.
• REGION con la Google Cloud regione del lavoro.
• PROJECT_ID con l' Google Cloud ID progetto.

Console

Per aggiornare un job esistente:

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

   Vai a Cloud Run

2. Fai clic sulla scheda Job per visualizzare l'elenco dei job.

3. Fai clic sul job per visualizzare la pagina Dettagli job.

4. Fai clic su Modifica.

5. Se hai apportato modifiche al codice del lavoro, specifica il nuovo digest dell'immagine del container.

6. Se necessario, modifica il numero di attività nel job.

7. (Facoltativo) Fai clic su Container, volumi, networking, sicurezza per aggiornare eventuali proprietà del job aggiuntive:

   • In Capacità dell'attività:
   1. Nel menu Memoria, specifica la quantità di memoria richiesta. Il valore predefinito è il minimo richiesto, ovvero 512 MiB.
   2. Nel menu CPU, specifica la quantità di CPU richiesta. Il valore predefinito è il minimo richiesto, ovvero 1 CPU.
   3. In Timeout attività, specifica il periodo di tempo massimo in secondi durante il quale l'attività può essere eseguita, fino a 168 ore (7 giorni). Il supporto per i timeout superiori a 24 ore è disponibile in anteprima. Ogni attività deve essere completata entro questo periodo di tempo. Il valore predefinito è 10 minuti (600 secondi).
   4. In Numero di nuovi tentativi per attività non riuscita, specifica il numero di nuovi tentativi in caso di errori dell'attività. Il valore predefinito è 3 tentativi.

   • In Parallelismo:

     1. Nella maggior parte dei casi puoi selezionare Esegui simultaneamente il maggior numero di attività possibile.
     2. Se devi impostare un limite inferiore a causa di vincoli di scalabilità sulle risorse a cui accede il job, seleziona Limita il numero di attività simultanee e specifica il numero massimo di attività simultanee nel campo Limite di parallelismo personalizzato.

8. (Facoltativo) Configura altre impostazioni nelle schede appropriate:

   • Configurazione del container
   • Limiti di CPU
   • Limiti di memoria
   • Secret
   • Variabili di ambiente
   • Etichette
   • Service account
   • Connessioni Cloud SQL
   • Connettività VPC

9. Al termine della configurazione del job, fai clic su Salva per creare il job in Cloud Run e attendere il completamento della creazione.

10. Per eseguire il job, consulta Eseguire job o Eseguire job in base a una pianificazione.

gcloud

1. In the Google Cloud console, activate Cloud Shell.

   Activate Cloud Shell

   At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.

2. Esegui il comando:

   gcloud run jobs update JOB_NAME

   Sostituisci:

   • JOB_NAME con il nome del job che vuoi aggiornare.

   • (Facoltativo) Sostituisci OPTIONS con le seguenti opzioni:

     Opzione	Descrizione
     --tasks	Accetta numeri interi maggiori o uguali a 1. Il valore predefinito è 1; il valore massimo è 10.000. A ogni attività vengono fornite le variabili di ambiente CLOUD_RUN_TASK_INDEX con un valore compreso tra 0 e il numero di attività meno 1, insieme a CLOUD_RUN_TASK_COUNT, che è il numero di attività
     --max-retries	Il numero di volte in cui viene eseguito un nuovo tentativo per un'attività non riuscita. Se una qualsiasi attività non riesce a superare questo limite, l'intero job viene contrassegnato come non riuscito. Ad esempio, se impostato su 1, un'attività non riuscita verrà ritentata una volta, per un totale di due tentativi. Il valore predefinito è 3. Accetta numeri interi compresi tra 0 e 10.
     --task-timeout	Accetta una durata come "2s". Il valore predefinito è 10 minuti; il massimo è 168 ore (7 giorni). Il supporto per i timeout superiori a 24 ore è disponibile in anteprima.
     --parallelism	Il numero massimo di attività che possono essere eseguite in parallelo. Per impostazione predefinita, le attività verranno avviate il più rapidamente possibile, in parallelo. Per l'intervallo di valori, consulta la sezione Parallelismo.

   Oltre alle opzioni precedenti, puoi impostare altre impostazioni di configurazione facoltative:

   • Configurazione del container
   • Limiti di CPU
   • Limiti di memoria
   • Secret
   • Variabili di ambiente
   • Etichette
   • Service account
   • Connessioni Cloud SQL
   • Connessione VPC

   Per un elenco completo delle opzioni disponibili durante la creazione di un job, consulta la documentazione della riga di comando gcloud run jobs create.

3. Attendi il completamento dell'aggiornamento del job. Al termine, viene visualizzato un messaggio di operazione riuscita simile al seguente:

   Job [JOB_NAME] has been successfully updated.
   View details about this job by running `gcloud run jobs describe JOB_NAME`.
   See logs for this execution at: https://console.cloud.google.com/logs/viewer?project=PROJECT_ID&resource=cloud_run_revision/service_name/JOB_NAME

4. Per eseguire il job, consulta Eseguire job o Eseguire job in base a una pianificazione.

YAML

Se devi scaricare o visualizzare la configurazione di un job esistente, utilizza il seguente comando per salvare i risultati in un file YAML:

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

Da un file YAML di configurazione del job, modifica gli attributi secondari spec.template in base alle esigenze per aggiornare le impostazioni di configurazione, quindi esegui di nuovo il deployment:

1. Aggiorna la configurazione del job esistente:

   gcloud run jobs replace job.yaml

2. Per eseguire il job, consulta Eseguire job o Eseguire job in base a una pianificazione.

Terraform

Apporta modifiche alla configurazione del job nel file main.tf utilizzando il comando terraform apply. Sono disponibili istruzioni dettagliate per Terraform per:

• Parallelismo
• Numero massimo di nuovi tentativi
• Timeout

Per saperne di più, consulta le opzioni della riga di comando terraform apply.

Librerie client

Per aggiornare un job esistente dal codice:

• Go
• Java
• Node.js
• Python
• Ruby
• PHP
• .NET

API REST

Per aggiornare un job, invia una richiesta HTTP PATCH all'endpoint jobs dell'API Cloud Run Admin.

Ad esempio, utilizzando curl:

curl -H "Content-Type: application/json" \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -X PATCH \
  -d '{template: {template: {containers: [{image: "IMAGE_URL"}]}}}' \
  https://run.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/jobs/JOB_NAME

Sostituisci:

• ACCESS_TOKEN con un token di accesso valido per un account che dispone delle autorizzazioni IAM per aggiornare i job. Ad esempio, se hai eseguito l'accesso a gcloud, puoi recuperare un token di accesso utilizzando gcloud auth print-access-token. Da un'istanza container Cloud Run, puoi recuperare un token di accesso utilizzando il server di metadati dell'istanza container.
• JOB_NAME con il nome del job che vuoi aggiornare.
• IMAGE_URL con l'URL dell'immagine container del job, ad esempio, us-docker.pkg.dev/cloudrun/container/job:latest.
• REGION con la Google Cloud regione del lavoro.
• PROJECT_ID con l' Google Cloud ID progetto.

Console

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

   Vai a Cloud Run

2. Per eseguire il deployment in un job esistente, fai clic su Job, individua il job nell'elenco dei job e fai clic per aprirlo, quindi fai clic su Visualizza e modifica configurazione per visualizzare il modulo di modifica del job.

3. Per un nuovo job, fai clic su Esegui il deployment del contenitore, quindi su Job. Fornisci il nome del job e l'URL dell'immagine del container del job principale di cui vuoi eseguire il deployment.

4. Fai clic su Container, volumi, networking, sicurezza.

5. Nella scheda Modifica contenitore, configura il contenitore del job principale in base alle esigenze.

6. Fai clic su Aggiungi contenitore e configura un contenitore sidecar che vuoi aggiungere insieme al contenitore principale del job. Se il sidecar dipende da un altro contenitore nel servizio, indicalo nel menu a discesa Ordine di avvio del contenitore. Ripeti questo passaggio per ogni contenitore sidecar che stai implementando.

7. Fai clic su Crea per un nuovo servizio o su Aggiorna per un job esistente, quindi attendi il completamento del deployment.

gcloud

1. In the Google Cloud console, activate Cloud Shell.

   Activate Cloud Shell

   At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.

2. Per eseguire il deployment di più container in un job, esegui questo comando:

   gcloud run jobs create JOB \
    --container JOB_CONTAINER_NAME \
    --image='JOB_IMAGE' \
    --container SIDECAR_CONTAINER_NAME \
    --image='SIDECAR_IMAGE'

   Sostituisci:

   • JOB con il nome del job in cui stai eseguendo il deployment. Puoi omettere completamente questo parametro, ma ti verrà chiesto il nome del job se lo ometti.
   • JOB_CONTAINER_NAME con un nome per il contenitore del job principale.
   • JOB_IMAGE con un riferimento all'immagine container del job principale, ad esempio us-docker.pkg.dev/cloudrun/container/job:latest.
   • SIDECAR_CONTAINER_NAME con un nome per il container sidecar, ad esempio sidecar.
   • SIDECAR_IMAGE con un riferimento all'immagine container sidecar.

   Se vuoi configurare ogni contenitore nel comando di deployment, fornisci la configurazione di ciascun contenitore dopo i parametri container, ad esempio:

   gcloud run jobs create JOB \
     --container CONTAINER_1_NAME \
     --image='JOB_IMAGE' \
     --set-env-vars=KEY=VALUE \
     --container SIDECAR_CONTAINER_NAME \
     --image='SIDECAR_IMAGE' \
     --set-env-vars=KEY_N=VALUE_N

3. Attendi il completamento del deployment dei job. Al termine dell'operazione, viene visualizzato un messaggio di operazione riuscita.

YAML

Queste istruzioni mostrano un file YAML di base per il job Cloud Run con i sidecar. Crea un file denominato job.yaml contenente quanto segue:

apiVersion: run.googleapis.com/v1
kind: Job
metadata:
  name: JOB
spec:
  template:
    spec:
      containers:
      - image: JOB_IMAGE
      - image: SIDECAR_IMAGE
      

Sostituisci:

• JOB con il nome del container del job principale di Cloud Run. I nomi dei job devono contenere al massimo 49 caratteri.
• JOB_IMAGE con un riferimento all'immagine container del job principale, ad esempio us-docker.pkg.dev/cloudrun/container/job:latest. Se vuoi, fornisci le voci di configurazione del contenitore necessarie dopo questa voce.
• SIDECAR_IMAGE con un riferimento all'immagine container sidecar. Se vuoi, fornisci le voci di configurazione del container necessarie dopo questa voce.Puoi specificare più sidecar aggiungendo altri elementi all'array containers nel file YAML.

Dopo aver aggiornato il file YAML in modo da includere i container Ingress e sidecar, esegui il deployment su Cloud Run utilizzando il comando:

gcloud run jobs replace job.yaml

Terraform

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

resource "google_cloud_run_v2_job" "default" {
  name     = "JOB_NAME"
  location = "europe-west1"

  template {
    template {
      containers {
        name = "CONTAINER_NAME"
        image = "IMAGE_URL"
      }
      containers {
        name = "SIDECAR_CONTAINER_NAME"
        image = "SIDECAR_IMAGE_URL"
      }
    }
  }
}

Sostituisci:

• JOB_NAME con il nome del tuo job Cloud Run.
• CONTAINER_NAME con il nome del contenitore.
• IMAGE_URL con un riferimento all'immagine container, ad esempio us-docker.pkg.dev/cloudrun/container/job:latest
• SIDECAR_CONTAINER_NAME con il nome del contenitore sidecar.
• SIDECAR_IMAGE_URL con un riferimento all'immagine del container sidecar.