Envole

h2. h1. Préparer l’étiquette de version amont (« upstream » en anglais)

L’infrastructure de compilation EOLE utilise les "étiquettes":http://git-scm.com/book/fr/Les-bases-de-Git-Étiquetage *@release/*@* pour connaître la version _amont_ et en dériver la verion du paquet.

Nous prenons l’exemple du paquet project:wordpress mais la procédure est identique pour tous les paquets Envole :

<pre>
user@work:~src/wordpress (dist/envole/4/master=)$ git checkout master
user@work:~src/wordpress (master=)$ git tag -m "New Envole release 4.0" release/*<mettre la version réelle de l'application>* master
</pre>

h2. h1. Compiler un paquet Envole

Lorsque vous modifier l’empaquetage, il est nécessaire de compiler en premier sur un [[eole:GitPackagingSbuildLVM|environnement de compilation personnel]].

Vous pouvez avoir une machine virtuelle à disposition

h3. h2. Compiler un paquet expérimental

Si vous avez configuré project:git-package comme [[#Paramétrage-de-git-package|indiqué plus haut]], vous pouvez vous passer de l’option *@-d|--distrib@* pour compiler un paquet pour la distribution
*@envole-2.4-experimental@* :

<pre>
user@work:~src/wordpress (master=)$ git package --build dist/envole/4/master
</pre>

*@NOTE@* : Le dernier argument *@dist/envole/4/master@* est la "référence GIT":http://git-scm.com/book/fr/v1/Les-tripes-de-Git-R%C3%A9f%C3%A9rences-Git, c’est à dire un identifiant de commit (le SHA1),
un nom d’"étiquette":http://git-scm.com/book/fr/Les-bases-de-Git-Étiquetage ou de branche

*@ASTUCE@* : le "complètement automatique Bash":https://fr.wikipedia.org/wiki/Compl%C3%A8tement_automatique#Interpr.C3.A9teurs_de_commandes et l’outil project:git-package permet de ne spécifier que le minimum nécessaire afin de trouver la branche d’empaquetage
<pre>
user@work:~src/wordpress (master=)$ git package --build envole/4<TABULATION>
</pre>

ou

<pre>
user@work:~src/wordpress (master=)$ git package --build envole/4<ENTER>
</pre>

h3. h2. Compiler un paquet de développement

Il s’agit de la même procédure mais en spécifiant la distribution *@envole-4/unstable@* par l’option *@-d|--distrib@* de project:git-package :

<pre>
user@work:~src/wordpress (master=)$ git package --build --distrib envole-4/unstable envole/4
</pre>

h2. h1. Tester un paquet Envole sur un serveur

h3. h2. Tester un paquet expérimental

*@ATTENTION@* : Disponible sur un serveur EOLE à partir de la version 2.4.1 avec le paquet project:eole-web

Aucun paquet de la distribution *@envole-4-experimental@* ne s’installe automatiquement lors des mises à jour.

Il faut installer manuellement les paquets en spécifiant le numéro de version exacte que l’on souhaite utiliser.

h4. h3. Configurer les dépôts de paquets

* Ajouter manuellement le dépôt Envole expérimental (il n’est pas configurable par _Query-Auto_ ou _Maj-Auto_ car il n’est utile que pour les développeurs)
<pre>
root@scribe:~# cat >| /etc/apt/sources.list.d/envole-4-experimental.list <<EOF
deb http://test-eole.ac-dijon.fr/envole envole-4-experimental main
EOF
</pre>
* Configurer les dépôts standards et prendre en compte le dépôt expérimental
<pre>
root@scribe:~# Query-Auto -V test-eole.ac-dijon.fr
</pre>

h4. h3. Déterminer la version du paquet compilé

<pre>
root@scribe:~# apt-cache policy eole-wordpress
apt:
Installé : 3.9.2-eole2~5.gbpb66498
Candidat : 3.9.2-eole2~5.gbpb66498
Table de version :
4.0-1~1.gbpcc1457 0
90 http://eole.ac-dijon.fr/envole envole-4-experimental/main amd64 Packages
3.9.2-eole2~5.gbpb66498 0
500 http://eoleng.ac-dijon.fr/eole eole-2.3-dev/main amd64 Packages
*** 3.9.2-eole2~5.gbpb66498 0
100 /var/lib/dpkg/status
</pre>

h4. h3. Installer le paquet experimental

<pre>
root@scribe:~# apt-get install eole-worpress=4.0-1~1.gbpcc1457 wordpress-apps=4.0-1~1.gbpcc1457
</pre>

h3. h2. Tester un paquet de développement

C'est comme d'habitude
<pre>
root@scribe:~# Query-Auto -D -V test-eole.ac-dijon.fr
root@scribe:~# apt-eole install eole-wordpress wordpress-apps
</pre>

h2. h1. Adaptation de l’empaquetage

Suivre les recommandations du wiki suivant
https://dev-eole.ac-dijon.fr/projects/envole/wiki/MigrationAppliEnvole4