evolix/wiki
22
0
Fork 0
Code Releases Activity
wiki/HowtoDebian/Packaging.md
David Prevot 8d4543d1d4 Drop old PEAR/PECL advices not usable anymore
2023-10-04 15:31:43 +02:00

5.9 KiB
Raw Blame History

Créer un paquet Debian

Génération de l'arborescence debian/

Cette étape consiste à créer une arborescence qui constituera le paquet Debian. On peut l'automatiser simplement avec la commande dh_make :

cd futur-paquet-0.1
dh_make

NOTE : le nom du répertoire doit obligatoirement être de la forme nom-version (nom peut contenir des minuscules, chiffres et tirets).

En utilisant dh_make sans options, il essayera de deviner les informations dont il a besoin. On peut forcer celles ci en les spécifiant sur la ligne de commande. Pour les plus utiles :

  • -c : la licence du programme ;
  • -e : l'adresse email du responsable du paquet (vous) ;
  • -p : nom du paquet, si le nom du répertoire courant n'est pas sous la forme standard ;
  • -f : chemin vers l'archive contenant les sources. Si elle n'existe pas, utilisez l'option --createorig.

Le type de paquet vous sera demandé lors de l'exécution.

Édition de certains fichiers importants

dh_make a créé de nombreux fichiers dans le répertoire debian/. Certains sont indispensables, d'autres moins. Par exemple (si vous ne vous en servez pas) vous pouvez supprimer tous les *.ex, des templates servant d'exemple.

rm *.ex
rm *.EX

Voici une rapide explication à propos des fichiers importants :

  • le fichier control : il décrit de manière générale le paquet. Plusieurs champs sont à compléter, notamment :
  • Section : voir la liste ici ;
  • Homepage : le site du programme ;
  • Architecture : any par défaut, ce qui va générer un paquet par architecture. Dans le cas d'un script shell par exemple, on préférera all (un seul paquet est généré car compatible avec toutes les architectures) ;
  • Depends : indiquez ici le nom et la version des paquets dont dépends éventuellement le programme (en général des bibliothèques) ;
  • Description : le champ doit contenir une description courte, suivi d'une description longue (sur la ligne suivante, indentée d'un espace).
  • le fichier changelog : il décrit les changements qui ont été fait sur le programme. À priori, il est déjà complété avec un « Initial release ». Supprimez juste le « (Closes: #nnnn) » puisque c'est la première version.
  • le fichier copyright : il contient la licence sous laquelle est distribué le programme. dh_make l'a partiellement remplit, il vous reste à indiquer le(s) développeur(s) du programme ainsi que le texte de la licence.
  • le fichier rules : c'est en fait un fichier Makefile, qui décrit les règles de construction et d'installation du paquet. Dans le cas d'un script unique, et qui ne nécessite pas de configuration/compilation :

C'est le célèbre ./debian/rules qui gère donc la compilation et la copie des fichiers dans la future arborescence. Si l'on simplement copier un script, on peut par exemple rajouter ceci à la fin de la cible install :

    install -d -m 0755 -o root -g root $(CURDIR)/debian/futur-paquet
    install    -m 0755 -o root -g root nom-du-script $(CURDIR)/debian/futur-paquet

Construction du paquet

Maintenant nous pouvons construire le paquet à l'aide de la commande :

$ debuild -us -uc

Si aucune erreur n'est apparue, votre paquet est prêt à être installé et/ou poussé sur un dépôt non officiel.

Manipulation d'un paquet (binaire)

Pour certaines (mauvaises) raisons, on peut être amené à vouloir modifier un paquet binaire... notamment un maintainer script par exemple.

$ ar x foo.deb
$ ls
control.tar.gz data.tar.gz debian-binary
$ tar xf control.tar.gz
$ vim preinst
<hack...hack...hack>
$ tar cvf control.tar.gz md5sums postrm control prerm preinst postinst
$ ar r foo.deb control.tar.gz

Et voilà, on a modifié le preinst du paquet foo.deb.

Paquets simplistes pour administrateurs système (equivs)

Certains paquets (généralement non officiels) ont parfois des dépendances impossibles à satisfaire, ou non nécessaire dans certains contextes. equivs propose une alternative simple aux paquets Debian pour satisfaire des dépendances (voir plus).

Par exemple, le paquet mysql-client n’est pas présent dans Bullseye, mais si en paquet en dépend, le fichier suivant permet de créer un paquet qui fournit mysql-client et dépend à la place de default-mysql-client.

$ cat mysql-client.ctl
Package: mysql-client
Depends: default-mysql-client
Version: 8.0
Description: Workaround MySQL client for Ægir
 Current aegir3-cluster-slave package has unfulfillable dependencies on (at
 least) Bullseye.

La construction du paquet prend quelques secondes.

$ equivs-build mysql-client.ctl
[…]
dpkg-deb: building package 'mysql-client' in '../mysql-client_8.0_all.deb'.
[…]
The package has been created.
Attention, the package has been created in the current directory,
not in ".." as indicated by the message above!
[…]
# apt install ./mysql-client_8.0_all.deb

FAQ

Erreur lintian : mkdir -p failed at /usr/share/perl5/Lintian/Unpacker.pm line 224

mkdir -p /tmp/temp-lintian-lab-6xngeaELBD/pool/d/devscripts/devscripts_2.13.8_amd64_binary failed at  /usr/share/perl5/Lintian/Unpacker.pm line 224.

C'est probablement que votre système n'a pas assez de mémoire. Avec un strace lintian vous obtiendrez peut-être :

clone(child_stack=0, flags=CLONE_CHILD_CLEARTID|CLONE_CHILD_SETTID|SIGCHLD, child_tidptr=0x7f09117029d0) = -1 ENOMEM (Cannot allocate memory)