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. Eventarc utilise un compte de service fourni par le client comme identité du déclencheur. 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 (Identity and Access Management) 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 Cloud Run 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