Gestion des versions
Chaque flux vit dans deux mondes complémentaires : une version Principale, toujours vivante et idéale pour itérer vite, et des versions numérotées, figées dès qu'elles sont déployées, qui garantissent la reproductibilité. Comprendre cette distinction est la clé pour développer sans friction tout en livrant en toute sécurité.
Version Principale et versions numérotées : le bon réflexe
| Comparatif | Version Principale | Versions numérotées (ex. 1.2.0) |
|---|---|---|
| Rôle | Ligne de développement permanente | Snapshots nommés, traçables |
| Évolution | Toujours modifiable, même si déployée ailleurs | Après déploiement : plus aucune modification du graphe ni de la logique |
| Ajustements possibles | Tout peut changer | Uniquement le niveau de traçage (les autres paramètres restent figés) |
| Production | Non déployable en environnement de production | C’est le format adapté au déploiement en production |
En pratique : vous développez et testez sur Principale (boucle courte, changements immédiats) ; vous figez une version semver lorsque le comportement vous convient, puis vous déployez cette version vers la prod — pas Principale.
La version Principale : toujours en mouvement
Principale est la version en continu : elle reflète l’état courant du flux tel que vous l’éditez. Ce n’est pas un snapshot figé.
- Idéal pour développer : vous modifiez le flux, vous enregistrez, vous retestez — sans créer de version à chaque essai.
- Déployée ou non, elle reste éditable : même si Principale est déployée sur un environnement non productif (dev, recette, etc.), vous pouvez continuer à la modifier. Les prochaines exécutions prendront en compte ces changements : parfait pour tester instantanément une idée ou corriger un détail.
- Effet immédiat : pas de cycle « créer une version → redéployer » tant que vous restez sur des environnements où Principale est autorisée.
La version Principale ne peut pas être déployée en production. Pour tout environnement de production, vous devez passer par une version numérotée (fork semver), puis déployer celle-ci. C’est ce qui protège la prod contre des changements non contrôlés sur une ligne toujours mobile.
Les versions numérotées : semver et immuabilité
Lorsque vous créez une version (fork avec un numéro), vous produisez un identifiant stable (1.0.0, 1.1.0, etc.). Cette version porte son changelog et son historique.
Règle importante : dès qu’une version numérotée est déployée, elle devient immutable pour tout ce qui définit le comportement du flux (nœuds, connexions, logique métier, etc.). Vous ne pouvez plus « retoucher » cette version pour la faire évoluer : il faut créer une nouvelle version (nouveau numéro).
Seule exception : vous pouvez encore ajuster le niveau de traçage sur une version déjà déployée — utile pour diagnostiquer sans republier une release. Les modes disponibles (Complet, Standard, Performance) et la durée du mode Complet sont décrits dans Modes de traçage.
Format de version (SemVer)
Utilisez le Semantic Versioning pour que tout le monde comprenne l’impact d’une release :
- MAJOR : changements incompatibles (ex.
2.0.0) - MINOR : nouvelles fonctionnalités rétrocompatibles (ex.
1.1.0) - PATCH : corrections sans changement d’API fonctionnelle attendu (ex.
1.0.1)
Versions de pré-version (suffixes)
Un suffixe peut être ajouté pour marquer une version non stable, sous la forme MAJOR.MINOR.PATCH-<libellé>.<numéro> :
-
1.0.0-beta.0,1.1.0-beta.1,2.0.0-rc.1… -
Le libellé est libre (
beta,rc,alpha, …). -
Le numéro qui suit s’incrémente à chaque nouvelle version du même libellé (
beta.0→beta.1→beta.2).
Une version suffixée reste une version numérotée : dès qu’elle est déployée, elle est immuable (sauf niveau de traçage).
Créer une version (fork)
Ecosystem matérialise une nouvelle version numérotée par un fork du flux courant.
Depuis l’éditeur
- Travaillez sur votre flux (souvent à partir de la version Principale une fois le comportement stabilisé).
- Cliquez sur Fork (ou Bifurcation).
- Renseignez le formulaire :
| Champ | Obligatoire ? | Description |
|---|---|---|
| Version | Oui | Numéro SemVer (1.0.0, 1.1.0, 2.0.0, …) ; suffixe libre possible pour les pré-versions (1.0.0-beta.0). |
| Journal des modifications | Fortement recommandé | Résumé des changements livrés avec cette version (changelog à l’écran). |
- Validez avec Sauvegarder.
La nouvelle version apparaît dans l’historique ; vous pourrez la déployer sur l’environnement voulu (rappel : le déclencheur doit être déployé sur le même environnement).
Statuts d'une version
Trois libellés de statut reviennent dans l'interface :
| Statut | Signification |
|---|---|
| Brouillon | Le flux est en cours d'édition (version Principale non figée) — état par défaut après création. |
| Principale | La version de travail, toujours modifiable — voir La version Principale. |
| Déployé | La version est (ou a été) déployée sur au moins un environnement. Pour une version numérotée déployée, le contenu fonctionnel est gelé (sauf niveau de traçage). |
Gérer les versions dans l’interface
Liste des versions
- Ouvrez la fiche du flux.
- Allez dans l’onglet Versions.
- La liste affiche notamment : numéro, date de création, changelog, statut.
Consulter une version
- Onglet Versions.
- Cliquez sur la ligne de la version.
- Visualisez le graphe tel qu’il était pour cette release.
Comparer les versions
L’historique de versions permet de visualiser les changements entre deux versions :
- Onglet Versions.
- Sélectionnez deux versions à comparer (ou utilisez le mode comparaison).
- Les différences de graphe (nœuds ajoutés, modifiés, supprimés, connexions) sont mises en évidence.
Comprendre l’historique
Chaque ligne de l’historique de versions affiche le numéro de version, sa date de création, son journal des modifications (changelog saisi au fork) et son statut. Pour retrouver facilement une version :
- Repérez les versions déployées (associées à un environnement) — elles sont signalées dans la liste.
- Consultez le changelog d’une version pour savoir ce qu’elle contient sans ouvrir le graphe.
- Utilisez la comparaison de versions pour identifier précisément ce qui a changé entre deux livraisons.
Déployer une version
- Onglet Versions.
- Choisissez la version (en production, une version semver, pas Principale).
- Déployer → choix de l’environnement → confirmation.
Au moment du déploiement, l’interface propose de vérifier les variables de dictionnaire utilisées dans le flux (renseignées et correctes pour l’environnement cible).
Pour le détail des prérequis (déclencheur, environnements) et des variables de dictionnaire, voir Déployer un flux.