Questa pagina descrive come gestire i job. Per creare un job, consulta Creare job. Per eseguire 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
)
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 i job nel progetto
Puoi visualizzare un elenco dei job nel tuo progetto utilizzando uno dei seguenti approcci:
Console
Per visualizzare i lavori:
(Facoltativo) Filtra il job in base a uno dei criteri nel menu a discesa, come nome del job, tempo di esecuzione, regione e così via.
gcloud
Per elencare tutti i job nel tuo progetto:
gcloud run jobs list
Per filtrare i job per regione:
gcloud run jobs list --region REGION
Sostituisci
REGION
con il nome della regione in cui stai filtrando, ad esempioeurope-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:
- ACCESS_TOKEN con 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 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. - REGION con la Google Cloud regione del lavoro.
- PROJECT-ID con l' Google Cloud ID progetto.
Visualizza i dettagli del job
Utilizza la riga di comando gcloud per visualizzare ulteriori dettagli su un job.
Console
Per visualizzare i dettagli di un'esecuzione di job specifica:
Individua l'offerta di lavoro che ti interessa.
Fai clic sul job per visualizzare la pagina dei dettagli.
Prendi nota delle schede Cronologia, Metriche, Log, Attivatori e YAML.
- La scheda 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:
Utilizza il comando:
gcloud run jobs describe JOB_NAME
Sostituisci JOB_NAME
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-NAME
Sostituisci:
- ACCESS_TOKEN con 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 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.
Elimina un job
L'eliminazione di un job termina tutte le esecuzioni del job in corso e tutte le istanze di 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
Per eliminare un job:
Seleziona il lavoro.
Fai clic su Elimina.
gcloud
Per eliminare un job:
Utilizza il comando:
gcloud run jobs delete JOB_NAME
Sostituisci
JOB_NAME
con il nome del job.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 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-NAME
Sostituisci:
- ACCESS_TOKEN con 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 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.