Questa pagina descrive come visualizzare ed eliminare le esecuzioni dei job. Per eseguire, annullare o eseguire l'override della configurazione di un job, consulta Esegui job.
Ruoli obbligatori
Per ottenere le autorizzazioni necessarie per gestire i job Cloud Run,
chiedi all'amministratore di concederti il ruolo IAM
Sviluppatore Cloud Run (roles/run.developer
) per il tuo 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 job Cloud Run si interfaccia con le API Google Cloud, ad esempio le librerie client di Cloud, consulta la guida alla configurazione delle identità dei servizi. Per ulteriori informazioni sulla concessione dei ruoli, consulta Autorizzazioni di deployment e Gestione dell'accesso.
Visualizzare le esecuzioni dei job nel progetto
Puoi visualizzare un elenco delle esecuzioni di job nel tuo progetto utilizzando la console Google Cloud o Google Cloud CLI:
Console
Per visualizzare l'elenco delle esecuzioni di un job:
Nell'elenco, individua il job di cui vuoi gestire le esecuzioni.
Fai clic sul job per visualizzare l'elenco delle esecuzioni.
Nella pagina dei dettagli dell'esecuzione, individua nell'elenco l'esecuzione che ti interessa. Facoltativamente, puoi utilizzare il filtro impostato in base ai criteri che preferisci, ad esempio Stato con il valore completato:
Riga di comando
Per elencare tutte le esecuzioni di tutti i job presenti nel progetto:
gcloud run jobs executions list
Per elencare solo le esecuzioni per un job specifico:
gcloud run jobs executions list --job JOB_NAME
Sostituisci JOB_NAME
con il nome del job in base al quale stai filtrando.
Per altri modi per perfezionare l'elenco restituito, incluso l'utilizzo di filtri, consulta l'elenco delle esecuzioni dei job.
Per ottenere il nome dell'ultima esecuzione per un job specifico, utilizza il flag --format
:
gcloud run jobs describe JOB_NAME --format="value(status.latestCreatedExecution.name)"
Sostituisci JOB_NAME
con il nome del job in base al quale stai filtrando.
Librerie client
Per elencare tutte le esecuzioni di job dal codice:
API REST
Per elencare le esecuzioni 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-NAME/executions
Sostituisci:
- ACCESS_TOKEN con 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 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.
Visualizza i dettagli dell'esecuzione del job
Puoi visualizzare i dettagli dell'esecuzione di un job per le ultime 10.000 esecuzioni di un job utilizzando il riquadro dei dettagli dell'esecuzione, insieme a quelle che si sono verificate negli ultimi sette giorni. I dettagli dell'esecuzione precedenti vengono rimossi e non sono più visibili nel riquadro dei dettagli dell'esecuzione. Tuttavia, i log e i dati di monitoraggio per le esecuzioni meno recenti sono ancora disponibili in Cloud Logging e Cloud Monitoring, in conformità ai criteri di conservazione di questi prodotti.
Puoi utilizzare la console Google Cloud o Google Cloud CLI per visualizzare ulteriori dettagli sull'esecuzione di un job.
Console
Per visualizzare i dettagli di un'esecuzione specifica di un job:
Fai clic sull'esecuzione del job per visualizzare la pagina dei dettagli dell'esecuzione.
Osserva le schede Attività, Log, Configurazione e YAML.
- Attività mostra informazioni sulle attività nell'esecuzione del job.
- Log mostra i log relativi all'esecuzione.
- Configurazione mostra informazioni sul job, sul container, sulla sicurezza, sulla connettività e così via utilizzati nell'esecuzione.
- YAML mostra la configurazione del job in formato YAML.
Riga di comando
Per visualizzare i dettagli sull'esecuzione di un job:
Usa il comando:
gcloud run jobs executions describe EXECUTION_NAME
Sostituisci EXECUTION_NAME
con il nome dell'esecuzione.
Puoi utilizzare il flag --format
per formattare
l'output e per ottenere ulteriori informazioni. Ad esempio come YAML:
gcloud run jobs executions describe EXECUTION_NAME --format yaml
Librerie client
Per visualizzare i dettagli dell'esecuzione del job dal codice:
API REST
Per visualizzare i dettagli dell'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-NAME/executions/EXECUTION-NAME
Sostituisci:
- ACCESS_TOKEN con un token di accesso valido per un account che dispone delle autorizzazioni IAM per visualizzare i dettagli dell'esecuzione 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.
- 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 l'esecuzione di un job
Puoi eliminare l'esecuzione di un job, anche durante un'esecuzione. Se elimini un'esecuzione, ne viene interrotta la prosecuzione.
Sebbene un'esecuzione eliminata non venga visualizzata nell'elenco delle esecuzioni, i relativi log continueranno a essere disponibili in Cloud Logging per il resto del periodo di conservazione dei log e i dati di monitoraggio continueranno a essere disponibili in Cloud Monitoring.
Console
Per eliminare l'esecuzione di un job:
Fai clic su Elimina.
Quando ti viene chiesto di confermare l'eliminazione, fai clic su Conferma.
Riga di comando
Per eliminare l'esecuzione di un job:
Usa il comando:
gcloud run jobs executions delete EXECUTION_NAME
Sostituisci
EXECUTION_NAME
con il nome dell'esecuzione.Se ti viene chiesto di confermare, rispondi
y
. Se l'operazione va a buon fine, verrà visualizzato un messaggio di operazione riuscita.
Librerie client
Per eliminare l'esecuzione di un 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-NAME/executions/EXECUTION-NAME
Sostituisci:
- ACCESS_TOKEN con un token di accesso valido per un account che dispone delle autorizzazioni IAM per eliminare 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.