# [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
1. 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
1. Utiliser GitKraken pour tester localement la configuration
1. 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