Gérer des tâches

Cette page explique comment gérer les tâches. Pour créer une tâche, consultez la page Créer des tâches. Pour exécuter une tâche, consultez la section Exécuter des tâches.

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 les API Google Cloud, telles que les 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 tâches 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 tâches, procédez comme suit :

Accédez à la page 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.

Command line

Pour lister toutes les tâches d'un projet, procédez comme suit :
```
gcloud run jobs list
```
Pour filtrer les tâches 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 tâches.

Bibliothèques clientes

Pour afficher les tâches 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 de la tâche.
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 une tâche.

Console

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

Accéder à la page Cloud Run
Recherchez la tâche qui vous intéresse.
Cliquez sur la tâche pour afficher la page Informations sur la tâche.
Notez les onglets Historique, Configuration, Journaux 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 Configuration affiche des informations sur la tâche, le conteneur, la sécurité, la connectivité, etc.
- L'onglet YAML affiche la configuration de la tâche au format YAML.

Command line

Pour afficher les détails d'une tâche, procédez comme suit :

Utilisez la commande :

gcloud run jobs describe  JOB_NAME

Remplacez JOB_NAME par le nom de la tâche.

Bibliothèques clientes

Pour afficher les détails d'une tâche à 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 une offre d'emploi

Vous ne pouvez supprimer une tâche que si elle n'est pas en cours d'exécution.

Bien qu'une tâche supprimée n'apparaisse plus dans la liste des tâches, 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 une tâche, procédez comme suit :

Accéder à la page Cloud Run
Sélectionnez la tâche.
Cliquez sur Supprimer.

Command line

Pour supprimer une tâche, procédez comme suit :

Utilisez la commande :
```
gcloud run jobs delete JOB_NAME
```
Remplacez JOB_NAME par le nom de la tâche.
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.