Versions
Cette page décrit la procédure exacte que nous suivons pour publier Axelix.
Il existe deux types de versions, qui suivent le même principe : toutes deux publient l’ensemble des composants en même temps, sous une seule version :
- Une version mineure est créée à partir de
masteret ouvre une nouvelle ligneX.Y. - Une version corrective est créée à partir de la branche de correctifs de cette ligne (
X.Y.x) et fait passer l’ensemble des composants àX.Y.Z.
Bien entendu, il y aura également des versions majeures. Nous documenterons aussi leur procédure de publication le moment venu.
Pour connaître l’organisation des branches sous-jacente, consultez Modèle de branches.
Versions mineures
Une version mineure publie tous les composants ensemble sous une seule version X.Y.0 et la marque avec un tag
vX.Y.0 sur master (voir
une version pour chaque composant). Voici la
procédure, dans l’ordre :
1. Tâches préparatoires
Les tâches préparatoires sont l’ensemble des modifications manuelles effectuées avant la publication. Elles sont
toutes regroupées dans un seul commit sur master, afin que l’ensemble de la publication puisse être annulé ou
récupéré proprement par cherry-pick si nous devons la reporter.
- Définir la version de l’ensemble des composants. Entre deux publications,
axelixVersiondans le fichiergradle.propertiesracine contient la prochaine version avec le suffixe-SNAPSHOT, par exemple3.1.0-SNAPSHOTpendant le développement de3.1.0. Les tâches préparatoires suppriment ce suffixe pour définir la version exacte à publier : pour3.1.0, la valeur devient3.1.0. C’est cette valeur que lit le pipeline de publication et qui donne son nom au tag résultant ; le pipeline refuse de publier une version-SNAPSHOT. Legradle.propertiesracine est le seul endroit où la version est définie : tous les composants en héritent. - Mettre à jour les playgrounds. Les applications d’exemple situées sous
playgrounds/sont, par conception, des projets distincts : elles n’héritent pas d’axelixVersionet épinglent explicitement les versions du starter et du plugin Axelix qu’elles utilisent. Mettez à jour ces versions épinglées vers la version en cours de publication. - Mettre à jour la documentation. La documentation n’est versionnée que par ligne majeure. Par exemple, pendant le développement d’une version mineure, nous ajoutons des notices « version à venir » pour les fonctionnalités qu’elle fournira ; lors de la création de la version mineure qui les publie effectivement, ces notices sont remplacées par les notices « publiée dans » correspondantes.
2. Lancer le pipeline de publication
Nous ne créons pas le tag à la main. Le pipeline lit la version dans gradle.properties et exécute les
vérifications préalables. Il publie ensuite les artefacts Maven (starters et plugins), construit et pousse l’image
Docker de Master, puis crée et signe le paquet du chart Helm. Ce n’est qu’ensuite qu’il crée et pousse le tag vX.Y.0,
avant de mettre à jour le dépôt de charts Helm. Des artefacts peuvent donc déjà être publiés si le pipeline échoue
avant la création du tag.
Les notes de version sont rédigées manuellement
Le pipeline crée le tag, mais ne rédige pas les notes de version. La rédaction des notes pour le tag vX.Y.0
qui vient d’être créé incombe au développeur chargé de la publication, qui les écrit manuellement pour ce tag.
Versions correctives
Une version corrective, comme toute version d’Axelix, publie l’ensemble des composants sous une seule version : il
n’existe pas de correctifs par composant. La procédure reprend celle d’une version mineure, avec une différence
structurelle : elle est créée à partir de la branche de correctifs de la ligne mineure, et non de master. L’étape
relative à la documentation est ignorée, car les versions correctives ne modifient pas la documentation.
-
Extraire la branche de correctifs. Les travaux de correctifs résident sur l’unique branche de la ligne, nommée
X.Y.x. Lexlittéral indique qu’il s’agit de toute la ligne de correctifs et, contrairement à un tag, le nom de la branche ne comporte pas de préfixev. Elle est créée à partir du tagvX.Y.0de la version mineure (voir Modèle de branches → Où se trouvent les travaux de correctifs). Créez-la à partir du tag s’il s’agit du premier correctif de la ligne ; sinon, elle existe déjà. -
Intégrer les correctifs à cette branche. Un correctif est généralement intégré d’abord à
master, puis rétroporté vers la branche de correctifs ; seuls les éléments effectivement corrigés par la version changent. -
Effectuer les tâches préparatoires sur la branche (un seul commit).
- Définir la version de l’ensemble des composants. Dans le
gradle.propertiesracine, définissezaxelixVersionsur la nouvelle version correctiveX.Y.Z. Contrairement àmaster, la branche de correctifs ne comporte pas de suffixe-SNAPSHOTentre deux publications : elle conserve simplement la dernière version publiée de sa ligne jusqu’à ce que le prochain correctif la mette à jour. - Mettre à jour le ou les playgrounds. Mettez à jour les applications playgrounds vers la nouvelle version
corrective, pour la même raison que pour une version mineure : elles épinglent explicitement leurs versions Axelix
et n’héritent pas d’
axelixVersion.
- Définir la version de l’ensemble des composants. Dans le
-
Lancer le pipeline de publication. C’est le même pipeline que pour une version mineure, lancé depuis la branche corrective plutôt que depuis
master. Il suit le même ordre de vérifications, de publication, de création du paquet et de création du tag décrit ci-dessus, avec la versionX.Y.Zet le tagvX.Y.Z. Comme tous les tags Axelix, celui-ci porte le préfixev. Le pipeline crée le tag, mais pas les notes de version ; le développeur les rédige manuellement pour le nouveau tag.
Exemple concret
Supposons que la version 3.1.0 nécessite un correctif dans Axelix Spring Boot 3 Starter :
- Le correctif réside sur la branche
3.1.x, créée à partir du tagv3.1.0. Si la ligne3.1a déjà reçu un correctif, cette branche existe déjà ; sinon, nous la créons à partir dev3.1.0. - Nous rétroportons le correctif de
mastervers cette branche. - Dans le
gradle.propertiesracine, nous définissonsaxelixVersionsur3.1.1, la version corrective à publier, et mettons à jour les playgrounds vers3.1.1. - Nous lançons le pipeline depuis la branche
3.1.x. Il publie les artefacts Maven et l’image de Master sous3.1.1, crée le paquet du chart Helm, puis crée et pousse le tag communv3.1.1. Il met ensuite à jour le dépôt de charts. Chaque composant reçoit la version3.1.1, même si un seul starter a réellement changé.
Le résultat correspond à ce que promet
une version pour chaque composant : après la
publication, 3.1.1 existe pour l’ensemble des composants. À vous de décider si vous mettez à niveau tous les
composants déployés en même temps ou uniquement celui qui a effectivement été corrigé :
la compatibilité est garantie par major.minor,
de sorte qu’un écart de version corrective entre les composants déployés est toujours sans risque.