Configurer un déclencheur Eventarc

Cette page explique comment configurer un déclencheur Eventarc dans Application Integration.

Un déclencheur Eventarc vous permet d'exécuter des intégrations basées sur des événements acheminés via Eventarc Standard. À l'aide d'un déclencheur Eventarc, vous pouvez créer des flux d'intégration déclenchés par des événements provenant de divers Google Cloud services, de services tiers et de sources d'événements personnalisées. Par exemple, vous pouvez utiliser le déclencheur pour lancer une intégration lorsqu'un nouvel objet est importé dans un bucket Cloud Storage.

Dans la Google Cloud console, vous pouvez créer et configurer un déclencheur Eventarc de différentes manières :

Avant de commencer

Avant de configurer le déclencheur Eventarc, activez l'API Eventarc et l'API Pub/Sub :

Rôles requis pour activer les API

Pour activer les API, vous devez disposer de l'autorisation serviceusage.services.enable. Si vous avez créé le projet, vous disposez probablement déjà de cette autorisation via le rôle Propriétaire (roles/owner). Sinon, vous pouvez l'obtenir via le rôle Administrateur d'utilisation du service (roles/serviceusage.serviceUsageAdmin). Découvrez comment attribuer des rôles.

Activer les API

Remarques

Tenez compte des points suivants lorsque vous configurez un déclencheur Eventarc :

  • Si la création du déclencheur Eventarc échoue lors de la publication de l'intégration en raison d' erreurs de configuration, votre intégration sera toujours publiée, mais le déclencheur ne sera pas actif.

    Pour résoudre ce problème, annulez la publication de l'intégration, examinez et corrigez attentivement la configuration du déclencheur Eventarc, puis republiez l'intégration. Vous pouvez vérifier l'état de création du déclencheur Eventarc en cliquant sur (Notification) dans la barre d'outils de la console Google Cloud.

  • La publication d'une nouvelle version de votre intégration avec une configuration de déclencheur Eventarc configuration modifiée remplace automatiquement l'ancien déclencheur par un nouveau. Cela garantit que votre intégration utilise toujours la dernière configuration de déclencheur et supprime tous les déclencheurs obsolètes.
  • Si vous publiez une nouvelle version de votre intégration et que vous utilisez le même déclencheur Eventarc et sa configuration, aucun nouveau déclencheur n'est créé. Au lieu de cela, le déclencheur Eventarc existant est réutilisé pour votre nouvelle version d'intégration.

Créer un déclencheur Eventarc à partir d'Application Integration

Pour créer un déclencheur Eventarc à partir d'Application Integration, procédez comme suit :

  1. Ajouter le déclencheur Eventarc dans Application Integration
  2. Configurer le déclencheur Eventarc dans l'éditeur d'intégration

Ajouter le déclencheur Eventarc

Pour ajouter un déclencheur Eventarc à votre intégration, procédez comme suit :

  1. Dans la Google Cloud console, accédez à la page Application Integration.

    Accéder à Application Integration

  2. Dans le menu de navigation, cliquez sur Intégrations.

    La page Liste des intégrations s'affiche et répertorie toutes les intégrations disponibles dans le projet Google Cloud.

  3. Sélectionnez une intégration existante ou cliquez sur Créer une intégration pour en créer une.

    Si vous créez une intégration :

    1. Saisissez un nom et une description dans le volet Créer une intégration.
    2. Sélectionnez une région pour l'intégration.
    3. Sélectionnez un compte de service pour l'intégration. Vous pouvez modifier ou mettre à jour les informations du compte de service d'une intégration à tout moment à partir du Résumé de l'intégration volet dans la barre d'outils d'intégration.
    4. Cliquez sur Créer.

    L'intégration nouvellement créée s'ouvre dans l'éditeur d'intégration.

  4. Dans la barre de navigation de l'éditeur d'intégration, cliquez sur Déclencheurs pour afficher la liste des déclencheurs disponibles.
  5. Faites glisser l'élément Eventarc dans l'éditeur d'intégration.

Configurer le déclencheur Eventarc

Pour configurer un déclencheur Eventarc, cliquez sur l'élément Déclencheur Eventarc dans l'éditeur d'intégration. Le volet de configuration Déclencheur Eventarc s'affiche et contient les champs suivants :

  • Libellé : (facultatif) nom visible du déclencheur Eventarc dans votre intégration. Vous pouvez remplacer le libellé par le nom de votre choix.
  • Remarques : (facultatif) vous pouvez ajouter des notes pour fournir des informations supplémentaires sur le déclencheur.
  • Cliquez sur Configurer le déclencheur Eventarc et saisissez les entrées suivantes dans l'éditeur de déclencheur Eventarc :
    • Nom du déclencheur : saisissez un nom pour le déclencheur.
    • Type de déclencheur : sélectionnez l'un des types de déclencheur suivants :
      • Source Google : sélectionnez cette option pour créer un déclencheur pour Pub/Sub, Cloud Storage, Firestore et d'autres fournisseurs d'événements Google.
      • Personnalisé : sélectionnez cette option pour créer un déclencheur pour une source d'événements personnalisée.
      • Tiers : sélectionnez cette option pour créer un déclencheur pour les fournisseurs non-Google qui proposent une source Eventarc. Pour en savoir plus, consultez la section Événements tiers dans Eventarc.
    • Fournisseur d'événements : sélectionnez le fournisseur d'événements pour le déclencheur. La liste des fournisseurs d'événements dépend du type de déclencheur. Pour en savoir plus, consultez la section Fournisseurs et destinations d'événements.
    • Type d'événement : sélectionnez le type d'événement pour le déclencheur. La configuration de votre déclencheur varie en fonction du fournisseur d'événements que vous sélectionnez. Pour en savoir plus, consultez la section Types d'événements.
    • Région : sélectionnez la région pour le déclencheur.
    • Filtres : (facultatif) ajoutez des filtres pour sélectionner les API qui correspondent à vos critères. Par exemple, si vous filtrez les API par un nom spécifique, l'événement n'est déclenché que si les API correspondant aux critères de filtre sont mises à jour.
    • Compte de service : sélectionnez le compte de service à utiliser pour le déclencheur. Si vous ne sélectionnez pas de compte de service, le déclencheur utilise le compte de service Compute Engine par défaut comme identité lors de l'appel de votre service. Le compte de service associé au déclencheur doit disposer des autorisations requises pour appeler votre service.

    • Réessayer après échec : sélectionnez cette option pour activer les nouvelles tentatives de déclencheur si la destination ne parvient pas à traiter l'événement.
    • Rattachement de réseau : sélectionnez le rattachement de réseau à utiliser pour le déclencheur. Cette liste est générée en fonction des rattachements de réseau créés dans votre projet.

      Les rattachements de réseau facilitent la communication entre les réseaux de cloud privé virtuel (VPC) du producteur de services et les réseaux de cloud privé virtuel (VPC) du client. Eventarc utilise le rattachement de réseau configuré pour établir une connexion à un point de terminaison HTTP interne hébergé dans le réseau VPC du client, ce qui permet de fournir des données d'événement. Pour en savoir plus sur la création et la gestion des rattachements de réseau, consultez la section Créer et gérer des rattachements de réseau.

  • Pour enregistrer la configuration du déclencheur, cliquez sur Enregistrer le déclencheur.

Créer un déclencheur Eventarc à l'aide de la console Eventarc

Pour créer un déclencheur Eventarc à partir de la page de la console Eventarc, procédez comme suit :

  1. Dans la Google Cloud console, accédez à la page Eventarc > Déclencheurs.

    Accéder à la page "Déclencheurs"

    La page Déclencheurs répertorie tous les déclencheurs de votre projet.

  2. Cliquez sur Créer un déclencheur.
  3. Sur la page Créer un déclencheur, saisissez les entrées suivantes :
    1. Nom du déclencheur : saisissez un nom pour le déclencheur.
    2. Type de déclencheur : sélectionnez l'un des types de déclencheur suivants :
      • Sources Google : sélectionnez cette option pour créer un déclencheur pour Pub/Sub, Cloud Storage, Firestore et d'autres fournisseurs d'événements Google.
      • Personnalisé : sélectionnez cette option pour créer un déclencheur pour une source d'événements personnalisée.
      • Tiers : sélectionnez cette option pour créer un déclencheur pour les fournisseurs non-Google qui proposent une source Eventarc. Pour en savoir plus, consultez la section Événements tiers dans Eventarc.
    3. Fournisseur d'événements : sélectionnez le fournisseur d'événements pour le déclencheur. La liste des fournisseurs d'événements dépend du type de déclencheur. Pour en savoir plus, consultez la section Fournisseurs et destinations d'événements.
    4. Type d'événement : sélectionnez le type d'événement pour le déclencheur. La configuration de votre déclencheur varie en fonction du fournisseur d'événements que vous sélectionnez. Pour en savoir plus, consultez la section Types d'événements.
    5. Type de contenu des données d'événement : sélectionnez le type de données pour le contenu de l'événement. Sélectionnez application/json ou application/protobuf.
    6. Région : sélectionnez la région pour le déclencheur.
    7. Compte de service : sélectionnez le compte de service à utiliser pour le déclencheur. Si vous ne sélectionnez pas de compte de service, le déclencheur utilise le compte de service Compute Engine par défaut comme identité lors de l'appel de votre service. Le compte de service associé au déclencheur doit disposer des autorisations requises pour appeler votre service.
    8. Destination de l'événement : sélectionnez Application Integration.
    9. Sélectionner une intégration : sélectionnez l'intégration pour laquelle vous souhaitez créer le déclencheur. Si l'intégration est publiée, Application Integration crée une nouvelle version brouillon de l' intégration pour y ajouter le déclencheur Eventarc.
    10. Rattachement de réseau : sélectionnez le rattachement de réseau à utiliser pour le déclencheur. Cette liste est générée en fonction des rattachements de réseau créés dans votre projet.

      Les rattachements de réseau facilitent la communication entre les réseaux de cloud privé virtuel (VPC) du producteur de services et les réseaux VPC du client. Eventarc uses the configured network attachment to establish a connection to an internal HTTP endpoint hosted within the consumer's VPC network, enabling delivery of event data. Pour en savoir plus sur les rattachements de réseau, consultez la section À propos des rattachements de réseau.

  4. Cliquez sur Ouvrir l'intégration.

    La page de l'éditeur Application Integration s'ouvre avec l'intégration sélectionnée et le nouvel élément Déclencheur Eventarc ajouté à l'intégration.

  5. Cliquez sur l'élément Déclencheur Eventarc et ouvrez le volet de configuration du déclencheur.
  6. Vérifiez la configuration du déclencheur sur la page Éditeur de déclencheur Eventarc.
  7. Connectez le nouveau déclencheur Eventarc à votre flux d'intégration et publiez l'intégration.