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 APIGoogle 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 pages 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 consoleGoogle Cloud , de gcloud CLI, des bibliothèques clientes ou de l'API REST :

Console

Pour afficher la liste des exécutions d'un job, procédez comme suit :

  1. Dans la console Google Cloud , accédez à la page des jobs Cloud Run :

    Accéder aux jobs Cloud Run

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

  3. Sur la page des détails d'exécution, sélectionnez l'exécution qui vous intéresse dans la liste. Vous pouvez également filtrer les résultats selon des critères.

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'un job spécifique, exécutez la commande suivante :

    gcloud run jobs executions list --job JOB

    Remplacez JOB 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 tâches.

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

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

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

Vous pouvez également consulter les détails de la dernière exécution de votre job. Pour ce faire, consultez Afficher les détails de l'exécution d'un job.

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

Remplacez les éléments suivants :

  • ACCESS_TOKEN : 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.
  • PROJECT_ID : ID du projet Google Cloud .
  • REGION : Google Cloud région du job.
  • JOB par le nom de votre job Cloud Run

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

Vous pouvez consulter les détails des 1 000 exécutions de job les plus récentes à l'aide du volet des détails d'exécution. 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 afficher plus de détails sur l'exécution d'un job à l'aide de la console Google Cloud , de gcloud CLI, des bibliothèques clientes ou de l'API REST :

Console

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

  1. Dans la console Google Cloud , accédez à la page des jobs Cloud Run :

    Accéder aux jobs 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. Pour en savoir plus, consultez les onglets Tâches, Conteneurs, Volumes, Mise en réseau, Sécurité et YAML.

gcloud

Pour afficher les détails d'une exécution de job, exécutez les commandes suivantes :

  • Pour décrire une exécution de job spécifique :

    gcloud run jobs executions describe EXECUTION_NAME

    Remplacez EXECUTION_NAME par le nom de l'exécution.

    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

  • Pour décrire la dernière exécution d'un job :

    gcloud run jobs executions describe-latest --job=JOB

    Remplacez JOB par le nom de la tâche.

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/executions/EXECUTION_NAME

Remplacez les éléments suivants :

  • ACCESS_TOKEN : jeton d'accès valide pour un compte disposant des autorisations IAM pour afficher les détails d'exécution 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.
  • PROJECT_ID : ID du projet Google Cloud .
  • REGION : Google Cloud région du job.
  • JOB par le nom de votre job Cloud Run
  • EXECUTION_NAME : nom de l'exécution du job.

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. Dans la console Google Cloud , accédez à la page des jobs Cloud Run :

    Accéder aux jobs 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 job, procédez comme suit :

  1. Exécutez la commande suivante :

    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/executions/EXECUTION_NAME

Remplacez les éléments suivants :

  • ACCESS_TOKEN : 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.
  • PROJECT_ID : ID du projet Google Cloud .
  • REGION : Google Cloud région du job.
  • JOB par le nom de votre job Cloud Run
  • EXECUTION_NAME : nom de l'exécution du job.