GitPackaging » Historique » Version 35
Daniel Dehennin, 22/02/2012 15:55
1 | 6 | Daniel Dehennin | {{toc}} |
---|---|---|---|
2 | 6 | Daniel Dehennin | |
3 | 26 | Daniel Dehennin | h1. Séparation du code et du packaging |
4 | 17 | Daniel Dehennin | |
5 | 17 | Daniel Dehennin | Cela facilite le travail de tout le monde, aussi bien des développeurs que des packageurs. |
6 | 1 | Daniel Dehennin | |
7 | 1 | Daniel Dehennin | 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":http://fr.wikipedia.org/wiki/Liste_des_versions_d%27Ubuntu#Ubuntu_12.04_LTS_.28Precise_Pangolin.29 |
8 | 17 | Daniel Dehennin | |
9 | 26 | Daniel Dehennin | Le principe de base est le suivant : |
10 | 26 | Daniel Dehennin | * 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":http://fr.wikipedia.org/wiki/Deb, sont et doivent être modifiés dans la branche @dist/<VENDOR>/<DISTRIBUTION>/master@ |
11 | 26 | Daniel Dehennin | * 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. |
12 | 1 | Daniel Dehennin | |
13 | 26 | Daniel Dehennin | Le workflow de base est le suivant: |
14 | 26 | Daniel Dehennin | # Je code dans une branche personnelle, par exemple @dad/mise-au-propre-du-makefile@ |
15 | 26 | Daniel Dehennin | # Je teste, cela va de soi ;-) |
16 | 26 | Daniel Dehennin | # Je [[GitBonnesPratiques#Publication-du-développement|publie dans la branche publique]] |
17 | 26 | Daniel Dehennin | # J’intègre ces modifications à la branche de packaging afin de compiler un nouveau paquet |
18 | 1 | Daniel Dehennin | |
19 | 26 | Daniel Dehennin | h2. Le développement dans @master@ |
20 | 1 | Daniel Dehennin | |
21 | 26 | Daniel Dehennin | Les développeurs gèrent cette branche [[GitBonnesPratiques|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. |
22 | 1 | Daniel Dehennin | |
23 | 32 | Daniel Dehennin | Les règles habituellement admises dans le monde du logiciel libre sur l’installation sont conseillées, par exemple : |
24 | 32 | Daniel Dehennin | |
25 | 32 | Daniel Dehennin | * Écrire un "Makefile":http://fr.wikipedia.org/wiki/Makefile utilisant la variable @$(DEST)@ pour désigner la racine d’installation |
26 | 32 | Daniel Dehennin | * Utiliser les "autotools":http://fr.wikipedia.org/wiki/Autotools pour permettre la configuration des différents répertoires d’installation |
27 | 32 | Daniel Dehennin | |
28 | 32 | Daniel Dehennin | 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 : |
29 | 32 | Daniel Dehennin | # @make@ : pour compiler ce qui est compilable |
30 | 32 | Daniel Dehennin | # @make install@ : pour installer les fichiers et faire les tests |
31 | 32 | Daniel Dehennin | # @make uninstall@ : pour nettoyer ce qui a été installé |
32 | 32 | Daniel Dehennin | |
33 | 32 | Daniel Dehennin | La branche @master@ étant la branche publique des derniers développements, il est utile d’[[GitTagging|étiqueter]] des états techniques utilisables et/ou à tester. |
34 | 32 | Daniel Dehennin | |
35 | 26 | Daniel Dehennin | h2. Le packaging dans @dist/<VENDOR>/<DISTRIBUTION>/master@ |
36 | 26 | Daniel Dehennin | |
37 | 30 | Daniel Dehennin | Le packaging se compose de deux parties : |
38 | 26 | Daniel Dehennin | # Le code dit « upstream » |
39 | 26 | Daniel Dehennin | # Le code permettant de « faire le paquet », c’est à dire le contenu du répertoire @debian/@ pour les "paquets deb":http://fr.wikipedia.org/wiki/Deb. |
40 | 26 | Daniel Dehennin | |
41 | 29 | Daniel Dehennin | h3. La première fois, c’est toujours la plus difficile |
42 | 26 | Daniel Dehennin | |
43 | 31 | Daniel Dehennin | Un outil est disponible pour préparer le packaging d’un logiciel: "dh-make":http://packages.qa.debian.org/d/dh-make.html, son utilisation est plutôt simple. |
44 | 1 | Daniel Dehennin | |
45 | 31 | Daniel Dehennin | # On récupère un projet : |
46 | 31 | Daniel Dehennin | <pre> |
47 | 31 | Daniel Dehennin | buildd@build:~/src/$ git clone http://dev-eole.ac-dijon.fr/git/eole-debsums && cd eole-debsums |
48 | 31 | Daniel Dehennin | </pre> |
49 | 31 | Daniel Dehennin | # On créé une branche de packaging : |
50 | 31 | Daniel Dehennin | <pre> |
51 | 31 | Daniel Dehennin | buildd@build:~/src/eole-debsums(master)$ git checkout -b dist/ubuntu/lucid/master |
52 | 31 | Daniel Dehennin | </pre> |
53 | 31 | Daniel Dehennin | # On créer un packaging de base : |
54 | 31 | Daniel Dehennin | <pre> |
55 | 31 | Daniel Dehennin | buildd@build:~/src/eole-debsums(dist/ubuntu/lucid/master)$ dh_make -c <LICENCE> -p eole-debsums_<VERSION> --createorig |
56 | 31 | Daniel Dehennin | [...] # Répondre aux questions |
57 | 31 | Daniel Dehennin | </pre> |
58 | 31 | Daniel Dehennin | # On ajoute ce packaging au "stagging area":http://progit.org/book/fr/ch2-2.html |
59 | 31 | Daniel Dehennin | <pre> |
60 | 31 | Daniel Dehennin | buildd@build:~/src/eole-debsums(dist/ubuntu/lucid/master)$ git add debian |
61 | 31 | Daniel Dehennin | </pre> |
62 | 31 | Daniel Dehennin | # On commit ce premier packaging, cela fait un point de départ même s’il n’est pas utilisable |
63 | 31 | Daniel Dehennin | <pre> |
64 | 31 | Daniel Dehennin | 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 |
65 | 31 | Daniel Dehennin | </pre> |
66 | 1 | Daniel Dehennin | |
67 | 31 | Daniel Dehennin | À partir de là il faut éditer les fichiers présents dans le répertoire @debian/@, principalement : |
68 | 31 | Daniel Dehennin | * @debian/control@ : |
69 | 31 | Daniel Dehennin | ** Faire attention au mainteneur ; |
70 | 31 | Daniel Dehennin | ** 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, …) |
71 | 31 | Daniel Dehennin | ** Faire attention à la version de la "Debian policy":http://www.debian.org/doc/debian-policy utilisée, 3.8.2 sur Lucid ; |
72 | 31 | Daniel Dehennin | ** Faire attention à la version de debhelper, @>= 7.4@ sur Lucid ; |
73 | 31 | Daniel Dehennin | ** Mettre une description, courte et longe, les métas paquets "doivent":http://lintian.debian.org/tags/empty-binary-package.html utiliser une des expressions "metapackage," "dummy," "dependency package," "empty package," ou "virtual package" dans la description longue |
74 | 31 | Daniel Dehennin | * @debian/compat@ : utiliser 7 pour Lucid |
75 | 31 | Daniel Dehennin | * @debian/copyright@. |
76 | 31 | Daniel Dehennin | |
77 | 31 | Daniel Dehennin | Supprimer l’extention @.ex@ ou @.EX@ des fichiers qui seront utiles et les modifier. |
78 | 31 | Daniel Dehennin | |
79 | 31 | Daniel Dehennin | h3. Mise à jour du packaging |
80 | 31 | Daniel Dehennin | |
81 | 31 | Daniel Dehennin | La mise à jour du packaging ne requiert pas grand chose par rapport à la création d’un nouveau paquet: |
82 | 26 | Daniel Dehennin | # On se place dans la branche de packaging voulu |
83 | 26 | Daniel Dehennin | # On modifie les fichiers dans le répertoire @debian/@ en fonction des besoins |
84 | 26 | Daniel Dehennin | # On publie ces modifications |
85 | 26 | Daniel Dehennin | # On compile un paquet, ou pas |
86 | 26 | Daniel Dehennin | |
87 | 26 | Daniel Dehennin | h3. Nouveau paquet, sans modification du packaging |
88 | 26 | Daniel Dehennin | |
89 | 20 | Daniel Dehennin | Afin de faire un paquet, il faut intégrer la branche de développement souhaitée, par exemple: |
90 | 20 | Daniel Dehennin | |
91 | 20 | Daniel Dehennin | # On passe sur la branche de packaging : |
92 | 20 | Daniel Dehennin | <pre>buildd@build:~/src/eole-debsums(master)$ git checkout dist/ubuntu/lucid/master</pre> |
93 | 1 | Daniel Dehennin | # On intègre les modifications faites par les autres (et eolepack) : |
94 | 1 | Daniel Dehennin | <pre>buildd@build:~/src/eole-debsums(dist/ubuntu/lucid/master)$ git pull</pre> |
95 | 20 | Daniel Dehennin | # On intègre nos modifications : |
96 | 21 | Daniel Dehennin | <pre>buildd@build:~/src/eole-debsums(dist/ubuntu/lucid/master)$ git merge master</pre> |
97 | 20 | Daniel Dehennin | # On envoi sur le dépôt central pour eolepack : |
98 | 20 | Daniel Dehennin | <pre>buildd@build:~/src/eole-debsums(dist/ubuntu/lucid/master)$ git push</pre> |
99 | 20 | Daniel Dehennin | # On se replace sur la branche de développement pour nos futures modifications |
100 | 18 | Daniel Dehennin | <pre>buildd@build:~/src/eole-debsums(dist/ubuntu/lucid/master)$ git checkout master</pre> |
101 | 26 | Daniel Dehennin | # On compile un nouveau paquet, ou pas |
102 | 17 | Daniel Dehennin | |
103 | 26 | Daniel Dehennin | NB: La branche par défaut dans eolepack est modifiée pour être @dist/ubuntu/lucid/master@. |
104 | 24 | Daniel Dehennin | |
105 | 23 | Daniel Dehennin | h4. Aide à la console (aka helper bash) |
106 | 23 | Daniel Dehennin | |
107 | 22 | Daniel Dehennin | Un petit script @bash@ (attachment:git-package) peut-être utilisé afin d’automatiser la procédure, il suffit de le mettre dans un répertoire du @PATH@, comme @/usr/local/bin@ et il sera pris automatiquement en compte par git: |
108 | 22 | Daniel Dehennin | |
109 | 1 | Daniel Dehennin | <pre> |
110 | 22 | Daniel Dehennin | buildd@build:~/src/eole-debsums(master)$ git package lucid |
111 | 1 | Daniel Dehennin | Do you want to merge 'master' into 'dist/ubuntu/lucid/master'?: y |
112 | 25 | Daniel Dehennin | Checkout 'lucid' master distribution branch 'dist/ubuntu/lucid/master': Switched to branch 'dist/ubuntu/lucid/master' |
113 | 25 | Daniel Dehennin | Pull from default remote: Already up-to-date. |
114 | 25 | Daniel Dehennin | Merge developpement from 'master': Already up-to-date. |
115 | 25 | Daniel Dehennin | Switch back to your developpement branch 'master'... Switched to branch 'master' |
116 | 22 | Daniel Dehennin | Push is not automatically done to avoid publishing possible errors. |
117 | 22 | Daniel Dehennin | buildd@build:~/src/eole-debsums(master)$ |
118 | 22 | Daniel Dehennin | </pre> |
119 | 22 | Daniel Dehennin | |
120 | 27 | Daniel Dehennin | 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): |
121 | 27 | Daniel Dehennin | <pre> |
122 | 28 | Daniel Dehennin | buildd@build:~/src/eole-debsums(master)$ git config --global alias.lucid 'package lucid' |
123 | 27 | Daniel Dehennin | </pre> |
124 | 27 | Daniel Dehennin | |
125 | 27 | Daniel Dehennin | Ensuite, il n’y a plus qu’a l’utiliser: |
126 | 27 | Daniel Dehennin | <pre> |
127 | 27 | Daniel Dehennin | buildd@build:~/src/eole-debsums(master)$ git lucid |
128 | 27 | Daniel Dehennin | Do you want to merge 'master' into 'dist/ubuntu/lucid/master'?: y |
129 | 27 | Daniel Dehennin | Checkout 'lucid' master distribution branch 'dist/ubuntu/lucid/master': Switched to branch 'dist/ubuntu/lucid/master' |
130 | 27 | Daniel Dehennin | Pull from default remote: Already up-to-date. |
131 | 27 | Daniel Dehennin | Merge developpement from 'master': Already up-to-date. |
132 | 27 | Daniel Dehennin | Switch back to your developpement branch 'master'... Switched to branch 'master' |
133 | 27 | Daniel Dehennin | Push is not automatically done to avoid publishing possible errors. |
134 | 27 | Daniel Dehennin | buildd@build:~/src/eole-debsums(master)$ |
135 | 27 | Daniel Dehennin | </pre> |
136 | 27 | Daniel Dehennin | |
137 | 26 | Daniel Dehennin | h1. Environnement de compilation personnel |
138 | 2 | Daniel Dehennin | |
139 | 2 | Daniel Dehennin | Il existe plusieurs outils afin de mettre en place des environnements de compilation personnels. |
140 | 15 | Daniel Dehennin | |
141 | 2 | Daniel Dehennin | L’outil utilisé dans le projet "Debian":http://www.debian.org se nomme "sbuild":http://wiki.debian.org/sbuild. |
142 | 1 | Daniel Dehennin | |
143 | 17 | Daniel Dehennin | 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. |
144 | 2 | Daniel Dehennin | |
145 | 1 | Daniel Dehennin | Cela permet de lancer des compilations en parallèles au besoin. |
146 | 2 | Daniel Dehennin | |
147 | 35 | Daniel Dehennin | Deux méthodes sont utilisables pour la mise en place des schroots avec snapshots : |
148 | 14 | Daniel Dehennin | |
149 | 14 | Daniel Dehennin | * [[eole:GitPackagingSbuildLVM|avec LVM]] |
150 | 1 | Daniel Dehennin | * [[eole:GitPackagingSbuildBtrfs|avec le système de fichier btrfs]] |
151 | 14 | Daniel Dehennin | |
152 | 14 | Daniel Dehennin | |
153 | 33 | Daniel Dehennin | 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 : |
154 | 14 | Daniel Dehennin | |
155 | 14 | Daniel Dehennin | <pre> |
156 | 3 | Daniel Dehennin | buildd@build:~/src$ sudo apt-get install git-core git-buildpackage fakeroot build-essential debhelper cdbs |
157 | 16 | Daniel Dehennin | buildd@build:~/src$ git clone http://dev-eole.ac-dijon.fr/git/eole-debsums |
158 | 16 | Daniel Dehennin | buildd@build:~/src$ cd eole-debsums |
159 | 16 | Daniel Dehennin | buildd@build:~/src/eole-debsums$ git checkout -b dist/ubuntu/lucid/build origin/dist/ubuntu/lucid/master |
160 | 16 | Daniel Dehennin | buildd@build:~/src/eole-debsums$ git buildpackage --git-builder="sbuild -A -d eole-2.3-dev" --git-cleaner=/bin/true |
161 | 16 | Daniel Dehennin | </pre> |
162 | 16 | Daniel Dehennin | |
163 | 16 | Daniel Dehennin | Ou si on souhaite minimiser les paquets à installer: |
164 | 16 | Daniel Dehennin | |
165 | 16 | Daniel Dehennin | <pre> |
166 | 16 | Daniel Dehennin | buildd@build:~/src$ sudo apt-get install git-core git-buildpackage dpkg-dev |
167 | 16 | Daniel Dehennin | buildd@build:~/src$ git clone http://dev-eole.ac-dijon.fr/git/eole-debsums |
168 | 16 | Daniel Dehennin | buildd@build:~/src$ cd eole-debsums |
169 | 16 | Daniel Dehennin | buildd@build:~/src/eole-debsums$ git checkout -b dist/ubuntu/lucid/build origin/dist/ubuntu/lucid/master |
170 | 16 | Daniel Dehennin | buildd@build:~/src/eole-debsums$ git buildpackage --git-builder="dpkg-buildpackage -nc -d -S" --git-cleaner=/bin/true |
171 | 16 | Daniel Dehennin | buildd@build:~/src/eole-debsums$ sbuild -A -d eole-2.3-dev ../eole-debsums_20111207-eole1.dsc |
172 | 16 | Daniel Dehennin | </pre> |
173 | 16 | Daniel Dehennin | |
174 | 13 | Daniel Dehennin | h1. Webographie |
175 | 7 | Daniel Dehennin | |
176 | 11 | Daniel Dehennin | * "PackagingGuide/Python":https://wiki.ubuntu.com/PackagingGuide/Python |