Aller au contenu principal

Nœud Send PubSubEvent

Le nœud Send PubSubEvent publie un message sur un topic Google Cloud Pub/Sub. Il s’agit du pendant côté émission du trigger Google Pub/Sub, qui consomme les messages via une souscription.

Vue d'ensemble​

Ce nœud est utilisé pour :

  • Publier des messages sur un topic Pub/Sub (GCP)
  • Découpler les systèmes via le bus d’événements Google
  • Notifier d’autres services ou workflows branchés sur le même topic
  • S’intégrer à l’écosystème Google Cloud (Cloud Functions, Dataflow, BigQuery, etc.)

Configuration​

Identifiant du projet (Project ID)​

Projet Google Cloud auquel appartient le topic (ex. : my-project-12345).

Topic​

Topic Pub/Sub cible :

  • Nom du topic ou chemin complet selon l’interface Ecosystem (ex. : projects/<project-id>/topics/<topic-name>)
  • Supporte les variables Handlebars

Méthode d'authentification GCP​

Sélectionnez la méthode d’authentification Google Cloud utilisée pour publier :

  • Compte de service avec droits Pub/Sub Publisher (ou rôle équivalent) sur le topic
  • Utilisez une méthode d’authentification Ecosystem (type GCP / Google) pour stocker les identifiants de façon sécurisée
Sécurité

Ne stockez pas les clés de compte de service ou les secrets GCP en clair dans la configuration. Utilisez toujours une méthode d’authentification Ecosystem.

Corps du message (Message body)​

Contenu publié sur le topic :

  • Format JSON recommandé
  • Supporte les variables Handlebars
  • Taille maximale conforme aux limites Pub/Sub (jusqu’à 10 Mo pour le message)

Attributs du message (optionnel)​

Attributs de message Pub/Sub (paires clé–valeur) pour le routage ou les métadonnées côté abonnés.

Exemples​

Exemple 1 : Publication après une commande​

{
  "projectId": "my-gcp-project",
  "topic": "orders-events",
  "body": {
    "event": "order.created",
    "orderId": "{{order.id}}",
    "amount": "{{order.amount}}",
    "customerId": "{{order.customerId}}"
  }
}

Bonnes pratiques​

  • Droits IAM : le compte de service doit pouvoir publier sur le topic concerné
  • Cohérence : alignez le schéma des messages avec ce que consomment vos abonnements et le trigger Google Pub/Sub
  • Idempotence : côté consommateur, prévoyez les doublons possibles (reprise, retry)
  • Documentation : documentez les topics et le format des messages émis

Prochaines étapes​