Déclencheur Cloud Pub/Sub

Le déclencheur Cloud Pub/Sub vous permet d'exécuter votre intégration en fonction des événements de votre middleware Pub/Sub.

Ce déclencheur vous permet d'exécuter une intégration dès qu'un éditeur écrit un message dans le sujet de votre choix. Le sujet peut exister dans le même projet Google Cloud que l'intégration ou dans un autre projet Google Cloud. Lorsque ce déclencheur s'exécute, il écrit également le message publié dans la variable de sortie CloudPubSubMessage. Selon vos besoins, vous pouvez utiliser cette variable dans vos déclencheurs ou vos tâches en aval.

Avant de commencer

Assurez-vous d'effectuer les tâches suivantes dans votre projet Google Cloud avant de configurer le déclencheur Cloud Pub/Sub.

Attribuez le rôle Administrateur IAM de projet (roles/resourcemanager.projectIamAdmin) à l'utilisateur qui crée ce déclencheur.
Activez l'API Pub/Sub pour le projet Google Cloud associé à votre intégration.
Vérifiez que vous disposez d'un sujet Cloud Pub/Sub. Pour créer un sujet Pub/Sub :
1. Accédez à la page "Sujets Pub/Sub" dans Cloud Console.
  Accéder à la page "Sujets Pub/Sub"
2. Cliquez sur Create a topic (Créer un sujet).
3. Dans le champ ID du sujet, indiquez un nom de sujet unique.
4. Cliquez sur Enregistrer.
Remarque:Vous n'avez pas besoin de créer d'abonnement pour que le déclencheur fonctionne. Application Integration crée automatiquement un abonnement à un sujet lorsque vous publiez votre intégration. Vous pouvez afficher tous vos abonnements sur la page d'abonnement Pub/Sub.
À partir de la version d'Application Integration du 1er décembre 2023, vos abonnements vous seront facturés selon les tarifs de Pub/Sub. Les abonnements de votre déclencheur Cloud Pub/Sub existant continuent de fonctionner comme avant et ne sont pas facturés. Toutefois, si vous mettez à jour le sujet d'un déclencheur Cloud Pub/Sub existant, la facturation Pub/Sub sera appliquée au déclencheur Cloud Pub/Sub mis à jour.

Pour en savoir plus sur la gestion des accès à l'aide des rôles IAM, consultez la page Contrôle des accès.

Pour plus d'informations sur l'attribution de rôles aux comptes principaux, consultez la page Accorder, modifier et révoquer les accès.

Ajouter un déclencheur Cloud Pub/Sub

Pour ajouter un déclencheur Cloud Pub/Sub à une intégration nouvelle ou existante, procédez comme suit :

Dans la console Google Cloud, accédez à la page Application Integration.
Accéder à Application Integration
Dans le menu de navigation, cliquez sur Integrations (Intégrations).
La page Liste des intégrations s'affiche. Elle répertorie toutes les intégrations disponibles dans le projet Google Cloud.
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.
  Remarque : Le menu déroulant Régions ne répertorie que les régions provisionnées dans votre projet Google Cloud. Pour provisionner une nouvelle région, cliquez sur Activer la région. Pour en savoir plus, consultez la section Activer une nouvelle région.
3. Sélectionnez un compte de service pour l'intégration. Vous pouvez modifier ou mettre à jour les détails du compte de service d'une intégration à tout moment depuis le volet Résumé de l'intégration de dans la barre d'outils d'intégration.
  Remarque:L'option permettant de sélectionner un compte de service ne s'affiche que si vous avez activé la gouvernance de l'intégration pour la région sélectionnée.
4. Cliquez sur Créer.
La page de l'éditeur d'intégration s'affiche.
Dans la barre de navigation de l'éditeur d'intégration, cliquez sur Déclencheurs pour afficher la liste des déclencheurs disponibles.
Cliquez sur l'élément de déclencheur Cloud Pub/Sub et placez-le au niveau du concepteur.

Configurer un déclencheur Cloud Pub/Sub

Cliquez sur l'élément Déclencheur Cloud Pub/Sub dans l'éditeur d'intégrations pour afficher le volet de configuration du déclencheur, puis effectuez les tâches suivantes :

Spécifiez le sujet que le déclencheur doit écouter dans le champ Sujet Pub/Sub au format suivant :
```
projects/PROJECT_ID/topics/TOPIC_ID
```
Pour afficher tous les sujets disponibles dans votre projet Google Cloud, consultez la colonne Nom du sujet dans la section Sujets.
Remplacez l'élément suivant :
- PROJECT_ID : le projet Google Cloud dans lequel votre sujet a été créé.
- TOPIC_ID : l'ID de votre sujet Pub/Sub. Le sujet peut se trouver dans le même projet Google Cloud que votre intégration ou dans un autre projet Google Cloud.
Sélectionnez le compte de service que vous souhaitez utiliser pour le déclencheur. Lorsque vous sélectionnez un compte de service, vous êtes invité à attribuer les rôles requis. Pour en savoir plus, consultez la section Rôles IAM requis.
Si aucun compte de service ne s'affiche, créez-en un en cliquant sur Créer dans la liste déroulante Compte de service.

Remarque : À partir de la version du 1er décembre 2023 d'Application Integration, vous devez spécifier un compte de service pour la configuration du déclencheur Cloud Pub/Sub. Vos déclencheurs Pub/Sub existants, auxquels aucun compte de service n'est associé, continueront de fonctionner comme avant. Toutefois, si vous souhaitez modifier l'un des déclencheurs Pub/Sub existants, vous devez configurer un compte de service pour continuer à les utiliser.

Remarque:Par défaut, l'option de période d'expiration pour les abonnements est définie sur never expire. Si vous souhaitez définir le délai d'expiration sur une autre valeur, accédez à la page d'abonnement Pub/Sub dans la console Google Cloud, puis modifiez l'abonnement.

Rôles IAM requis pour les comptes de service

Lorsque vous cliquez sur Attribuer lors de la sélection d'un compte de service, les rôles suivants sont automatiquement attribués aux différents comptes de service.

Compte de service Rôle IAM accordé

Compte de service	Rôle IAM accordé
Compte de service par défaut d'Application Integration: `service-PROJECT_NUMBER@gcp-sa-integrations.iam.gserviceaccount.com`	Éditeur Pub/Sub (`roles/pubsub.editor`) Utilisateur du compte de service (`roles/iam.serviceAccountUser`) Si le projet Google Cloud associé au sujet Pub/Sub est différent du projet Google Cloud associé à l'intégration, le compte de service par défaut doit disposer du rôle "Éditeur Pub/Sub" dans le projet Google Cloud associé au sujet.
Compte de service que vous sélectionnez pour ce déclencheur	Demandeur Application Integration (`roles/integrations.integrationInvoker`)

Compte de service par défaut d'Application Integration: service-PROJECT_NUMBER@gcp-sa-integrations.iam.gserviceaccount.com

Éditeur Pub/Sub (roles/pubsub.editor)
Utilisateur du compte de service (roles/iam.serviceAccountUser)

Si le projet Google Cloud associé au sujet Pub/Sub est différent du projet Google Cloud associé à l'intégration, le compte de service par défaut doit disposer du rôle "Éditeur Pub/Sub" dans le projet Google Cloud associé au sujet.

Compte de service que vous sélectionnez pour ce déclencheur Demandeur Application Integration (roles/integrations.integrationInvoker)

Sortie du déclencheur

Pour chaque événement, le déclencheur Cloud Pub/Sub génère une variable de sortie CloudPubSubMessage que vous pouvez utiliser dans vos tâches en aval. La variable est au format JSON et possède la structure PubsubMessage.

Remarques

La taille maximale d'un message Pub/Sub est de 10 Mo. Pour comprendre toutes les limitations de Pub/Sub, consultez la page Quotas et limites de Pub/Sub.
Il est possible que Pub/Sub écrive le même message plusieurs fois dans un sujet. Pour comprendre ce comportement de Pub/Sub, consultez la section Distribution de type "au moins une fois". Par conséquent, vous devez concevoir votre intégration de manière à ce qu'elle soit idempotente afin qu'un message ne puisse pas être écrit plusieurs fois dans un sujet.
Remarque : Le champ message_id de l'en-tête du message identifie de manière unique un message Pub/Sub.
Si vous annulez la publication d'une intégration, l'abonnement Pub/Sub n'est pas supprimé pour éviter toute perte de messages. Toutefois, si vous supprimez la version publiée ou toutes les versions d'une intégration, l'abonnement Pub/Sub est également supprimé.

Créer un abonnement avec un filtre pour votre intégration

Si vous souhaitez définir un filtre pour l'abonnement Pub/Sub afin de traiter des événements spécifiques dans votre intégration, procédez comme suit:

Publiez l'intégration avec le déclencheur Cloud Pub/Sub configuré. Cette étape crée l'abonnement dans le projet d'intégration.
Dans la console Google Cloud, accédez à la page Abonnements.
Accéder aux abonnements
Ouvrez l'abonnement et copiez tous les détails, y compris son nom.
Supprimez l'abonnement existant.
Créez un abonnement contenant tous les détails de l'abonnement supprimé que vous avez copié à l'étape 3, y compris son nom, puis ajoutez un filtre au nouvel abonnement.
Le nouvel abonnement déclenche l'intégration avec les messages filtrés.

Exclusions du Contrat de niveau de service

Le déclencheur Cloud Pub/Sub dépend du produit Pub/Sub. Comme cette dépendance est externe à Application Integration, les conditions d'utilisation du Contrat de niveau de service d'Application Integration ne s'appliquent que lorsque le déclencheur Cloud Pub/Sub lance l'exécution d'une intégration active.