• Séparation du code et du packaging
  • Le développement dans master
  • Le packaging dans dist/<VENDOR>/<DISTRIBUTION>/master
    • La première fois, c’est toujours la plus difficile
    • Mise à jour du packaging
    • Nouveau paquet, sans modification du packaging
      • Aide à la console (aka helper bash)
• Environnement de compilation personnel
• Webographie

Séparation du code et du packaging¶

Cela facilite le travail de tout le monde, aussi bien des développeurs que des packageurs.

De plus, il est ainsi plus facile de fournir le même code pour plusieurs distributions différentes, cela sera utile notamment lors du portage des applications sur Precise Pangolin

Le principe de base est le suivant :

• Tout ce qui est du ressort du packaging, c’est à dire tous les fichiers présents dans le répertoire debian/ pour les paquets deb, sont et doivent être modifiés dans la branche dist/<VENDOR>/<DISTRIBUTION>/master
• Tout le reste, c’est à dire le code, par exemple les dictionnaires, templates, scripts, agents zéphir, sont dans la branche publique adéquat, c’est a dire master pour le code en développement, 2.2 pour le code spécifique à la version 2.2 d’EOLE.

Le workflow de base est le suivant:

1. Je code dans une branche personnelle, par exemple dad/mise-au-propre-du-makefile
2. Je teste, cela va de soi ;-)
3. Je publie dans la branche publique
4. J’intègre ces modifications à la branche de packaging afin de compiler un nouveau paquet

Le développement dans master¶

Les développeurs gèrent cette branche comme bon leur semble, ils ne seront pas gênés par le packaging, en particulier les changements sur debian/changelog à chaque compilation de paquet.

Les règles habituellement admises dans le monde du logiciel libre sur l’installation sont conseillées, par exemple :

• Écrire un Makefile utilisant la variable $(DEST) pour désigner la racine d’installation
• Utiliser les autotools pour permettre la configuration des différents répertoires d’installation

L’idéal, en tant que développeur, peut être de pouvoir cloner la branche master sur une machine de test et de lancer les commandes :

1. make : pour compiler ce qui est compilable
2. make install : pour installer les fichiers et faire les tests
3. make uninstall : pour nettoyer ce qui a été installé

La branche master étant la branche publique des derniers développements, il est utile d’étiqueter des états techniques utilisables et/ou à tester.

Le packaging dans dist/<VENDOR>/<DISTRIBUTION>/master¶

Le packaging se compose de deux parties :

1. Le code dit « upstream »
2. Le code permettant de « faire le paquet », c’est à dire le contenu du répertoire debian/ pour les paquets deb.

La première fois, c’est toujours la plus difficile¶

Un outil est disponible pour préparer le packaging d’un logiciel: dh-make, son utilisation est plutôt simple.

1. On récupère un projet :
   

   buildd@build:~/src/$ git clone http://dev-eole.ac-dijon.fr/git/eole-debsums && cd eole-debsums
   

2. On créé une branche de packaging :
   

   buildd@build:~/src/eole-debsums(master)$ git checkout -b dist/ubuntu/lucid/master
   

3. On créer un packaging de base :
   

   buildd@build:~/src/eole-debsums(dist/ubuntu/lucid/master)$ dh_make -c <LICENCE> -p eole-debsums_<VERSION> --createorig
   [...] # Répondre aux questions
   

4. On ajoute ce packaging au stagging area
   

   buildd@build:~/src/eole-debsums(dist/ubuntu/lucid/master)$ git add debian
   

5. On commit ce premier packaging, cela fait un point de départ même s’il n’est pas utilisable
   

   buildd@build:~/src/eole-debsums(dist/ubuntu/lucid/master)$ git commit -m "Debianisation du projet par dh_make" # Ne pas utiliser -m et faire un vrai message de log
   

À partir de là il faut éditer les fichiers présents dans le répertoire debian/, principalement :

• debian/control :
  • Faire attention au mainteneur ;
  • Faire attention à l’architecture cible : "any" pour des binaires (i386/amd64), "all" pour les paquets indépendant de l’architecture matérielle (documentation, scripts perl, …)
  • Faire attention à la version de la Debian policy utilisée, 3.8.2 sur Lucid ;
  • Faire attention à la version de debhelper, >= 7.4 sur Lucid ;
  • Mettre une description, courte et longue, les métas paquets doivent utiliser une des expressions "metapackage," "dummy," "dependency package," "empty package," ou "virtual package" dans la description longue
• debian/compat : utiliser 7 pour Lucid
• debian/copyright.

Supprimer l’extention .ex ou .EX des fichiers qui seront utiles et les modifier.

Des informations sur le packaging sont disponibles dans la documentation Debian

1. On commence par une introduction au packaging
2. La politique Debian est la référence sur les obligations que doivent suivre les paquets Debian
3. Un chapitre sur les meilleurs pratiques de packaging est disponible dans la Référence du développeur Debian

Nous fournissons aussi un petit recueil de packaging EOLE 2.3 et EOLE 2.4

Mise à jour du packaging¶

La mise à jour du packaging ne requiert pas grand chose par rapport à la création d’un nouveau paquet:

1. On se place dans la branche de packaging voulu
2. On modifie les fichiers dans le répertoire debian/ en fonction des besoins
3. On publie ces modifications
4. On compile un paquet, ou pas

Nouveau paquet, sans modification du packaging¶

Afin de faire un paquet, il faut intégrer la branche de développement souhaitée, par exemple:

1. On passe sur la branche de packaging :
   

   buildd@build:~/src/eole-debsums(master)$ git checkout dist/ubuntu/lucid/master

2. On intègre les modifications faites par les autres (et eolepack) :
   

   buildd@build:~/src/eole-debsums(dist/ubuntu/lucid/master)$ git pull

3. On intègre nos modifications :
   

   buildd@build:~/src/eole-debsums(dist/ubuntu/lucid/master)$ git merge master

4. On envoi sur le dépôt central pour eolepack :
   

   buildd@build:~/src/eole-debsums(dist/ubuntu/lucid/master)$ git push

5. On se replace sur la branche de développement pour nos futures modifications
   

   buildd@build:~/src/eole-debsums(dist/ubuntu/lucid/master)$ git checkout master

6. On compile un nouveau paquet, ou pas

NB: La branche par défaut dans eolepack est modifiée pour être dist/ubuntu/lucid/master.

Aide à la console (aka helper bash)¶

Un petit script bash (git-package) peut-être utilisé afin d’automatiser la procédure, sa procédure d’installation est assez simple et support le complètement automatique pour Bash :

buildd@build:~/src/eole-debsums(master)$ git package lucid
Do you want to merge 'master' into 'dist/ubuntu/lucid/master'?: y
Checkout 'lucid' master distribution branch 'dist/ubuntu/lucid/master': Switched to branch 'dist/ubuntu/lucid/master'
Pull from default remote: Already up-to-date.
Merge developpement from 'master': Already up-to-date.
Switch back to your developpement branch 'master'... Switched to branch 'master'
Push is not automatically done to avoid publishing possible errors.
buildd@build:~/src/eole-debsums(master)$ 

Et comme c’est connu que les informaticiens sont fainéants (enfin seulement les bons ;-)), il est possible de saisir encore moins de caractères en se faisant un alias dans git (pas nécessaire de le faire dans le shell):

buildd@build:~/src/eole-debsums(master)$ git config --global alias.lucid 'package lucid'

Ensuite, il n’y a plus qu’a l’utiliser:

buildd@build:~/src/eole-debsums(master)$ git lucid
Do you want to merge 'master' into 'dist/ubuntu/lucid/master'?: y
Checkout 'lucid' master distribution branch 'dist/ubuntu/lucid/master': Switched to branch 'dist/ubuntu/lucid/master'
Pull from default remote: Already up-to-date.
Merge developpement from 'master': Already up-to-date.
Switch back to your developpement branch 'master'... Switched to branch 'master'
Push is not automatically done to avoid publishing possible errors.
buildd@build:~/src/eole-debsums(master)$ 

Si plus d’une branche contiennent le nom lucid, alors vous devez spécifier un nom plus long, par exemple:

buildd@build:~/src/eole-debsums(master)$ git lucid
Error: More than one branch match 'lucid':
  dist/ubuntu/lucid/master
  dist/ubuntu/lucid/test

You should try adding a discriminent part.
For example: git package lucid/master

Vous devez spécifier le discriminant que vous souhaitez:

buildd@build:~/src/eole-debsums(master)$ git lucid/test
Do you want to merge 'master' into 'dist/ubuntu/lucid/test'?: y
Checkout 'lucid/test' master distribution branch 'dist/ubuntu/lucid/test': Switched to branch 'dist/ubuntu/lucid/test'
Pull from default remote: Already up-to-date.
Merge developpement from 'master': Already up-to-date.
Switch back to your developpement branch 'master'... Switched to branch 'master'
Push is not automatically done to avoid publishing possible errors.

Vous pouvez spécifier à git que vous souhaitez avoir des couleurs à l’affichage lorsque cela est possible en le configurant de la sorte:

buildd@build:~/$ git config --global color.interactive auto

Environnement de compilation personnel¶

Il existe plusieurs outils afin de mettre en place des environnements de compilation personnels.

L’outil utilisé dans le projet Debian se nomme sbuild, la procédure utilise la version 0.63.2-1 disponible sur Wheezy.

Ce système peut se reposer sur un système de snapshot : on installe un système de base, propre, et la compilation se fait dans un snapshot temporaire de ce système.

Cela permet de lancer des compilations en parallèles au besoin.

Deux méthodes sont utilisables pour la mise en place des schroots avec snapshots :

• avec LVM
• avec le système de fichier btrfs

Lorsque les schroots sont en place et sbuild configuré par l’une des méthodes ci-dessus, la compilation d’un paquet peut se dérouler comme suit :

buildd@build:~/src$ sudo apt-get install git-core git-buildpackage fakeroot build-essential debhelper cdbs
buildd@build:~/src$ git clone http://dev-eole.ac-dijon.fr/git/eole-debsums
buildd@build:~/src$ cd eole-debsums
buildd@build:~/src/eole-debsums$ git checkout -b dist/ubuntu/lucid/build origin/dist/ubuntu/lucid/master
buildd@build:~/src/eole-debsums$ git buildpackage --git-builder="sbuild -A -d eole-2.3-dev" --git-cleaner=/bin/true

Ou si on souhaite minimiser les paquets à installer:

buildd@build:~/src$ sudo apt-get install git-core git-buildpackage dpkg-dev
buildd@build:~/src$ git clone http://dev-eole.ac-dijon.fr/git/eole-debsums
buildd@build:~/src$ cd eole-debsums
buildd@build:~/src/eole-debsums$ git checkout -b dist/ubuntu/lucid/build origin/dist/ubuntu/lucid/master
buildd@build:~/src/eole-debsums$ git buildpackage --git-builder="dpkg-buildpackage -nc -d -S" --git-cleaner=/bin/true
buildd@build:~/src/eole-debsums$ sbuild -A -d eole-2.3-dev ../eole-debsums_20111207-eole1.dsc

La génération d'un paquet source peut nécessiter un peu de configuration git-buildpackage

Webographie¶

• La politique Debian
• Une introduction au packaging
• Les meilleurs pratiques de packaging
• La Référence du développeur Debian
• La documentation développeur Debian
• PackagingGuide/Python