Gestire le esecuzioni dei job

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 Sviluppatore Cloud Run (roles/run.developer) nel job Cloud Run.

Per un elenco di ruoli e autorizzazioni IAM associati a Cloud Run, consulta Ruoli IAM Cloud Run e Autorizzazioni IAM 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 ulteriori informazioni sulla concessione dei ruoli, consulta Autorizzazioni di deployment e Gestire l'accesso.

Visualizzare le esecuzioni dei job nel progetto

Puoi visualizzare un elenco delle esecuzioni dei job nel tuo progetto utilizzando la consoleGoogle Cloud o Google Cloud CLI:

Console

Per visualizzare l'elenco delle esecuzioni di un job:

  1. Vai alla pagina Job Cloud Run

  2. Nell'elenco, individua il job di cui vuoi gestire le esecuzioni.

  3. Fai clic sul job per visualizzare l'elenco delle esecuzioni.

  4. 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 di completato:

gcloud

Per elencare tutte le esecuzioni dei job per tutti i job nel tuo 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 in base al quale stai filtrando.

Per altri modi per perfezionare l'elenco restituito, incluso l'utilizzo dei 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 in base al quale stai filtrando.

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 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. Da 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 Google Cloud regione del lavoro.
  • PROJECT-ID con l' Google Cloud ID progetto.

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 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 di job specifica:

  1. Vai alla pagina Job Cloud Run

  2. Fai clic sul job per aprire il riquadro dei dettagli.

  3. Fai clic sull'esecuzione del job che vuoi visualizzare. I dettagli di esecuzione vengono visualizzati nel riquadro a destra.

  4. Prendi nota delle schede Attività, Container, Volumi, Networking, Sicurezza 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 sul job, sul container, sulla sicurezza, sulla connettività e così via utilizzate 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 ottenere informazioni aggiuntive. Ad esempio, come 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 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 utilizzando gcloud auth print-access-token. Da 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 Google Cloud regione del lavoro.
  • PROJECT-ID con l' Google Cloud ID progetto.

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:

  1. Vai alla pagina Job Cloud Run

  2. Fai clic sul job per aprire il riquadro dei dettagli.

  3. Seleziona l'esecuzione del job che vuoi eliminare.

  4. Nel menu Azioni, fai clic sull'icona con i tre puntini e poi su Elimina.

  5. Se ti viene chiesto di confermare l'eliminazione, fai clic su Conferma.

gcloud

Per eliminare un'esecuzione del job:

  1. Utilizza il comando:

    gcloud run jobs executions delete EXECUTION_NAME

    Sostituisci EXECUTION_NAME con il nome dell'esecuzione.

  2. 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-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 dei job. Ad esempio, se hai eseguito l'accesso a gcloud, puoi recuperare un token di accesso utilizzando gcloud auth print-access-token. Da 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 Google Cloud regione del lavoro.
  • PROJECT-ID con l' Google Cloud ID progetto.