Envole

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

L’infrastructure de compilation EOLE utilise les étiquettes release/* pour connaître la version amont et en dériver la verion du paquet.

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

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

Compiler un paquet Envole¶

Lorsque vous modifier l’empaquetage, il est nécessaire de compiler en premier sur un environnement de compilation personnel.

Vous pouvez avoir une machine virtuelle à disposition

Compiler un paquet expérimental¶

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

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

NOTE : Le dernier argument dist/envole/4/master est la référence GIT, c’est à dire un identifiant de commit (le SHA1),
un nom d’étiquette ou de branche

ASTUCE : le complètement automatique Bash et l’outil git-package permet de ne spécifier que le minimum nécessaire afin de trouver la branche d’empaquetage

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

ou

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

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 git-package :

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

Tester un paquet Envole sur un serveur¶

Tester un paquet expérimental¶

ATTENTION : Disponible sur un serveur EOLE à partir de la version 2.4.1 avec le paquet 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.

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)
  

  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
  

• Configurer les dépôts standards et prendre en compte le dépôt expérimental
  

  root@scribe:~# Query-Auto -V test-eole.ac-dijon.fr
  

Déterminer la version du paquet compilé¶

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

Installer le paquet experimental¶

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

Tester un paquet de développement¶

C'est comme d'habitude

root@scribe:~# Query-Auto -D -V test-eole.ac-dijon.fr
root@scribe:~# apt-eole install eole-wordpress wordpress-apps

Adaptation de l’empaquetage¶

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