GitPackaging » Historique » Version 43
« Précédent -
Version 43/45
(diff) -
Suivant » -
Version actuelle
Daniel Dehennin, 11/07/2012 08:59
Lien vers le projet git-package
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 branchedist/<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 version2.2
d’EOLE.
- Je code dans une branche personnelle, par exemple
dad/mise-au-propre-du-makefile
- Je teste, cela va de soi ;-)
- Je publie dans la branche publique
- 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
make
: pour compiler ce qui est compilablemake install
: pour installer les fichiers et faire les testsmake 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 :
- Le code dit « upstream »
- 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.
- On récupère un projet :
buildd@build:~/src/$ git clone http://dev-eole.ac-dijon.fr/git/eole-debsums && cd eole-debsums
- On créé une branche de packaging :
buildd@build:~/src/eole-debsums(master)$ git checkout -b dist/ubuntu/lucid/master
- 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
- On ajoute ce packaging au stagging area
buildd@build:~/src/eole-debsums(dist/ubuntu/lucid/master)$ git add debian
- 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
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 Luciddebian/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
- On commence par une introduction au packaging
- La politique Debian est la référence sur les obligations que doivent suivre les paquets Debian
- 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
Mise à jour du packaging¶
La mise à jour du packaging ne requiert pas grand chose par rapport à la création d’un nouveau paquet:- On se place dans la branche de packaging voulu
- On modifie les fichiers dans le répertoire
debian/
en fonction des besoins - On publie ces modifications
- 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:
- On passe sur la branche de packaging :
buildd@build:~/src/eole-debsums(master)$ git checkout dist/ubuntu/lucid/master
- On intègre les modifications faites par les autres (et eolepack) :
buildd@build:~/src/eole-debsums(dist/ubuntu/lucid/master)$ git pull
- On intègre nos modifications :
buildd@build:~/src/eole-debsums(dist/ubuntu/lucid/master)$ git merge master
- On envoi sur le dépôt central pour eolepack :
buildd@build:~/src/eole-debsums(dist/ubuntu/lucid/master)$ git push
- 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
- 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.
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 :
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