Déclencher avec des événements

Vous pouvez créer un déclencheur Eventarc afin que votre service Cloud Run reçoive des notifications d'un événement ou d'un ensemble d'événements spécifié. En spécifiant des filtres pour le déclencheur, vous pouvez configurer le routage de l'événement, y compris la source de l'événement et le service Cloud Run cible.

Les événements envoyés à votre service Cloud Run sont reçus sous la forme de requêtes HTTP.

Les requêtes adressées à votre service sont déclenchées par les événements suivants :

Cette page vous explique comment créer un déclencheur via la page de la console Cloud Run.

Vous pouvez également créer un déclencheur Eventarc à l'aide de Google Cloud CLI ou via la page de la console Eventarc. Suivez les instructions pour créer un déclencheur pour un fournisseur, un type d'événement et une destination spécifiques.

Préparer la création d'un déclencheur

Avant de créer un déclencheur, procédez comme suit :

  1. Chaque déclencheur Eventarc est associé à un compte de service IAM (Identity and Access Management) au moment de sa création. Vous pouvez spécifier un compte de service géré par l'utilisateur que le déclencheur utilise comme identité par défaut. Assurez-vous d'accorder les rôles et autorisations nécessaires au compte de service du déclencheur.

    Par exemple, pour envoyer des événements à un service Cloud Run nécessitant une authentification, le compte de service du déclencheur Eventarc doit disposer du rôle IAM de "Demandeur Cloud Run".

  2. Si vous créez un déclencheur pour un événement direct à partir de Cloud Storage, attribuez le rôle pubsub.publisher au compte de service Cloud Storage :

    SERVICE_ACCOUNT="$(gsutil kms serviceaccount -p PROJECT_ID)"

gcloud projects add-iam-policy-binding PROJECT_ID \
    --member="serviceAccount:${SERVICE_ACCOUNT}" \
    --role='roles/pubsub.publisher'

    Remplacez PROJECT_ID par l'ID de votre projet Google Cloud. Vous pouvez trouver l'ID de votre projet sur la page de Bienvenue de Google Cloud Console.

Créer un déclencheur via la console

Vous pouvez utiliser la page de la console Cloud Run pour créer un déclencheur Eventarc.

  1. Si nécessaire, activez l'API Eventarc.

    Activer l'API

  2. Dans la console Google Cloud, accédez à Cloud Run.

    Accédez à Cloud Run

  3. Dans la liste des services, cliquez sur un service existant ou créez-en un.

  4. Sur la page d'informations du service, cliquez sur l'onglet Déclencheurs.

  5. Cliquez sur Ajouter un déclencheur Eventarc.

    Le volet Déclencheur Eventarc s'ouvre. Pour déterminer la meilleure façon d'acheminer les événements, consultez la page Options de routage des événements.

  6. Suivez les instructions pour créer un déclencheur pour un fournisseur, un type d'événement et une destination spécifiques, et reportez-vous aux instructions de la console dans la section "Créer un déclencheur".

  7. Sélectionnez le compte de service qui appelle votre service Cloud Run.

    ou Créer un nouveau compte de service

    Cela spécifie l'adresse e-mail du compte de service IAM associé au déclencheur. Pour les destinations Cloud Run, ce compte de service permet de générer des jetons d'identité lors de l'appel du service.

  8. Vous pouvez éventuellement spécifier le chemin d'URL du service auquel envoyer la requête entrante.

    Il s'agit du chemin relatif sur le service de destination auquel les événements du déclencheur doivent être envoyés. Par exemple : /, /route, route, route/subroute.

  9. Après avoir créé le déclencheur, vous pouvez vérifier son état en vous assurant qu'une coche s'affiche dans l'onglet Déclencheurs.

Étapes suivantes