Gérer l'exécution des tâches

Cette page explique comment afficher et supprimer des exécutions de jobs. Pour exécuter, annuler ou remplacer une configuration de job, consultez la page 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 exécutions de tâche dans votre projet

Vous pouvez afficher la liste des exécutions de tâches dans votre projet à l'aide de la console Google Cloud ou de Google Cloud CLI :

Console

Pour afficher la liste des exécutions d'une tâche, procédez comme suit :

  1. Accéder à la page Cloud Run

  2. Dans la liste, recherchez la tâche dont vous souhaitez gérer les exécutions.

  3. Cliquez sur la tâche pour afficher la liste de ses exécutions.

  4. Sur la page des détails d'exécution, sélectionnez l'exécution qui vous intéresse dans la liste. Vous pouvez éventuellement utiliser le filtre défini sur un critère souhaité, par exemple dont l'État a la valeur Terminée :

gcloud

Pour répertorier toutes les exécutions de toutes les tâches de votre projet, exécutez la commande suivante :

gcloud run jobs executions list

Pour répertorier uniquement les exécutions d'une tâche spécifique, procédez comme suit :

gcloud run jobs executions list --job JOB_NAME

Remplacez JOB_NAME par le nom de la tâche sur laquelle vous effectuez le filtrage.

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.

Pour obtenir le nom de la dernière exécution pour un job spécifique, utilisez l'option --format :

gcloud run jobs describe JOB_NAME --format="value(status.latestCreatedExecution.name)"

Remplacez JOB_NAME par le nom de la tâche sur laquelle vous effectuez le filtrage.

Bibliothèques clientes

Pour répertorier toutes les exécutions de jobs à partir du code, procédez comme suit:

API REST

Pour répertorier les exécutions de 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/executions

Remplacez :

  • ACCESS_TOKEN par un jeton d'accès valide pour un compte disposant des autorisations IAM pour afficher les exécutions de 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.

Afficher les détails de l'exécution d'une tâche

Vous pouvez consulter les détails des 10 000 exécutions les plus récentes d'une tâche à l'aide du volet des détails d'exécution, ainsi que toutes les exécutions ayant eu lieu au cours des sept derniers jours. Les détails des exécutions plus anciennes sont supprimés et ne sont plus visibles dans le volet des détails d'exécution. Toutefois, les journaux et les données de surveillance des exécutions plus anciennes restent disponibles dans Cloud Logging et Cloud Monitoring, où ils sont soumis aux règles de conservation applicables pour ces produits.

Vous pouvez utiliser la console Google Cloud ou Google Cloud CLI pour afficher plus de détails sur l'exécution d'une tâche.

Console

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

  1. Accéder à la page Cloud Run

  2. Cliquez sur le job pour ouvrir son volet Détails.

  3. Cliquez sur l'exécution du job que vous souhaitez afficher. Les détails de l'exécution s'affichent dans le panneau de droite.

  4. Notez les onglets Tâches, Conteneurs, Volumes, Mise en réseau, Sécurité et YAML, ainsi que le lien Afficher les journaux.

    • L'onglet Tâches affiche des informations sur les tâches exécutées dans le job.
    • L'onglet YAML affiche la configuration de la tâche au format YAML.
    • Cliquez sur le lien Afficher les journaux pour afficher les journaux liés à l'exécution.
    • Les autres onglets affichent des informations sur le job, le conteneur, la sécurité, la connectivité et autres caractéristiques utilisées dans l'exécution.

gcloud

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

Utilisez la commande :

gcloud run jobs executions describe EXECUTION_NAME

Remplacez EXECUTION_NAME par le nom du fichier.

Vous pouvez utiliser l'option --format pour mettre en forme le résultat et obtenir des informations supplémentaires. Par exemple, au format YAML :

gcloud run jobs executions describe EXECUTION_NAME --format yaml

Bibliothèques clientes

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

API REST

Pour afficher les détails d'exécution 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/executions/EXECUTION-NAME

Remplacez :

  • ACCESS_TOKEN par un jeton d'accès valide pour un compte disposant des autorisations IAM pour afficher les exécutions 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.
  • Remplacez EXECUTION-NAME par le nom de l'exécution de job.
  • REGION par la région Google Cloud du job.
  • PROJECT-ID par l'ID du projet Google Cloud.

Supprimer une exécution de job

Vous pouvez supprimer une exécution de job, même pendant une exécution. Si vous supprimez une exécution, l'opération empêche la poursuite de l'exécution.

Bien qu'une exécution supprimée n'apparaisse pas dans la liste des exécutions, ses journaux restent disponibles dans Cloud Logging pendant le reste de la durée de conservation des journaux, et les données de surveillance restent disponibles dans Cloud Monitoring.

Console

Pour supprimer une exécution de tâche :

  1. Accéder à la page Cloud Run

  2. Cliquez sur le job pour ouvrir son volet Détails.

  3. Sélectionnez l'exécution du job que vous souhaitez supprimer.

  4. Dans le menu Actions, cliquez sur l'icône à trois points, puis sur Supprimer.

  5. Si vous êtes invité à confirmer la suppression, cliquez sur Confirmer.

gcloud

Pour supprimer une exécution de tâche :

  1. Utilisez la commande :

    gcloud run jobs executions delete EXECUTION_NAME

    Remplacez EXECUTION_NAME par le nom du fichier.

  2. 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 une exécution de job à partir du code, procédez comme suit:

API REST

Pour supprimer une exécution de 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/executions/EXECUTION-NAME

Remplacez :

  • ACCESS_TOKEN par un jeton d'accès valide pour un compte disposant des autorisations IAM pour supprimer des exécutions de 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.
  • Remplacez EXECUTION-NAME par le nom de l'exécution de job.
  • REGION par la région Google Cloud du job.
  • PROJECT-ID par l'ID du projet Google Cloud.