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 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 tâches dans votre projet
Vous pouvez afficher la liste des jobs de votre projet à l'aide de la console Google Cloud , de la gcloud CLI, des bibliothèques clientes ou de l'API REST :
Console
Dans la console Google Cloud , accédez à la page des jobs Cloud Run :
Facultatif : Filtrez le job selon l'un des critères disponibles dans le menu, tels que le nom du job, la durée d'exécution ou la région.
gcloud
Pour lister tous les jobs de votre projet, exécutez la commande suivante :
gcloud run jobs list
Pour filtrer les jobs par région, exécutez la commande suivante :
gcloud run jobs list --region REGION
Remplacez REGION par le nom de la région que vous souhaitez filtrer, par exemple europe-west1.
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 les éléments suivants :
ACCESS_TOKEN: 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 degcloud 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.
Afficher les informations sur le job
Vous pouvez afficher plus de détails sur un job à l'aide de la console Google Cloud , de la gcloud CLI, des bibliothèques clientes ou de l'API REST :
Console
Dans la console Google Cloud , 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.
Accédez aux onglets Historique, Journaux, Métriques 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 des informations sur un job, exécutez la commande suivante :
gcloud run jobs describe JOB
Remplacez JOB par le nom de la tâche.
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
Remplacez les éléments suivants :
ACCESS_TOKEN: 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 degcloud 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.JOBpar le nom de votre job Cloud Run
Supprimer un job
La suppression d'un job met fin à toutes les exécutions de job en cours et à toutes les instances de conteneur en cours d'exécution.
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
Dans la console Google Cloud , accédez à la page des jobs Cloud Run :
Sélectionnez le job.
Cliquez sur Supprimer.
Cliquez sur Confirmer.
gcloud
Pour supprimer un job, exécutez la commande suivante :
gcloud run jobs delete JOB
Remplacez JOB par le nom de la tâche.
Si vous êtes invité à confirmer votre choix, répondez y. Une fois l'opération terminée, 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
Remplacez les éléments suivants :
ACCESS_TOKEN: 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 degcloud 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.JOBpar le nom de votre job Cloud Run