[Procédure] Applications Vitis - Publier version

On peut facilement publier une version en 4 étapes à l’aide d’outils automatisés, on distinguera deux types de versions, les versions mineures correspondant à des corrections de bugs qui seront taguées en changeant uniquement le dernier nombre (ex: 2018.01.xx), les versions majeures correspondent à des évolutions apportées au produit, elles seront taguées en changeant le nombre du milieu (ex: 2018.xx.00).

1. Versionner les modules impactés

La première chose à faire c’est de versionner les modules modifiés, pour cela on va aller sur la branche impactée pour créer une branche qui portera comme nom le nom pre-2018.xx.xx.

Dans notre exemple on veut créer une version mineure, la version en cours est la 2018.03.01 on créera donc une branche pre-2018.03.02

La deuxième chose à faire c’est de versionner l’application, pour cela on créera une branche portant le nom de la version à générer, puis on modifiera le fichier conf/_install/dependency.xml pour utiliser les branches de pre-production et enfin on utilisera GitKraken pour rapatrier les nouvelles branches sur l’application.

../../_images/publier_version_1.jpg

2. Générer une version pre-prod et effectuer les tests

Maintenant que la structure est versionnée il faudra générer un setup et effectuer les tests, pour cela il suffit de ce rendre sur http://jenkins.veremes.net/ et lancer un job de type Generate un and test app. Ce dernier va générer un setup, le poser sur S3, démarrer une machine AWS, installer la version dessus et lancer les tests API-REST.

Pour lancer le job il faudra saisir les paramètres suivants:

  • APP_NAME : nom de l’application à générer
  • OS : le ou les OS sur lesquels installer
  • VERSION : numéro de version à générer
  • RUN TEST : cocher la case pour lancer les tests API-REST (en cours de développement)

../../_images/publier_version_2.jpg

Une fois le job terminé vous pouvez récupérer l’url de l’application générée en cliquant sur l’étape “Run app on …” puis aller tester manuellement l’application.

../../_images/publier_version_3.jpg

Il est important d’effectuer également des tests en mise à jour, aucun job n’a été développé pour l’instant donc il faudra effectuer le test manuellement.

3. Créer les tags associés

Une fois que les tests sont concluants on pourra créer les tags associés pour ceci il faudra sur chacune des branches modifiées appliquer la procédure suivante :

  1. Faire un merge vers master
  2. Créer un tag à partir de la branche pre-prod

Pour l’application la procédure est légèrement différente :

  1. Modifier dependency.xml pour utiliser les tags créés précédemment
  2. Utiliser GitKraken pour tester localement la configuration
  3. Créer un tag à partir de la branche pre-prod

4. Générer une version de production

La dernière étape consiste à rejouer l’étape 2.2 puis récupérer le setup généré sur https://s3.console.aws.amazon.com/s3/buckets/veremes-dev-ressources/builds/

Une fois que tout est ok, on peut supprimer les branches de pré-production