Déclencheurs Cloud Run Functions

Remarque : Ce contenu ne s'applique qu'à Cloud Run Functions (anciennement Cloud Functions (2nd gen)).

Pour obtenir la version de 1re génération de ce document, consultez Déclencheurs Cloud Run Functions (1re génération).

Vous pouvez configurer Cloud Run Functions pour qu'il s'exécute en réponse à divers scénarios en spécifiant un déclencheur pour votre fonction. Les déclencheurs peuvent être des requêtes HTTP(S) ou l'un des événements compatibles. Cette page présente les déclencheurs compatibles avec Cloud Run Functions.

De manière générale, les déclencheurs appartiennent à deux catégories:

• Les déclencheurs HTTP, qui réagissent aux requêtes HTTP(S) et correspondent aux fonctions HTTP.

• Les déclencheurs d'événements, qui réagissent aux événements au sein de votre projet Google Cloud et correspondent aux fonctions basées sur des événements.

Vous spécifiez des déclencheurs lors du déploiement de la fonction. Vous ne pouvez pas lier la même fonction à plusieurs déclencheurs à la fois, mais le même événement peut entraîner l'exécution de plusieurs fonctions en déployant plusieurs fonctions avec les mêmes paramètres de déclencheur.

Remarque : La liaison de déclencheur ne se produit pas instantanément. Le déclenchement d'une fonction déployée sur des événements entrants peut prendre plusieurs minutes.

Déclencheurs acceptés

Cloud Run Functions est compatible avec les types de déclencheurs suivants :

• Déclencheurs HTTP
• Déclencheurs d'événements :
  • Déclencheurs Pub/Sub
  • Déclencheurs Cloud Storage
  • Déclencheurs Firestore
  • Déclencheurs Eventarc généralisés
    • Compatible avec tous les types d'événements compatibles avec Eventarc, y compris plus de 90 sources d'événements via Cloud Audit Logging

Toutes les fonctions basées sur des événements utilisent Eventarc pour la diffusion d'événements. Les déclencheurs Pub/Sub et Cloud Storage sont implémentés en tant que types particuliers de déclencheurs Eventarc.

Remarque : Eventarc n'est actuellement pas compatible avec les événements directs de Google Analytics pour Firebase ou Firebase Authentication.

Déclencheurs supplémentaires via Pub/Sub et les webhooks

Cloud Run Functions pouvant être déclenché par des messages sur un sujet Pub/Sub, vous pouvez l'intégrer à n'importe quel service Google compatible avec Pub/Sub en tant que bus d'événement. En outre, l'utilisation de déclencheurs HTTP vous permet également de les intégrer à tout service fournissant des rappels HTTP (webhooks). Les sections suivantes décrivent quelques exemples d'intégrations.

Cloud Logging

Cloud Logging peut acheminer les journaux vers un sujet Pub/Sub, où ils peuvent être utilisés par Cloud Run Functions. Pour en savoir plus, consultez la page Configurer et gérer les récepteurs dans la documentation Cloud Logging.

Cloud Scheduler

Vous pouvez planifier une fonction Cloud HTTP en créant un job Cloud Scheduler qui déclenche une action à l'aide du protocole HTTP. Pour en savoir plus, consultez la page Planifier une fonction Cloud Run HTTP dans la documentation de Cloud Scheduler.

Vous pouvez planifier une fonction basée sur des événements lorsqu'elle doit être déclenchée directement en réponse à des événements au sein de votre projet Google Cloud. Par exemple, lorsqu'un message est publié dans un sujet Pub/Sub. Pour en savoir plus, consultez la page Planifier une fonction Cloud Run basée sur des événements dans la documentation de Cloud Scheduler.

Cloud Tasks

Les tâches HTTP Target de Cloud Tasks vous permettent d'exécuter des gestionnaires de tâches sur n'importe quel point de terminaison HTTP. Vous pouvez donc utiliser une fonction Cloud Run avec un déclencheur HTTP comme gestionnaire de tâches. Vous pouvez également utiliser des tâches pour limiter les appels de fonction. Consultez la section Créer des tâches HTTP Target dans la documentation Cloud Tasks pour en savoir plus.

Gmail

À l'aide de l'API Push Notification de Gmail, vous pouvez envoyer des événements Gmail à un sujet Pub/Sub et les utiliser avec Cloud Run Functions.