Nœud Envoi Google Pub/Sub
Le nœud Envoi Google Pub/Sub publie un message sur un topic Google Cloud Pub/Sub. Il s'agit du pendant côté émission du déclencheur Événement Google Pub/Sub, qui consomme les messages via une souscription. Il sert à découpler les systèmes via le bus d'événements Google, à notifier d'autres services ou flux branchés sur le même topic et à s'intégrer à l'écosystème Google Cloud (Cloud Functions, Dataflow, BigQuery, etc.).
Paramètres
| Paramètre | Type | Obligatoire | Défaut | Description |
|---|---|---|---|---|
| App | App | ❌ | — | Application associée au nœud. Voir Apps. |
| Identifiant du projet (Project ID) | String | ✅ | — | Identifiant du projet Google Cloud cible. |
| Topic | String | ✅ | — | Topic Pub/Sub sur lequel publier le message. |
| Méthode d'authentification GCP | Méthode d'authentification | ✅ | — | Méthode Ecosystem utilisée pour publier sur Pub/Sub. |
| Corps du message (Message body) | JSON | ✅ | — | Données du message à publier (JSON recommandé). |
| Attributs du message | Clé-valeur | ❌ | — | Paires clé-valeur utiles pour le routage ou les métadonnées. |
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
Voir aussi : Utiliser les méthodes d'authentification dans les flux.
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.
Entrée
Le nœud reçoit les données du contexte du flux (déclencheur ou nœuds précédents) et les injecte dans le corps du message via les variables Handlebars :
{
"event": "order.created",
"orderId": "{{context.order.id}}",
"amount": "{{context.order.amount}}",
"customerId": "{{context.order.customerId}}"
}
Sortie
Le nœud Envoi Google Pub/Sub ne génère aucune variable de contexte : il publie le message puis le flux continue. Le message publié est ensuite consommé par le déclencheur Événement Google Pub/Sub ou tout autre abonné du topic.
Erreurs
Aucune condition d'échec spécifique n'est documentée pour ce nœud. En cas d'échec d'exécution, ajoutez un nœud On Error au flux pour gérer proprement l'erreur.
Limites
- Taille maximale du message : jusqu'à 10 Mo (limites Pub/Sub).
Exemple
Publier un événement après une commande : après un traitement métier, remplissez les champs du nœud :
- Project ID :
my-gcp-project - Topic :
orders-events - Corps du message :
{
"event": "order.created",
"orderId": "{{context.order.id}}",
"amount": "{{context.order.amount}}",
"customerId": "{{context.order.customerId}}"
}
Le corps du message est saisi dans le champ Corps du message, pas dans une configuration séparée — il accepte les variables Handlebars du contexte.