Questa pagina è stata tradotta dall'API Cloud Translation.

Creare job

Questa pagina descrive come creare e aggiornare i job Cloud Run da un'immagine container esistente. A differenza di un servizio Cloud Run, che ascolta e gestisce le richieste, un job Cloud Run esegue solo le proprie attività ed esce al termine. Un job non ascolta né gestisce le richieste.

Dopo aver creato o aggiornato un job, puoi:

Esegui il job una tantum, in base a una pianificazione o nell'ambito di un flusso di lavoro.
Puoi eseguire l'override dei parametri configurati per un job quando lo esegui.
Puoi gestire le esecuzioni di singoli job e visualizzare i log di esecuzione.

Puoi strutturare un job come una singola attività o come più attività indipendenti (fino a 10.000) che possono essere eseguite in parallelo. Ogni compito esegue un'istanza di contenitore e può essere configurato per riprovare in caso di errore. Ogni attività è consapevole del proprio indice, che viene memorizzato nella variabile di ambiente CLOUD_RUN_TASK_INDEX. Il conteggio complessivo delle attività viene memorizzato nella variabile di ambiente CLOUD_RUN_TASK_COUNT. Se stai elaborando dati in parallelo, è compito del tuo codice determinare quale attività gestisce quale sottoinsieme di dati.

Puoi impostare i timeout per le attività e specificare il numero di nuovi tentativi in caso di fallimento. Se un'attività supera il numero massimo di nuovi tentativi, viene contrassegnata come non riuscita. Se alcune attività non sono riuscite, l'esecuzione del job viene contrassegnata come non riuscita dopo che Cloud Run ha provato tutte le attività.

Per impostazione predefinita, ogni attività viene eseguita per un massimo di 10 minuti. Puoi modificare il valore predefinito modificando l'impostazione del timeout dell'attività, fino a un massimo di 168 ore (7 giorni). Il supporto per i timeout superiori a 24 ore è disponibile in Anteprima.

Non è previsto un timeout esplicito per un'esecuzione di job: al termine di tutte le attività, l'esecuzione del job è completata.

I job utilizzano l'ambiente di esecuzione di seconda generazione.

Ruoli obbligatori

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

Cloud Run Developer (roles/run.developer) nel job Cloud Run
Utente account di servizio (roles/iam.serviceAccountUser) nell'identità di servizio
Artifact Registry Reader (roles/artifactregistry.reader) nel repository Artifact Registry delle immagini container del job

Per un elenco dei ruoli e delle autorizzazioni IAM associati a Cloud Run, consulta Ruoli IAM di Cloud Run e Autorizzazioni IAM di Cloud Run. Se il tuo job Cloud Run si interfaccia con le APIGoogle Cloud , ad esempio le librerie client di Cloud, consulta la guida alla configurazione dell'identità di servizio. Per ulteriori informazioni sulla concessione dei ruoli, consulta le autorizzazioni di deployment e gestisci l'accesso.

Immagini e registry dei container supportati

Puoi utilizzare direttamente le immagini container archiviate in Artifact Registry o Docker Hub. Google consiglia di utilizzare Artifact Registry.

Puoi utilizzare immagini container di altri registri pubblici o privati (come JFrog Artifactory, Nexus o GitHub Container Registry) configurando un repository remoto Artifact Registry.

Ti consigliamo di utilizzare Docker Hub solo per il deployment di immagini container popolari come le immagini ufficiali Docker o le immagini OSS sponsorizzate da Docker. Per una maggiore disponibilità, Google consiglia di eseguire il deployment di queste immagini di Docker Hub tramite un repository remoto Artifact Registry.

Cloud Run non supporta i livelli di immagini container di dimensioni superiori a 9,9 GB quando esegui il deployment da Docker Hub o da un repository remoto Artifact Registry con un registry esterno.

Crea un nuovo job

Puoi creare un nuovo job utilizzando la console Google Cloud, Google Cloud CLI, YAML o Terraform.

Console

Per creare un nuovo job:

Nella console Google Cloud, vai alla pagina Cloud Run:

Vai a Cloud Run
Fai clic su Esegui il deployment del contenitore e seleziona Job per visualizzare il modulo Crea job.
1. Nel modulo, specifica l'immagine del contenitore contenente il codice del job o seleziona un'opzione da un elenco di container di cui è stato eseguito il deployment in precedenza.
2. Il nome del job viene generato automaticamente dall'immagine del contenitore. Puoi modificare o cambiare il nome del job in base alle 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 di regioni evidenzia le regioni con impatto sul carbonio più basso.
4. Specifica il numero di attività da eseguire nel job. Affinché il job riesca, tutte le attività devono avere esito positivo. Per impostazione predefinita, le attività vengono eseguite in parallelo.
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 valore minimo richiesto, 512 MiB.
2. Nel menu CPU, specifica la quantità di CPU richiesta. Il valore predefinito è il valore minimo richiesto, 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 nelle attività. Il valore predefinito è 3 tentativi.
- In Parallelismo:
  1. Nella maggior parte dei casi puoi selezionare Esegui contemporaneamente 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.
(Facoltativo) Configura altre impostazioni nelle schede appropriate:
Al termine della configurazione del job, fai clic su Crea per creare il job in Cloud Run.
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 job:

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 del container, ad esempio us-docker.pkg.dev/cloudrun/container/job:latest.

Se vuoi, 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, oltre 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 un'attività non riesce oltre questo limite, l'intero job viene contrassegnato come non riuscito. Ad esempio, se impostato su 1, verrà tentato un nuovo tentativo per un'attività non riuscita una volta, per un totale di due tentativi. Il valore predefinito è 3. Accetta numeri interi da 0 a 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 Parallelisimo.
`--execute-now`	Se impostato, viene avviata un'esecuzione del job immediatamente dopo la creazione del job. Equivalente a chiamare `gcloud run jobs create` seguito da `gcloud run jobs execute`.

Oltre alle opzioni sopra indicate, puoi specificare anche altre configurazioni, ad esempio variabili di ambiente o 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.

Attendi il completamento della creazione del job. Al termine dell'operazione, verrà visualizzato un messaggio di conferma.
Per eseguire il job, consulta Eseguire job o Eseguire job in base a una pianificazione.

YAML

Puoi memorizzare la specifica del job in un file YAML ed eseguirne il deployment utilizzando la CLI gcloud.

Crea un nuovo file job.yaml con i seguenti 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 massimo 49 caratteri e devono essere univoci per regione e progetto.
- IMAGE con l'URL dell'immagine del container del job.
Puoi anche specificare ulteriori configurazioni, ad esempio variabili di ambiente o limiti di memoria.
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.

Per creare un nuovo job Cloud Run, utilizza la risorsa google_cloud_run_v2_job e modifica il file main.tf come mostrato nel seguente snippet.

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:

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 possiede le 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. All'interno di 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 del contenitore 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.

Località Cloud Run

Cloud Run è un servizio a livello di regione, il che significa che l'infrastruttura che gestisce i tuoi servizi Cloud Run si trova in una regione specifica ed è gestita da Google in modo da essere disponibile in modo ridondante in tutte le zone all'interno della regione.

Soddisfare i requisiti di latenza, disponibilità o durabilità è uno dei fattori principali per selezionare la regione in cui vengono eseguiti i servizi Cloud Run. In genere puoi selezionare la regione più vicina ai tuoi utenti, ma devi prendere in considerazione la posizione degli altri Google Cloud prodotti utilizzati dal tuo servizio Cloud Run. L'utilizzo Google Cloud congiunto di più prodotti in più località può influire sulla latenza e sul costo del servizio.

Cloud Run è disponibile nelle seguenti regioni:

Soggetto ai prezzi di Livello 1

asia-east1 (Taiwan)
asia-northeast1 (Tokyo)
asia-northeast2 (Osaka)
asia-south1 (Mumbai, India)
europe-north1 (Finlandia) Bassi livelli di CO₂
europe-southwest1 (Madrid) Basso livello di CO₂
europe-west1 (Belgio) Bassi livelli di CO₂
europe-west4 (Paesi Bassi) Bassi livelli di CO₂
europe-west8 (Milano)
europe-west9 (Parigi) Bassi livelli di CO₂
me-west1 (Tel Aviv)
us-central1 (Iowa) Bassi livelli di CO₂
us-east1 (Carolina del Sud)
us-east4 (Virginia del Nord)
us-east5 (Columbus)
us-south1 (Dallas) Bassi livelli di CO₂
us-west1 (Oregon) Bassi livelli di CO₂

Soggetto ai prezzi di Livello 2

africa-south1 (Johannesburg)
asia-east2 (Hong Kong)
asia-northeast3 (Seul, Corea del Sud)
asia-southeast1 (Singapore)
asia-southeast2 (Giacarta)
asia-south2 (Delhi, India)
australia-southeast1 (Sydney)
australia-southeast2 (Melbourne)
europe-central2 (Varsavia, Polonia)
europe-west10 (Berlino) Bassi livelli di CO₂
europe-west12 (Torino)
europe-west2 (Londra, Regno Unito) Bassi livelli di CO₂
europe-west3 (Francoforte, Germania) Bassi livelli di CO₂
europe-west6 (Zurigo, Svizzera) Bassi livelli di CO₂
me-central1 (Doha)
me-central2 (Dammam)
northamerica-northeast1 (Montreal) Bassi livelli di CO₂
northamerica-northeast2 (Toronto) Bassi livelli di CO₂
southamerica-east1 (San Paolo, Brasile) Bassi livelli di CO₂
southamerica-west1 (Santiago, Cile) Bassi livelli di CO₂
us-west2 (Los Angeles)
us-west3 (Salt Lake City)
us-west4 (Las Vegas)

Se hai già creato un servizio Cloud Run, puoi visualizzare la regione nella dashboard di Cloud Run nella console Google Cloud.

Quando crei un nuovo job, l'agente di servizio Cloud Run deve essere in grado di accedere al contenitore, il che accade per impostazione predefinita.

Aggiornare un job esistente

La modifica di qualsiasi impostazione di configurazione richiede l'aggiornamento del job, anche se l'immagine del contenitore non viene modificata. Tieni presente che per le impostazioni non modificate continueranno a essere utilizzate le impostazioni precedenti.

Puoi aggiornare un job esistente utilizzando la console Google Cloud, Google Cloud CLI, YAML o Terraform.

Console

Per aggiornare un job esistente:

Nella console Google Cloud, vai alla pagina Cloud Run:

Vai a Cloud Run
Fai clic sulla scheda Job per visualizzare l'elenco dei job.
Fai clic sul job per visualizzare la pagina Dettagli job.
Fai clic su Modifica.
Se hai apportato modifiche al codice del job, specifica il nuovo digest dell'immagine del contenitore.
Se necessario, modifica il numero di attività nel job.
Se vuoi, fai clic su Container, volumi, networking, sicurezza per aggiornare eventuali proprietà aggiuntive del job:
- In Capacità dell'attività:
1. Nel menu Memoria, specifica la quantità di memoria richiesta. Il valore predefinito è il valore minimo richiesto, 512 MiB.
2. Nel menu CPU, specifica la quantità di CPU richiesta. Il valore predefinito è il valore minimo richiesto, 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 nelle attività. Il valore predefinito è 3 tentativi.
- In Parallelismo:
  1. Nella maggior parte dei casi puoi selezionare Esegui contemporaneamente 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.
(Facoltativo) Configura altre impostazioni nelle schede appropriate:
Al termine della configurazione del job, fai clic su Salva per creare il job in Cloud Run e attendi il completamento della creazione.
Per eseguire il job, consulta Eseguire job o Eseguire job in base a una pianificazione.

gcloud

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.

Esegui il comando:

gcloud run jobs update JOB_NAME

Sostituisci:

JOB_NAME con il nome del job da aggiornare.

Se vuoi, puoi sostituire OPTIONS con le seguenti opzioni:

Opzione	Descrizione
`--tasks`	Accetta numeri interi uguali o superiori 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, oltre 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 un'attività non riesce oltre questo limite, l'intero job viene contrassegnato come non riuscito. Ad esempio, se impostato su 1, verrà tentato un nuovo tentativo per un'attività non riuscita una volta, per un totale di due tentativi. Il valore predefinito è `3`. Accetta numeri interi da 0 a 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 Parallelisimo.

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

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

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

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 eventuali attributi secondari spec.template come necessario per aggiornare le impostazioni di configurazione, quindi esegui nuovamente il deployment:

Aggiorna la configurazione del job esistente:
```
gcloud run jobs replace job.yaml
```
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 su Terraform per:

Per ulteriori informazioni, consulta le opzioni della riga di comando terraform apply.

Librerie client

Per aggiornare un job esistente dal codice:

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 possieda le 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. All'interno di 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 da aggiornare.
IMAGE_URL con l'URL dell'immagine del contenitore 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.

Codice di esempio

Per esempi di codice che mostrano i job, consulta le guide di avvio rapido specifiche per lingua.

Esegui il deployment di più container in un job (sidecar)

In un deployment di job Cloud Run con più container (sidecar), esiste un container del job principale che incapsula la configurazione del job e uno o più container sidecar.

Puoi eseguire il deployment di un massimo di 10 container per istanza, incluso il container del job principale. Tutti i container all'interno di un'istanza condividono lo stesso spazio dei nomi di rete e possono condividere file utilizzando un volume condiviso in memoria.

Casi d'uso

I sidecar vengono comunemente utilizzati per i seguenti casi d'uso:

Recupera le metriche personalizzate dai job Cloud Run e inviale a un backend specificato scelto da te utilizzando agenti di raccolta come Prometheus o Opentelemetry.
Consentire alle applicazioni senza logica Hashicorp Vault integrata di utilizzare secret statici e dinamici provenienti da Vault utilizzando Vault sidecar.

Esegui il deployment di un job con container sidecar

Puoi eseguire il deployment di più sidecar in un job Cloud Run utilizzando la console Google Cloud, Google Cloud CLI o YAML.

Fai clic sulla scheda per le istruzioni relative allo strumento che preferisci.

Console

Nella console Google Cloud, vai alla pagina Cloud Run:

Vai a Cloud Run
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 la configurazione per visualizzare il modulo di modifica del job.
Per un nuovo job, fai clic su Esegui il deployment del contenitore e poi su Job. Fornisci il nome del job e l'URL dell'immagine del contenitore del job principale di cui vuoi eseguire il deployment.
Fai clic su Container, volumi, networking, sicurezza.
Nella scheda Modifica contenitore, configura il contenitore del job principale in base alle esigenze.
Fai clic su Aggiungi contenitore e configura un contenitore sidecar da aggiungere al contenitore del job principale. Se il sidecar dipende da un altro contenitore del servizio, indicalo nel menu a discesa Ordine di avvio del contenitore. Ripeti questo passaggio per ogni contenitore sidecar di cui stai eseguendo il deployment.
Fai clic su Crea per un nuovo servizio o su Aggiorna per un job esistente, quindi attendi il completamento del deployment.

gcloud

I parametri container in Google Cloud CLI sono in anteprima.

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.
Per eseguire il deployment di più contenitori in un job, esegui il seguente comando:
```
gcloud beta 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 di destinazione. Puoi omettere completamente questo parametro, ma se lo fai ti verrà richiesto il nome del job.
- JOB_CONTAINER_NAME con un nome per il contenitore del job principale.
- JOB_IMAGE con un riferimento all'immagine del contenitore del job principale, ad esempio us-docker.pkg.dev/cloudrun/container/job:latest.
- SIDECAR_CONTAINER_NAME con un nome per il contenitore sidecar, ad esempio sidecar.
- SIDECAR_IMAGE con un riferimento all'immagine del contenitore secondario.
Se vuoi configurare ogni contenitore nel comando di deployment, fornisci la configurazione di ciascun contenitore dopo i parametri container, ad esempio:
```
gcloud beta 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
```
Importante: quando utilizzi il flag --container, devi specificare tutti i flag non a livello di contenitore prima di quelli a livello di contenitore, altrimenti il comando di deployment non andrà a buon fine e verrà visualizzato un messaggio di errore in tal senso.
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 tuo job Cloud Run con sidecar. Crea un file denominato job.yaml contenente quanto segue:

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

Sostituisci:

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

Dopo aver aggiornato il file YAML per includere i container ingress e sidecar, esegui il deployment su Cloud Run utilizzando il comando:

gcloud run jobs replace job.yaml

Funzionalità disponibili per i deployment con sidecar

Puoi specificare l'ordine di avvio dei container all'interno di un deployment con più container se hai dipendenze che richiedono l'avvio di alcuni container prima di altri nel deployment.

Se hai contenitori che dipendono da altri contenitori, devi utilizzare i controlli di salute all'avvio nel tuo deployment. Se utilizzi i controlli di integrità, Cloud Run segue l'ordine di avvio dei container e ne controlla l'integrità, assicurandosi che ognuno superi il controllo prima di avviare il container successivo nell'ordine. Se non utilizzi i controlli di integrità, i container integri verranno avviati anche se i container di cui dipendono non sono in esecuzione.

Più container all'interno di un'unica istanza possono accedere a un volume in-memory condiviso, accessibile a ciascun container tramite i punti di montaggio che crei.

Passaggi successivi

Dopo aver creato o aggiornato un job, puoi: