Consultez les connecteurs compatibles avec Application Integration.

Déclencheur "Trouver"

Preview — Solace trigger

Cette fonctionnalité est soumise aux "Conditions des offres de pré-DG" dans la section "Conditions d'utilisation générales" des Conditions spécifiques au service. Les fonctionnalités pré-DG sont disponibles "en l'état" et peuvent avoir une assistance limitée. Pour en savoir plus, consultez les descriptions des étapes de lancement.

Le déclencheur de la source est un déclencheur d'événement de connecteur qui vous permet d'appeler une intégration en fonction des événements de sol auxquels vous êtes abonné dans votre connexion Solace.

Important:Integration Connectors est un composant facturable de Google Cloud. Pour en savoir plus sur les coûts d'utilisation d'Integration Connectors, consultez les tarifs d'Integration Connectors.

Avant de commencer

Si vous envisagez de créer ou de configurer une nouvelle connexion pour le déclencheur de la sélection, assurez-vous de disposer du rôle IAM suivant sur le projet:

• Administrateur du connecteur (roles/connectors.admin)

Pour en savoir plus sur l'attribution de rôles, consultez Gérer l'accès.

Attribuez les rôles IAM suivants au compte de service que vous souhaitez utiliser pour le déclencheur Solace :

• Demandeur Application Integration (roles/integrations.integrationInvoker)

Pour en savoir plus sur l'attribution d'un rôle à un compte de service, consultez la page Gérer l'accès aux comptes de service.

Remarque : Le déclencheur Solace est compatible avec le protocole JMS (Java Message Service). Les autres protocoles, tels que MQTT et AMQP, ne sont pas compatibles.

Ajouter le déclencheur Solace

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

1. Dans la console Google Cloud, 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 liste 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.
      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 à partir du volet Integration summary (Résumé de l'intégration) 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.

   Cela entraîne son ouverture dans l'éditeur d'intégrations.

4. Dans la barre de navigation de l'éditeur d'intégrations, cliquez sur Déclencheurs pour afficher la liste des déclencheurs disponibles.
5. Cliquez sur l'élément Déclencheur Solace et placez-le dans l'éditeur d'intégrations.

Pour configurer le déclencheur Solace, vous pouvez soit utiliser une connexion Solace existante disponible dans Integration Connectors, soit créer une connexion Solace à l'aide de l'option de création de connexion intégrée.

Configurer le déclencheur Solace à l'aide d'une connexion existante

Vous pouvez configurer le déclencheur Solace à l'aide d'une connexion Solace existante dans Integration Connectors. Notez que le déclencheur "Solace" est un déclencheur d'événement de connecteur. Par conséquent, vous ne pouvez utiliser qu'une connexion Solace avec l'abonnement aux événements activé pour configurer le déclencheur.

Pour savoir comment configurer un déclencheur Solace à l'aide d'une nouvelle connexion Solace, consultez Configurer un déclencheur Solace à l'aide d'une nouvelle connexion.

Pour configurer un déclencheur Solace à l'aide d'une connexion Solace existante, procédez comme suit:

1. Cliquez sur l'élément Déclencheur spécifique dans l'éditeur d'intégration pour ouvrir le volet de configuration du déclencheur.
2. Cliquez sur Configurer un déclencheur.
3. Fournissez les informations de configuration suivantes sur la page Éditeur de déclencheurs d'événements de connecteur:
   1. Région : sélectionnez la région de votre connexion Solace.
   2. Connexion:sélectionnez la connexion Solace que vous souhaitez utiliser.

      Application Integration n'affiche que les connexions Solace actives et pour lesquelles un abonnement aux événements est activé.

   3. Sélectionnez Queue ou SujetJMS Source Type comme JMS Source Type.
      • Si vous sélectionnez Queue, indiquez le nom de la file d'attente Solace dans la colonne JMS Source Name.
      • Si vous sélectionnez Topic, indiquez le nom du sujet Solace dans la colonne "Nom de la source JMS".
   4. Compte de service : sélectionnez un compte de service disposant des rôles IAM requis pour le déclencheur Solace.
4. Cliquez sur OK pour terminer la configuration du déclencheur et fermer la page.

Configurer le déclencheur Solace à l'aide d'une nouvelle connexion

Pour configurer le déclencheur Solace à l'aide d'une nouvelle connexion Solace, procédez comme suit:

1. Cliquez sur l'élément Déclencheur Solace dans l'éditeur d'intégrations pour ouvrir le volet de configuration du déclencheur.
2. Cliquez sur Configurer un déclencheur.
3. Ignorez le champ Région.
4. Cliquez sur Connexion, puis sélectionnez l'option Créer une connexion dans le menu déroulant.
5. Procédez comme suit dans le volet Créer une connexion :
   1. À l'étape Emplacement, choisissez l'emplacement de la nouvelle connexion Solace :
      1. Région : sélectionnez un emplacement dans la liste déroulante.

         Pour obtenir la liste de toutes les régions disponibles, consultez la page Emplacements.

      2. Cliquez sur Suivant.
   2. Dans la section Détails de la connexion, procédez comme suit:
      1. Connecteur : sélectionnez Solace dans la liste déroulante des connecteurs disponibles.
      2. Version du connecteur : sélectionnez la version du connecteur dans la liste déroulante des versions disponibles.
      3. Dans le champ Nom de connexion, saisissez un nom pour l'instance de connexion.

         Les noms de connexion doivent répondre aux critères suivants :

         • Les noms de connexion peuvent contenir des lettres, des chiffres ou des traits d'union.
         • Les lettres doivent être en minuscules.
         • Les noms de connexion doivent commencer par une lettre et se terminer par une lettre ou un chiffre.
         • Les noms de connexion ne doivent pas dépasser 49 caractères.
         • Pour les connecteurs compatibles avec l'abonnement aux événements, les noms de connexion ne peuvent pas commencer par le préfixe "goog".
      4. Saisissez éventuellement une Description pour l'instance de connexion.
      5. Compte de service : sélectionnez un compte de service disposant des rôles requis.
      6. Pour utiliser la connexion pour souscrire des abonnements à des événements, sélectionnez Activer l'abonnement aux événements. Sélection... active l'abonnement à l'événement avec des actions.
         Remarque : L'option Enable only event subscription n'est pas compatibles avec cette connexion.
      7. Message VPN : VPN de message du routeur de messages Solace Pub/Sub+ auquel vous souhaitez vous connecter. Une connexion est spécifique à un VPN Message. Si vous disposez d'un grand nombre de messages VPN, vous devez créer pour chaque message VPN.
      8. Nom de la file d'attente par défaut : nom de la file d'attente par défaut, peut être remplacé lors de l'exécution d'une action.
      9. Default Topic Name (Nom du sujet par défaut) : nom du sujet auquel se connecter.
      10. Vous pouvez également configurer les paramètres du nœud de connexion :
          • Nombre minimal de nœuds : saisissez le nombre minimal de nœuds de connexion.
          • Nombre maximal de nœuds : saisissez le nombre maximal de nœuds de connexion.

          Un nœud est une unité (ou instance répliquée) de connexion qui traite des transactions. Pour traiter plus de transactions pour une connexion, plus de nœuds sont nécessaires. À l'inverse, moins de nœuds sont nécessaires pour traiter moins de transactions. Pour comprendre comment les nœuds affectent la tarification de votre connecteur, consultez la section Tarifs des nœuds de connexion. Si vous ne saisissez aucune valeur, le nombre minimal de nœuds est défini par défaut sur 2 (pour une meilleure disponibilité) et le nombre maximal sur 50.

      Remarque : Vous ne pouvez personnaliser les valeurs du nœud de connexion que si vous êtes un client facturé à l'usage.
      11. Vous pouvez également cliquer sur + Ajouter un libellé pour ajouter un libellé à la connexion sous la forme d'une paire clé/valeur.
      12. Cliquez sur Suivant.
   3. Dans la section Destinations, saisissez les informations concernant l'hôte distant (système backend) auquel vous souhaitez vous connecter.
      1. Type de destination : sélectionnez un type de destination.
         • Sélectionnez Adresse hôte dans la liste pour spécifier le nom d'hôte ou l'adresse IP de la destination.
         • Si vous souhaitez établir une connexion privée à vos systèmes backend, sélectionnez Rattachement du point de terminaison dans la liste, puis sélectionnez le rattachement du point de terminaison requis dans la liste Rattachement du point de terminaison.
           Remarque : Pour savoir comment créer un rattachement du point de terminaison, consultez Rattachement de service PSC et Rattachement du point de terminaison. Une fois le rattachement du point de terminaison créé, il apparaît dans la liste Rattachement du point de terminaison.

         Si vous souhaitez établir une connexion publique à vos systèmes backend avec une sécurité supplémentaire, vous pouvez envisager de configurer des adresses IP sortantes statiques pour vos connexions, puis de configurer vos règles de pare-feu pour ajouter à la liste d'autorisation uniquement les adresses IP statiques spécifiques.

         Remarque : Ce connecteur n'accepte qu'une seule destination.
      2. Cliquez sur Suivant.
   4. Dans la section Authentification, saisissez les informations d'authentification.
      1. Sélectionnez un type d'authentification, puis saisissez les informations appropriées.

         Les types d'authentification suivants sont compatibles avec la connexion Solace :

         • Anonyme
         • Nom d'utilisateur et mot de passe

      Pour comprendre comment configurer ces types d'authentification, consultez la section Configurer l'authentification.

      2. Cliquez sur Suivant.
   5. Dans la section Détails de l'abonnement à l'événement, configurez les informations associées à l'événement.
      • Saisissez la configuration de la file d'attente de lettres mortes. Si vous configurez une lettre morte, la connexion écrit les événements non traités dans le sujet Pub/Sub spécifié. Saisissez les informations suivantes :
        1. ID du projet de lettre morte : ID du projet Google Cloud dans lequel vous avez configuré le sujet de lettre morte Pub/Sub.
        2. Sujet de lettre morte : sujet Pub/Sub dans lequel vous souhaitez écrire les détails de l'événement non traité.
   6. Vérifiez vos informations de connexion et d'authentification.
   7. Cliquez sur Créer.

   Sortie du déclencheur

   La configuration de l'abonnement à l'événement par le déclencheur de la source prend quelques minutes. Vous pouvez consulter l'état de votre abonnement à l'événement dans le volet de configuration du déclencheur, sous Détails de l'abonnement aux événements.

   Le déclencheur de la source indique l'état d'un abonnement à un événement. Il présente les états suivants:

   • Creating : indique que le déclencheur s'abonne à l'abonnement aux événements.
   • Active : indique que le déclencheur est correctement abonné à un abonnement d'événement.
   • Error: indique un problème avec l'abonnement à l'événement configuré.

   En plus de l'état de l'abonnement à l'événement, la section Détails de l'abonnement aux événements affiche d'autres informations telles que la région de la connexion, le nom de la connexion et le nom de l'abonnement à l'événement.

   Variable de sortie du déclencheur

   Pour chaque événement, le déclencheur Solace génère une variable de sortie ConnectorEventPayload (au format JSON) que vous pouvez utiliser dans vos tâches en aval. Le résultat aura la charge utile de votre événement Solace. Exemple :

   {
   "message": "Hello world",
   "messageContentType": "Text"
   }

   Afficher les abonnements à des événements

   Pour afficher et gérer tous les abonnements aux événements associés à une connexion dans Integration Connectors, procédez comme suit:

   1. Accédez à Integration Connectors > Connexions.

      Accéder à la page "Connexions"

   2. Cliquez sur la connexion pour laquelle vous souhaitez afficher les abonnements.
   3. Cliquez sur l'onglet Abonnements aux événements.

      Tous les abonnements aux événements de la connexion s'affichent.

   Modifier le déclencheur Solace

   Vous pouvez modifier un déclencheur Solace pour modifier ou mettre à jour la configuration de la connexion et les informations d'abonnement aux événements.

   Important:Lorsque vous modifiez un déclencheur Solace, vous pouvez conserver l'abonnement à l'événement précédemment configuré qui lui est associé, ou le supprimer. La suppression d'un abonnement à un événement aura une incidence sur toutes les intégrations publiées utilisant cet abonnement.

   Pour modifier un déclencheur Solace, procédez comme suit :

   1. Cliquez sur l'élément Déclencheur Solace dans l'éditeur d'intégrations pour ouvrir le volet de configuration du déclencheur.
   2. Cliquez sur Configurer le déclencheur Solace.
   3. Sur la page Éditeur du déclencheur d'événement du connecteur, procédez comme suit :
      1. Pour conserver l'abonnement à l'événement configuré précédemment, cliquez sur Conserver, sinon cliquez sur Supprimer.
         Avertissement : La suppression d'un abonnement à des événements affectera toutes les intégrations publiées qui l'utilisent. Cette tâche est irréversible.
      2. Mettez à jour la configuration de la connexion et les détails de l'abonnement aux événements si nécessaire.
      3. Cliquez sur OK.

   Vous pouvez afficher les détails mis à jour de la connexion et de l'abonnement aux événements dans le volet de configuration du déclencheur, sous Détails de l'abonnement aux événements.

   Quotas et limites

   Pour plus d'informations sur les quotas et les limites, consultez la section Quotas et limites.

   Étape suivante

   • En savoir plus sur l'ensemble des tâches et des déclencheurs
   • Découvrez comment tester et publier une intégration.
   • En savoir plus sur la gestion des erreurs
   • En savoir plus sur les journaux d'exécution de l'intégration