Gestisci le opportunità di lavoro

Questa pagina descrive come gestire i job. Per creare un job, consulta Creazione di job. Per eseguire 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 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 i job nel progetto

Puoi visualizzare un elenco dei job nel progetto in uno dei seguenti modi approcci:

Console

Per visualizzare i job:

  1. Vai alla pagina dei job Cloud Run.

  2. Se vuoi, puoi filtrare il lavoro in base a uno dei criteri nel menu a discesa: come nome del job, tempo di esecuzione, regione e così via.

gcloud

  1. Per elencare tutti i job nel tuo progetto:

    gcloud run jobs list

  2. Per filtrare i job per regione:

    gcloud run jobs list --region REGION

    Sostituisci REGION con il nome della regione in cui ti trovi e viene applicato il filtro, ad esempio us-central1.

Per altri modi per perfezionare l'elenco restituito, incluso l'uso di filtri, consulta l'elenco di offerte di lavoro.

Librerie client

Per visualizzare i job nel progetto dal codice:

API REST

Per visualizzare l'elenco dei job nel progetto, 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

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 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 relativi all'esecuzione di un job specifico:

  1. Vai alla pagina dei job Cloud Run

  2. Individua il lavoro che ti interessa.

  3. Fai clic sul job per visualizzarne la pagina dei dettagli.

  4. Prendi nota delle schede Cronologia, Metriche, Log, Trigger e YAML.

    • La scheda Cronologia mostra informazioni sulle attività nell'esecuzione del job.
    • Log mostra le informazioni dei log.
    • Metriche mostra informazioni sulle esecuzioni del job.
    • YAML mostra la configurazione del job in formato YAML.

gcloud

Per visualizzare i dettagli su un lavoro:

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 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

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 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.

Elimina un job

Puoi eliminare un job solo se al momento non sono presenti esecuzioni di quel job in esecuzione.

Anche se un job eliminato non viene più visualizzato nell'elenco dei job, i relativi log continuano in modo che sia disponibile 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 un job:

  1. Vai alla pagina dei job Cloud Run

  2. Seleziona il job.

  3. Fai clic su Elimina.

gcloud

Per eliminare un job:

  1. Utilizza il comando:

    gcloud run jobs delete JOB_NAME

    Sostituisci JOB_NAME con il nome del job.

  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 un job dal codice:

API REST

Per eliminare 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

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 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.