Questa pagina descrive come visualizzare ed eliminare le esecuzioni dei job. Per eseguire, annullare o ignorare una configurazione del job, consulta Eseguire i job.
Ruoli obbligatori
Per ottenere le autorizzazioni necessarie per gestire i job Cloud Run, chiedi all'amministratore di concederti il ruolo IAM Cloud Run Developer (roles/run.developer) nel job Cloud Run.
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 saperne di più sulla concessione dei ruoli, consulta Autorizzazioni di deployment e Gestisci l'accesso.
Visualizzare le esecuzioni dei job nel progetto
Puoi visualizzare un elenco delle esecuzioni dei job nel tuo progetto utilizzando la consoleGoogle Cloud , gcloud CLI, le librerie client o l'API REST:
Console
Per visualizzare l'elenco delle esecuzioni di un job:
Nella console Google Cloud , vai alla pagina dei job Cloud Run:
Fai clic sul job per visualizzare l'elenco delle esecuzioni.
Nella pagina dei dettagli dell'esecuzione, seleziona l'esecuzione che ti interessa dall'elenco. Se vuoi, puoi filtrare in base ai criteri.
gcloud
Per elencare tutte le esecuzioni dei job per tutti i job nel tuo progetto, esegui questo comando:
gcloud run jobs executions list
Per elencare solo le esecuzioni per un job specifico, esegui questo comando:
gcloud run jobs executions list --job JOB
Sostituisci
JOBcon il nome del job in base al quale esegui il filtro.Per altri modi per perfezionare l'elenco restituito, incluso l'utilizzo dei filtri, consulta Elenco delle esecuzioni dei job.
Per ottenere il nome dell'ultima esecuzione di un job specifico, utilizza il flag
--format:gcloud run jobs describe JOB --format="value(status.latestCreatedExecution.name)"
Sostituisci
JOBcon il nome del job in base al quale esegui il filtro.
In alternativa, per visualizzare i dettagli dell'ultima esecuzione del job, consulta Visualizzare i dettagli dell'esecuzione del job.
Librerie client
Per elencare tutte le esecuzioni dei job dal codice:
API REST
Per elencare le esecuzioni dei job, invia una richiesta HTTP GET all'endpoint jobs dell'API Cloud Run Admin.
Ad esempio, utilizzando curl:
curl -H "Content-Type: application/json" \ -H "Authorization: Bearer ACCESS_TOKEN" \ -X GET \ -d '' \ https://run.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/jobs/JOB/executions
Sostituisci quanto segue:
ACCESS_TOKEN: un token di accesso valido per un account che dispone delle autorizzazioni IAM per visualizzare le esecuzioni dei job. Ad esempio, se hai eseguito l'accesso a gcloud, puoi recuperare un token di accesso utilizzandogcloud auth print-access-token. Da un'istanza container Cloud Run, puoi recuperare un token di accesso utilizzando il server dei metadati dell'istanza container.PROJECT_ID: l'ID progetto Google Cloud .REGION: la Google Cloud regione del job.JOB: il nome del job Cloud Run.
Visualizza i dettagli di esecuzione del job
Puoi visualizzare i dettagli di esecuzione dei job per le 1000 esecuzioni più recenti di un job utilizzando il riquadro dei dettagli di esecuzione. I dettagli di esecuzione meno recenti vengono rimossi e non sono più visibili nel riquadro dei dettagli di esecuzione. Tuttavia, i log e i dati di monitoraggio delle esecuzioni precedenti sono ancora disponibili in Cloud Logging e Cloud Monitoring, in base alle norme di conservazione di questi prodotti.
Puoi visualizzare ulteriori dettagli sull'esecuzione di un job utilizzando la console Google Cloud , gcloud CLI, le librerie client o l'API REST:
Console
Per visualizzare i dettagli di un'esecuzione specifica del job:
Nella console Google Cloud , vai alla pagina dei job Cloud Run:
Fai clic sul job per aprire il riquadro dei dettagli.
Fai clic sull'esecuzione del job che vuoi visualizzare. I dettagli dell'esecuzione vengono mostrati nel riquadro a destra. Per ulteriori dettagli, consulta le schede Attività, Container, Volumi, Networking, Sicurezza e YAML.
gcloud
Per visualizzare i dettagli di un'esecuzione del job, esegui questi comandi:
Per descrivere un'esecuzione specifica del job:
gcloud run jobs executions describe EXECUTION_NAME
Sostituisci
EXECUTION_NAMEcon il nome dell'esecuzione.Puoi utilizzare il flag
--formatper formattare l'output e ottenere informazioni aggiuntive. Ad esempio, in formato YAML:gcloud run jobs executions describe EXECUTION_NAME --format yaml
Per descrivere l'ultima esecuzione di un job:
gcloud run jobs executions describe-latest --job=JOB
Sostituisci
JOBcon il nome del job.
Librerie client
Per visualizzare i dettagli di esecuzione del job dal codice:
API REST
Per visualizzare i dettagli di esecuzione del job, invia una richiesta HTTP GET all'endpoint jobs dell'API Cloud Run Admin.
Ad esempio, utilizzando curl:
curl -H "Content-Type: application/json" \ -H "Authorization: Bearer ACCESS_TOKEN" \ -X GET \ -d '' \ https://run.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/jobs/JOB/executions/EXECUTION_NAME
Sostituisci quanto segue:
ACCESS_TOKEN: un token di accesso valido per un account che dispone delle autorizzazioni IAM per visualizzare i dettagli di esecuzione del job. Ad esempio, se hai eseguito l'accesso a gcloud, puoi recuperare un token di accesso utilizzandogcloud auth print-access-token. Da un'istanza container Cloud Run, puoi recuperare un token di accesso utilizzando il server dei metadati dell'istanza container.PROJECT_ID: l'ID progetto Google Cloud .REGION: la Google Cloud regione del job.JOB: il nome del job Cloud Run.EXECUTION_NAME: il nome dell'esecuzione del job.
Eliminare un'esecuzione del job
Puoi eliminare un'esecuzione del job, anche durante l'esecuzione. Se elimini un'esecuzione, questa non potrà continuare.
Anche se un'esecuzione eliminata non viene visualizzata nell'elenco delle esecuzioni, i relativi log continuano a essere disponibili in Cloud Logging per il resto del periodo di conservazione dei log e i dati di monitoraggio continuano a essere disponibili in Cloud Monitoring.
Console
Per eliminare un'esecuzione del job:
Nella console Google Cloud , vai alla pagina dei job Cloud Run:
Fai clic sul job per aprire il riquadro dei dettagli.
Seleziona l'esecuzione del job che vuoi eliminare.
Nel menu Azioni, fai clic sull'icona con i tre puntini e poi su Elimina.
Se ti viene chiesto di confermare l'eliminazione, fai clic su Conferma.
gcloud
Per eliminare un'esecuzione del job:
Esegui questo comando:
gcloud run jobs executions delete EXECUTION_NAME
Sostituisci
EXECUTION_NAMEcon il nome dell'esecuzione.Se ti viene chiesto di confermare, rispondi
y. In caso di esito positivo, verrà visualizzato un messaggio di operazione riuscita.
Librerie client
Per eliminare un'esecuzione del job dal codice:
API REST
Per eliminare l'esecuzione di un job, invia una richiesta HTTP DELETE all'endpoint jobs dell'API Cloud Run Admin.
Ad esempio, utilizzando curl:
curl -H "Content-Type: application/json" \ -H "Authorization: Bearer ACCESS_TOKEN" \ -X DELETE \ -d '' \ https://run.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/jobs/JOB/executions/EXECUTION_NAME
Sostituisci quanto segue:
ACCESS_TOKEN: un token di accesso valido per un account che dispone delle autorizzazioni IAM per eliminare le esecuzioni dei job. Ad esempio, se hai eseguito l'accesso a gcloud, puoi recuperare un token di accesso utilizzandogcloud auth print-access-token. Da un'istanza container Cloud Run, puoi recuperare un token di accesso utilizzando il server dei metadati dell'istanza container.PROJECT_ID: l'ID progetto Google Cloud .REGION: la Google Cloud regione del job.JOB: il nome del job Cloud Run.EXECUTION_NAME: il nome dell'esecuzione del job.