In questa pagina viene descritto come gestire i job. Per creare un job, vedi Creazione di 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
) per il tuo 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 job Cloud Run si interfaccia con le API Google Cloud, ad esempio le librerie client di Cloud, consulta la guida alla configurazione delle identità dei servizi. Per ulteriori informazioni sulla concessione dei ruoli, consulta Autorizzazioni di deployment e Gestione dell'accesso.
Visualizza i job nel progetto
Puoi visualizzare un elenco dei job nel tuo progetto utilizzando uno dei seguenti approcci:
Console
Per visualizzare i lavori:
Se vuoi, filtra il job in base a uno dei criteri nel menu a discesa, ad esempio nome del job, ora di esecuzione, regione e così via.
Riga di comando
Per elencare tutti i job nel 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 base alla quale stai applicando il filtro, ad esempious-central1
.
Per altri modi per perfezionare l'elenco restituito, incluso l'utilizzo di 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 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 la visualizzazione dei job.
Ad esempio, se hai eseguito l'accesso a gcloud, puoi recuperare un token di accesso 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. - REGION con la regione Google Cloud del job.
- PROJECT-ID con l'ID progetto Google Cloud.
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 specifica di un job:
Individua il lavoro che ti interessa.
Fai clic sul job per visualizzare la pagina dei dettagli del job.
Osserva le schede Cronologia, Configurazione, Log e YAML.
- La scheda Cronologia mostra informazioni sulle attività in fase di esecuzione.
- Log mostra le informazioni dei log.
- Configurazione mostra informazioni sul job, sul container, sulla sicurezza, sulla connettività e così via.
- YAML mostra la configurazione del job in formato YAML.
Riga di comando
Per visualizzare i dettagli su un lavoro:
Usa il comando:
gcloud run jobs describe JOB_NAME
Sostituisci JOB_NAME
con il nome del job.
Librerie client
Per visualizzare i dettagli su 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
. 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.
Eliminazione di un job
Puoi eliminare un job solo se non sono presenti esecuzioni di job per quel job attualmente in esecuzione.
Anche se un job eliminato non compare più 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 job.
Fai clic su Elimina.
Riga di comando
Per eliminare un job:
Usa il comando:
gcloud run jobs delete JOB_NAME
Sostituisci
JOB_NAME
con il nome del job.Se ti viene chiesto di confermare, rispondi
y
. Se l'operazione va a buon fine, 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 l'eliminazione dei job.
Ad esempio, se hai eseguito l'accesso a gcloud, puoi recuperare un token di accesso 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.