Gérer les jobs

Cette page explique comment gérer les jobs. Pour créer un job, consultez la page Créer des jobs. Pour exécuter un job, consultez la section Exécuter des jobs.

Rôles requis

Pour obtenir les autorisations nécessaires pour gérer les jobs Cloud Run, demandez à votre administrateur de vous accorder le rôle IAM Développeur Cloud Run (roles/run.developer) sur votre job Cloud Run.

Pour obtenir la liste des rôles et des autorisations IAM associés à Cloud Run, consultez les sections Rôles IAM Cloud Run et Autorisations IAM Cloud Run. Si votre job Cloud Run communique avec des API Google Cloud, telles que des bibliothèques clientes Cloud, consultez le guide de configuration de l'identité du service. Pour en savoir plus sur l'attribution de rôles, consultez les sections Autorisations de déploiement et Gérer les accès.

Afficher les jobs dans votre projet

Vous pouvez afficher la liste des jobs dans votre projet à l'aide de l'une des approches suivantes :

Console

Pour afficher des jobs, procédez comme suit :

Accédez à la page des jobs Cloud Run.
Vous pouvez éventuellement filtrer le job selon l'un des critères disponibles dans le menu déroulant, tels que le nom du job, la durée d'exécution, la région, etc.

gcloud

Pour lister tous les jobs d'un projet, procédez comme suit :
```
gcloud run jobs list
```
Pour filtrer les jobs par région :
```
gcloud run jobs list --region REGION
```
Remplacez REGION par le nom de la région sur laquelle vous filtrez, par exemple us-central1.

Pour découvrir d'autres méthodes permettant d'affiner la liste renvoyée, y compris l'utilisation de filtres, consultez la liste des jobs.

Bibliothèques clientes

Pour afficher les jobs de votre projet à partir du code, procédez comme suit :

API REST

Pour afficher la liste des jobs dans votre projet, envoyez une requête HTTP GET au point de terminaison jobs de l'API Cloud Run Admin.

Exemple, à l'aide de 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

Remplacez :

ACCESS_TOKEN par un jeton d'accès valide pour un compte disposant des autorisations IAM pour afficher les jobs. Par exemple, si vous êtes connecté à gcloud, vous pouvez récupérer un jeton d'accès à l'aide de gcloud auth print-access-token. À partir d'une instance de conteneur Cloud Run, vous pouvez récupérer un jeton d'accès via le serveur de métadonnées d'instance de conteneur.
REGION par la région Google Cloud du job.
PROJECT-ID par l'ID du projet Google Cloud.

Afficher les informations sur le job

Utilisez la ligne de commande gcloud pour afficher plus de détails sur un job.

Console

Pour afficher les détails d'une exécution de job spécifique, procédez comme suit :

Accédez à la page des jobs Cloud Run
Recherchez le job qui vous intéresse.
Cliquez sur la tâche pour afficher la page Informations sur la tâche.
Notez les onglets Historique, Métriques, Journaux, Déclencheurs et YAML.
- L'onglet Historique affiche des informations sur les tâches exécutées dans le job.
- L'onglet Journaux affiche les informations sur les journaux.
- L'onglet Métriques affiche des informations sur les exécutions de jobs.
- L'onglet YAML affiche la configuration de la tâche au format YAML.

gcloud

Pour afficher les détails d'un job, procédez comme suit :

Utilisez la commande :

gcloud run jobs describe  JOB_NAME

Remplacez JOB_NAME par le nom du job.

Bibliothèques clientes

Pour afficher les détails d'un job à partir du code, procédez comme suit :

API REST

Pour afficher les détails d'un job, envoyez une requête HTTP GET au point de terminaison jobs de l'API Cloud Run Admin.

Exemple, à l'aide de 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

Remplacez :

ACCESS_TOKEN par un jeton d'accès valide pour un compte disposant des autorisations IAM pour afficher les détails du job. Par exemple, si vous êtes connecté à gcloud, vous pouvez récupérer un jeton d'accès à l'aide de gcloud auth print-access-token. À partir d'une instance de conteneur Cloud Run, vous pouvez récupérer un jeton d'accès via le serveur de métadonnées d'instance de conteneur.
Remplacez JOB-NAME par le nom du job.
REGION par la région Google Cloud du job.
PROJECT-ID par l'ID du projet Google Cloud.

Supprimer un job

Vous ne pouvez supprimer un job que si aucune exécution de ce job n'est en cours.

Un job supprimé n'apparaît plus dans la liste des jobs, cependant ses journaux restent disponibles dans Cloud Logging pendant le reste de la période de conservation des journaux, et les données de surveillance restent disponibles dans Cloud Monitoring.

Console

Pour supprimer un job, procédez comme suit :

Accédez à la page des jobs Cloud Run
Sélectionnez le job.
Cliquez sur Supprimer.

gcloud

Pour supprimer un job, procédez comme suit :

Utilisez la commande :
```
gcloud run jobs delete JOB_NAME
```
Remplacez JOB_NAME par le nom du job.
Si vous êtes invité à confirmer votre choix, répondez y. En cas de réussite, un message de réussite s'affiche.

Bibliothèques clientes

Pour supprimer un job du code, procédez comme suit :

API REST

Pour supprimer un job, envoyez une requête HTTP DELETE au point de terminaison jobs de l'API Cloud Run Admin.

Exemple, à l'aide de 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

Remplacez :

ACCESS_TOKEN par un jeton d'accès valide pour un compte disposant des autorisations IAM pour supprimer des jobs. Par exemple, si vous êtes connecté à gcloud, vous pouvez récupérer un jeton d'accès à l'aide de gcloud auth print-access-token. À partir d'une instance de conteneur Cloud Run, vous pouvez récupérer un jeton d'accès via le serveur de métadonnées d'instance de conteneur.
Remplacez JOB-NAME par le nom du job.
REGION par la région Google Cloud du job.
PROJECT-ID par l'ID du projet Google Cloud.