Envole

h2. 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. 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. 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. 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. Tester un paquet Envole sur un serveur

h3. 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. 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. 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. 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. 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. Adaptation de l’empaquetage

Suivre les recommandations du wiki suivant

https://dev-eole.ac-dijon.fr/projects/envole/wiki/MigrationAppliEnvole4