Cloud Run ti consente di visualizzare i job, i relativi dettagli ed eliminarli durante il loro ciclo di vita. Per creare un job, consulta Creare job. Per eseguire un job, vedi Esegui 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 i job nel progetto
Puoi visualizzare un elenco dei job nel tuo progetto utilizzando la console Google Cloud , gcloud CLI, le librerie client o l'API REST:
Console
Nella console Google Cloud , vai alla pagina dei job Cloud Run:
(Facoltativo) Filtra il job in base a uno dei criteri nel menu, ad esempio nome del job, tempo di esecuzione o regione.
gcloud
Per elencare tutti i job nel tuo progetto, esegui questo comando:
gcloud run jobs list
Per filtrare i job per regione, esegui questo comando:
gcloud run jobs list --region REGION
Sostituisci REGION con il nome della regione che vuoi filtrare, ad esempio europe-west1.
Per altri modi per perfezionare l'elenco restituito, incluso l'utilizzo dei filtri, consulta l'elenco dei job.
Librerie client
Per visualizzare i job nel tuo progetto dal codice:
API REST
Per visualizzare l'elenco dei job nel tuo progetto, 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
Sostituisci quanto segue:
ACCESS_TOKEN: un token di accesso valido per un account che dispone delle autorizzazioni IAM per visualizzare i 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.
Visualizza i dettagli del job
Puoi visualizzare ulteriori dettagli su un job utilizzando la console Google Cloud , gcloud CLI, le librerie client o l'API REST:
Console
Nella console Google Cloud , vai alla pagina dei job Cloud Run:
Individua l'offerta di lavoro che ti interessa.
Fai clic sul job per visualizzare la pagina dei dettagli.
Spostati tra le schede Cronologia, Log, Metriche e YAML:
- Cronologia mostra informazioni sulle attività nell'esecuzione del job.
- Log mostra le informazioni dei log.
- Metriche mostra informazioni sulle esecuzioni dei job.
- YAML mostra la configurazione del job in formato YAML.
gcloud
Per visualizzare i dettagli di un job, esegui questo comando:
gcloud run jobs describe JOB
Sostituisci JOB con il nome del job.
Librerie client
Per visualizzare i dettagli di un job dal codice:
API REST
Per visualizzare i dettagli di un 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
Sostituisci quanto segue:
ACCESS_TOKEN: un token di accesso valido per un account che dispone delle autorizzazioni IAM per visualizzare i dettagli 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.
Elimina un job
L'eliminazione di un job termina tutte le esecuzioni del job in corso e tutte le istanze container in esecuzione.
Anche se un job eliminato non viene più visualizzato nell'elenco dei job, 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
Nella console Google Cloud , vai alla pagina dei job Cloud Run:
Seleziona il job.
Fai clic su Elimina.
Fai clic su Conferma.
gcloud
Per eliminare un job, esegui questo comando:
gcloud run jobs delete JOB
Sostituisci JOB con il nome del job.
Se ti viene richiesta una conferma, rispondi y. Al termine, verrà visualizzato un messaggio di operazione riuscita.
Librerie client
Per eliminare un job dal codice:
API REST
Per eliminare 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
Sostituisci quanto segue:
ACCESS_TOKEN: un token di accesso valido per un account che dispone delle autorizzazioni IAM per eliminare i 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.