Gestisci le esecuzioni del job

Questa pagina descrive come visualizzare ed eliminare le esecuzioni del job. Per l'esecuzione, annulla o eseguire l'override della configurazione di un job, consulta Eseguire job.

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per gestire i job Cloud Run, chiedi all'amministratore di concederti Ruolo IAM Sviluppatore Cloud Run (roles/run.developer) per il job Cloud Run.

Per un elenco di ruoli e autorizzazioni IAM associati Cloud Run, consulta Ruoli IAM di Cloud Run e le autorizzazioni IAM di Cloud Run. Se il tuo job Cloud Run si interfaccia con Le API Google Cloud, come le librerie client di Cloud, consultano guida alla configurazione dell'identità dei servizi. Per ulteriori informazioni sulla concessione dei ruoli, consulta autorizzazioni di deployment e gestire l'accesso.

Visualizza le esecuzioni del job nel progetto

Puoi visualizzare un elenco delle esecuzioni di job nel tuo progetto utilizzando: Console Google Cloud o Google Cloud CLI:

Console

Per visualizzare l'elenco delle esecuzioni di un job:

  1. Vai alla pagina dei job Cloud Run

  2. Individua nell'elenco il job di cui esegui le esecuzioni che vuoi gestire.

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

  4. Nella pagina dei dettagli dell'esecuzione, individua l'esecuzione che ti interessa dall'elenco. Facoltativamente, puoi utilizzare il filtro impostato in base al criterio desiderato, ad esempio Ad esempio, Status (Stato) con il valore completed (completato):

gcloud

Per elencare tutte le esecuzioni di job per tutti i job nel tuo 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 che stai .

Per altri modi per perfezionare l'elenco restituito, incluso l'uso di filtri, consulta l'elenco delle esecuzioni dei job.

Per recuperare 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 che stai .

Librerie client

Per elencare tutte le esecuzioni di job dal codice:

API REST

Per elencare le esecuzioni del job, invia una richiesta HTTP GET a l'endpoint jobs dell'API Cloud Run Admin.

Ad esempio, se utilizzi 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 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 di esecuzione del job

Puoi visualizzare i dettagli sull'esecuzione del job per le 10.000 esecuzioni più recenti di un job utilizzando 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 nell'esecuzione riquadro dei dettagli. Tuttavia, i log e i dati di monitoraggio relativi sono ancora disponibili in Cloud Logging e Cloud Monitoring, soggetto ai criteri 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 relativi all'esecuzione di un job specifico:

  1. Vai alla pagina dei job Cloud Run

  2. Individua l'esecuzione del job che ti interessa.

  3. Fai clic sull'esecuzione del job per visualizzare la pagina dei dettagli dell'esecuzione.

  4. Osserva le schede Tasks, 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.

gcloud

Per visualizzare i dettagli sull'esecuzione di un 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 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 dell'esecuzione del job, invia una richiesta HTTP GET a l'endpoint jobs dell'API Cloud Run Admin.

Ad esempio, se utilizzi 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 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 l'esecuzione di un job, anche durante l'esecuzione. Se elimini un'esecuzione, ne interrompe il proseguimento.

Sebbene un'esecuzione eliminata non vengono visualizzate nell'elenco delle esecuzioni, i relativi log continuano a essere disponibili Cloud Logging per la restante durata della conservazione dei log di questo periodo e i dati di monitoraggio continuano a essere disponibili Cloud Monitoring.

Console

Per eliminare l'esecuzione di un job:

  1. Vai alla pagina dei job Cloud Run

  2. Individua l'esecuzione del job da eliminare.

  3. Fai clic su Elimina.

  4. Quando ti viene chiesto di confermare l'eliminazione, fai clic su Conferma.

gcloud

Per eliminare l'esecuzione di un 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, viene 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 a l'endpoint jobs dell'API Cloud Run Admin

Ad esempio, se utilizzi 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 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.