Questa pagina descrive come eseguire i job Cloud Run. L'esecuzione di un job crea un'esecuzione del job in cui tutte le attività devono essere completate correttamente affinché l'esecuzione del job riesca. Le esecuzioni dei job scrivono i log in Cloud Logging e inviano i dati di monitoraggio a Cloud Monitoring.
Oltre a queste funzionalità di logging, puoi visualizzare i dettagli sull'esecuzione del job per le 1000 esecuzioni più recenti di un job utilizzando il riquadro dei dettagli di esecuzione, insieme a tutte le esecuzioni eseguite negli ultimi sette giorni. I dettagli di esecuzione precedenti vengono rimossi e non sono più visibili nel riquadro dei dettagli di esecuzione. Tuttavia, i log e i dati di monitoraggio per esecuzioni precedenti sono ancora disponibili in Cloud Logging e Cloud Monitoring, soggetti ai criteri di conservazione per questi prodotti.
Ruoli obbligatori
Per ottenere le autorizzazioni necessarie per le operazioni descritte in questa pagina, chiedi all'amministratore di concederti uno dei seguenti ruoli IAM sul job Cloud Run:
- Per eseguire i job utilizzando Google Cloud CLI: Invoker di Cloud Run (
roles/run.invoker
) sul job Cloud Run - Per eseguire job utilizzando la console Google Cloud, per eseguire l'override delle configurazioni dei job o per annullare le esecuzioni dei job: Cloud Run Developer (
roles/run.developer
) sul job Cloud Run
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 job Cloud Run si interfaccia con le API Google Cloud, ad esempio le librerie client di 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.
Esegui job
Puoi eseguire i job utilizzando la console Google Cloud o Google Cloud CLI.
Console
Per eseguire un job:
Individua il lavoro che ti interessa.
Fai clic sul job per visualizzarne la pagina dei dettagli.
Fai clic su Execute (Esegui).
gcloud
Per eseguire un job esistente:
gcloud run jobs execute JOB_NAME
Se vuoi che il comando attenda il completamento dell'esecuzione, utilizza
gcloud run jobs execute JOB_NAME --wait --region=REGION
Sostituisci:
- JOB_NAME con il nome del job.
- REGION con la regione in cui è possibile trovare la risorsa.
In alternativa, imposta la proprietà
run/region
.
Librerie client
Per eseguire un job esistente dal codice:
API REST
Per eseguire un job esistente, invia una richiesta HTTP POST
al
metodo API jobs.run
Ad esempio, se utilizzi curl
:
curl -H "Content-Type: application/json" \ -H "Authorization: Bearer ACCESS_TOKEN" \ -X POST \ -d '' \ https://run.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/jobs/JOB-NAME:run
Sostituisci:
- ACCESS_TOKEN con un token di accesso valido per un account che dispone delle autorizzazioni IAM per eseguire un job.
Ad esempio, se hai eseguito l'accesso a gcloud, puoi recuperare un token di accesso utilizzando
gcloud auth print-access-token
. Dall'interno di un'istanza di container Cloud Run, puoi recuperare un token di accesso utilizzando il server di metadati dell'istanza di container. - JOB-NAME con il nome del job.
- REGION con la regione Google Cloud del job.
- PROJECT-ID con l'ID progetto Google Cloud.
Esegui immediatamente i job alla loro creazione
Se utilizzi la riga di comando, puoi specificare l'esecuzione del job subito dopo aver creato un job:
gcloud run jobs create JOB_NAME --execute-now --region=REGION
Esegui l'override della configurazione del job per un'esecuzione specifica
Puoi eseguire l'override di argomenti, variabili di ambiente, numero di attività e timeout delle attività configurati per un job quando esegui un job impostando questi parametri all'avvio di un nuovo job. I parametri specificati influiscono solo su questa esecuzione e non su quelle successive, poiché la definizione del job sottostante rimane invariata.
Alcuni casi d'uso comuni includono:
- Esegui il job in modo programmatico dal codice e vuoi eseguire l'override degli argomenti e/o delle variabili di ambiente, ad esempio per indicare al job dove si trovano i dati di input per l'esecuzione.
- Hai un job in cui ogni attività ha lo scopo di elaborare solo un dato di input. Vuoi eseguire l'override del numero di attività in base al numero di input da elaborare.
- Il tempo di esecuzione del job varia da un'esecuzione all'altra. Vuoi eseguire l'override del timeout dell'attività in base al tempo di esecuzione previsto del job.
Per eseguire l'override della configurazione del job per un'esecuzione:
Console
Individua il lavoro che ti interessa.
Fai clic sul job per visualizzarne la pagina dei dettagli.
Fai clic sulla freccia di espansione davanti al pulsante Modifica e poi su Esegui con override per visualizzare il modulo Esegui job con override.
Modifica argomenti, variabili di ambiente, numero di attività e/o configurazione del timeout delle attività per questa esecuzione come preferisci, poi fai clic su Esegui.
gcloud
Utilizza il comando:
gcloud run jobs execute JOB_NAME \ --args ARGS \ --update-env-vars KEY=VALUE>,KEY_N=VALUE_N \ --tasks TASKS \ --task-timeout TIMEOUT
Sostituisci
- JOB_NAME con il nome del job.
- ARGS con gli argomenti job desiderati
- KEY e VALUE vengono accoppiati alle variabili di ambiente desiderate
- TASKS con il numero di attività desiderato
- TIMEOUT con il timeout dell'attività desiderato
Librerie client
Per eseguire un job esistente dal codice, eseguendo l'override della configurazione del job:
API REST
Per eseguire l'override della configurazione del job per un job esistente, invia una richiesta HTTP POST
all'endpoint jobs
dell'API Cloud Run Admin
Ad esempio, se utilizzi curl
:
curl -H "Content-Type: application/json" \ -H "Authorization: Bearer ACCESS_TOKEN" \ -X POST \ -d '{"overrides": {"containerOverrides": [{"args": ["ARGS"], "env": [{"name": "KEY", "value": "VALUE"}]}], "taskCount": TASK-COUNT, "timeout": "TIMEOUT" }}' \ https://run.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/jobs/JOB-NAME:run
Sostituisci:
- ACCESS_TOKEN con un token di accesso valido per un account che dispone delle autorizzazioni IAM per eseguire gli override del job.
Ad esempio, se hai eseguito l'accesso a gcloud, puoi recuperare un token di accesso utilizzando
gcloud auth print-access-token
. Dall'interno di un'istanza di container Cloud Run, puoi recuperare un token di accesso utilizzando il server di metadati dell'istanza di container. - JOB_NAME con il nome del job.
- ARGS con argomenti job.
- KEY e VALUE vengono accoppiati con le variabili di ambiente.
- TASKS con il numero di attività.
- TIMEOUT con il timeout dell'attività.
- REGION con la regione Google Cloud del job.
- PROJECT-ID con l'ID progetto Google Cloud.
Annulla esecuzione job
Per arrestare l'esecuzione di un job Cloud Run attualmente in esecuzione, utilizza la funzionalità di annullamento. L'annullamento di un job interrompe l'esecuzione attuale del job. Le esecuzioni annullate hanno lo stato cancelled. Potrai comunque visualizzare l'esecuzione, inclusi i dati di configurazione, i log e i dati di monitoraggio.
L'annullamento di un job non inverte gli addebiti relativi all'utilizzo di eventuali job Cloud Run per il periodo in cui il job è stato eseguito.
Per annullare un'esecuzione:
Console
Fai clic sull'esecuzione del job per visualizzare la pagina dei dettagli dell'esecuzione.
Fai clic su Annulla.
gcloud
Utilizza il comando:
gcloud run jobs executions cancel EXECUTION_NAME
Sostituisci EXECUTION_NAME
con il nome dell'esecuzione.
Questo comando richiede una conferma, quindi rispondi al prompt inserendo y
per confermare.
Librerie client
Per annullare l'esecuzione di un job dal codice:
API REST
Per annullare l'esecuzione di un job, invia una richiesta HTTP POST
all'endpoint jobs
dell'API Cloud Run Admin
Ad esempio, se utilizzi curl
:
curl -H "Content-Type: application/json" \ -H "Authorization: Bearer ACCESS_TOKEN" \ -X POST \ -d '' \ https://run.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/jobs/JOB-NAME/executions/EXECUTION-NAME:cancel
Sostituisci:
- ACCESS_TOKEN con un token di accesso valido per un account che dispone delle autorizzazioni IAM per annullare le esecuzioni di job.
Ad esempio, se hai eseguito l'accesso a gcloud, puoi recuperare un token di accesso utilizzando
gcloud auth print-access-token
. Dall'interno di un'istanza di container Cloud Run, puoi recuperare un token di accesso utilizzando il server di metadati dell'istanza di container. - JOB_NAME con il nome del job.
- EXECUTION-NAME con il nome dell'esecuzione del job.
- REGION con la regione Google Cloud del job.
- PROJECT-ID con l'ID progetto Google Cloud.
Elimina esecuzione job
Puoi eliminare un'esecuzione di job, anche se è attualmente in esecuzione. Se elimini un'esecuzione, ne viene interrotta la prosecuzione. Per maggiori dettagli, consulta Eliminare l'esecuzione di un job.
Passaggi successivi
Dopo aver eseguito un job, puoi fare quanto segue:
- Visualizza i log dei job
- Monitorare le prestazioni del lavoro
- Gestire le esecuzioni dei job
- Gestione delle offerte di lavoro