Questa pagina descrive come visualizzare ed eliminare le esecuzioni dei job. Per eseguire, annullare o eseguire l'override di una configurazione di 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 Sviluppatore Cloud Run (roles/run.developer
) nel 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 tuo job Cloud Run si interfaccia con le API Google Cloud, come le librerie client Cloud, consulta la guida alla configurazione dell'identità del servizio. Per ulteriori informazioni sulla concessione dei ruoli, consulta le 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 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, seleziona l'esecuzione che ti interessa dall'elenco. Se vuoi, puoi utilizzare il filtro impostato su un criterio desiderato, ad esempio Stato con un valore completato:
gcloud
Per elencare tutte le esecuzioni di job per tutti i job del progetto:
gcloud run jobs executions list
Per elencare solo le esecuzioni di un job specifico:
gcloud run jobs executions list --job JOB_NAME
Sostituisci JOB_NAME
con il nome del job su cui vuoi applicare il filtro.
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 di 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 su cui vuoi applicare il filtro.
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-NAME/executions
Sostituisci:
- ACCESS_TOKEN con un token di accesso valido per un account che possiede le 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
. 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.
- REGION con la regione Google Cloud del job.
- PROJECT-ID con l'ID progetto Google Cloud.
Visualizza i dettagli di esecuzione del job
Puoi visualizzare i dettagli di esecuzione dei 10.000 job più recenti utilizzando il riquadro dei dettagli di esecuzione, insieme a tutte le esecuzioni avvenute negli ultimi sette giorni. I dettagli delle esecuzioni precedenti vengono rimossi e non sono più visibili nel riquadro dei dettagli dell'esecuzione. Tuttavia, i dati di monitoraggio e dei log per le esecuzioni precedenti sono ancora disponibili in Cloud Logging e Cloud Monitoring, in base alle norme di conservazione per 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 del job specifica:
Fai clic sul job per aprire il riquadro dei dettagli del job.
Fai clic sull'esecuzione del job che vuoi visualizzare. I dettagli dell'esecuzione vengono visualizzati nel riquadro a destra.
Prendi nota delle schede Tasks, Containers, Volumes, Networking, Security e YAML, nonché del link Visualizza log.
- Attività mostra informazioni sulle attività nell'esecuzione del job.
- YAML mostra la configurazione del job in formato YAML.
- Fai clic sul link Visualizza log per visualizzare i log relativi all'esecuzione.
- Le altre schede mostrano informazioni su job, contenitore, sicurezza, connettività e così via utilizzati nell'esecuzione.
gcloud
Per visualizzare i dettagli di un'esecuzione del job:
Utilizza 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 file YAML:
gcloud run jobs executions describe EXECUTION_NAME --format yaml
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-NAME/executions/EXECUTION-NAME
Sostituisci:
- ACCESS_TOKEN con un token di accesso valido per un account che possiede le autorizzazioni IAM per visualizzare i dettagli di esecuzione dei 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.
- 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.
Eliminare un'esecuzione del job
Puoi eliminare un'esecuzione di un job anche durante l'esecuzione. Se elimini un'esecuzione, l'esecuzione viene interrotta.
Sebbene un'esecuzione eliminata non sia 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:
Fai clic sul job per aprire il riquadro dei dettagli del job.
Seleziona l'esecuzione del job che vuoi eliminare.
Nel menu Azioni, fai clic sull'icona dei 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:
Utilizza 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
. In caso di esito positivo, verrà visualizzato un messaggio di conferma.
Librerie client
Per eliminare un'esecuzione del job dal codice:
API REST
Per eliminare un'esecuzione di 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 possiede le autorizzazioni IAM per eliminare 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
. 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.
- 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.