Ce tutoriel explique comment planifier une fonction Cloud Run HTTP en ciblant un point de terminaison HTTP dans Cloud Scheduler. Utilisez une fonction HTTP lorsque vous avez besoin que votre fonction dispose d'un point de terminaison d'URL et réponde aux requêtes HTTP, par exemple pour les webhooks.
Si vous avez créé une fonction CloudEvents, vous pouvez également utiliser des déclencheurs d'événements Eventarc pour planifier votre fonction afin qu'elle réponde aux événements de votre projet. Eventarc peut déclencher des messages sur un sujet Pub/Sub, des modifications dans un bucket Cloud Storage, et plus encore. Pour en savoir plus, consultez Types de fonctions Cloud Run.
La planification de l'exécution d'une fonction Cloud Run est un cas d'utilisation courant pour Cloud Scheduler. Au cours de ce tutoriel, vous allez :
Créer une fonction Cloud Run HTTP
Créez une fonction HTTP déclenchée par Cloud Scheduler.
Dans la console Google Cloud , accédez à la page Cloud Run.
Cliquez sur Écrire une fonction.
Dans la section Configurer, procédez comme suit :
- Dans le champ Nom du service, saisissez un nom pour votre fonction.
- Dans la liste Région, sélectionnez une région.
- Ne modifiez pas la langue d'exécution par défaut.
Pour l'authentification, sélectionnez Exiger l'authentification.
Si vous êtes soumis à une règle d'administration de restriction de domaine limitant les appels non authentifiés pour votre projet, vous devez accéder au service déployé comme décrit dans la section Tester les services privés.
Pour en savoir plus, consultez Authentification pour l'appel.
Acceptez les autres paramètres par défaut et cliquez sur Créer.
Copiez l'URL HTTP de la fonction.
Pour en savoir plus, y compris sur le déploiement d'une fonction Cloud Run à l'aide de Terraform, consultez Déployer une fonction Cloud Run.
Créer une tâche Cloud Scheduler
Créez un job Cloud Scheduler qui déclenche une action à l'aide du protocole HTTP.
Dans la console Google Cloud , accédez à la page Cloud Scheduler.
Cliquez sur > Créer un job.
Saisissez un nom pour votre tâche.
Dans la liste Région, sélectionnez une région.
Spécifiez la fréquence de votre tâche en utilisant un format unix-cron :
30 16 * * 7Pour en savoir plus, consultez Format et fuseau horaire des jobs Cron.
Dans la liste Fuseau horaire, sélectionnez un fuseau horaire.
Cliquez sur Continuer.
Dans la liste Type de cible, sélectionnez HTTP.
Dans le champ URL, saisissez l'URL HTTP de la fonction que vous avez copiée précédemment.
Dans la liste En-tête de l'authentification, sélectionnez Ajouter un jeton OIDC.
Dans la liste Compte de service, sélectionnez le compte de service que vous avez créé précédemment.
Dans le champ Audience, saisissez l'URL HTTP de la fonction que vous avez copiée précédemment.
Cliquez sur Créer.
Vous avez créé un job cron qui exécute votre fonction Cloud Run à 16h30 le dimanche.
Exécuter votre tâche Cloud Scheduler
Vous pouvez maintenant exécuter le job que vous avez créé.
Dans la console Google Cloud , accédez à la page Cloud Scheduler.
Cochez la case correspondant au job que vous avez créé, puis cliquez sur Forcer l'exécution.
Lors de sa première invocation, la première tâche créée dans un projet peut prendre quelques minutes à configurer et à exécuter.
Une fois le job exécuté, l'état de la dernière exécution doit indiquer
Success.
Vérifier les résultats dans Cloud Run Functions
Vous pouvez vérifier que votre fonction Cloud Run est correctement déclenchée et exécutée par votre job Cron.
Dans la console Google Cloud , accédez à la page Cloud Run.
Sélectionnez Filtrer les services > Type de déploiement > Fonction. La liste des services est filtrée pour n'afficher que les fonctions.
Cliquez sur le nom de la fonction.
La page Informations sur le service s'ouvre et affiche les métriques du service.
Cliquez sur l'onglet Journaux.
Une entrée de journal semblable à
POST 200 146 B 5 ms Google-Cloud-Scheduler https://FUNCTION_NAMEdoit s'afficher.