Gliederung. Debian-Paketierung für Fortgeschrittene... was nach dh_make, anpassen der Templates und dpkg-buildpackage kommt.

Transkript

1 Debian-Paketierung für Fortgeschrittene 1 / 45 Debian-Paketierung für Fortgeschrittene 2 / 45 Gliederung Debian-Paketierung für Fortgeschrittene... was nach dh_make, anpassen der Templates und dpkg-buildpackage kommt. Alexander Reichle-Schmehl <tolimar@debian.org> Debian Projekt , Mini-DebConf Berlin Debian-Paketierung für Fortgeschrittene 3 / 45 Einführung Voraussetzungen Makefiles / debian/rules Binär-Paket und Source-Paket Upstream native Debian Package WNPP / ITP / RFS Maintainer-Scripts debhelper / cdbs pbuilder lintian uscan / uupdate / devscripts quilt / dpatch debconf / i18n Debian-Paketierung für Fortgeschrittene 5 / 45 Mehrere Binary-Pakete pro Source-Paket Einträge in debian/control Bauen mehrere Binary-Pakete pro Source-Paket Binärpakete werden in debian/control definiert. Hier können beliebig viele definiert werden: Source: ppracer Package: planetpenguin-racer Architecture: any Package: planetpenguin-racer-dbg Architecture: any Package: planetpenguin-racer-data Architecture: all Package: planetpenguin-racer-gimp-dev Architecture: all Jedes Binärpaket hat einen eigenen Eintrag, mit Abhängigkeiten, Paket-Beschreibung, etc.

2 Debian-Paketierung für Fortgeschrittene 7 / 45 Mehrere Binary-Pakete pro Source-Paket Handhabung in debian/rules Parameter für debhelper Alle debhelper-skripts können gesteuert verschiedene Binär-Pakete ansprechen. Parameter für den direkten Aufruf: -a oder -arch: Aufruf gilt für alle Architektur abhängigen Pakete. -i oder -indep: Aufruf gilt für alle Architektur unabhängigen Pakete. -p<paket> oder -package=<paket>: Aufruf gilt für das Paket <Paket> (kann mehrfach angegeben werden). -N<Paket> oder -no-package=<paket>: Aufruf gilt nicht für das Paket <Paket>. Debian-Paketierung für Fortgeschrittene 8 / 45 Mehrere Binary-Pakete pro Source-Paket Handhabung in debian/rules debhelper Beispiel dh_install -i samples/* usr/share/doc/xdialog/examples/ Installiert alle Dateien des Verzeichnisses samples in allen Architektur unabhängigen Paketen in den Ordner usr/share/doc/xdialog/examples/. dh_install -pplanetpenguin-racer-gimp-dev contrib/script-fu/* /usr/share/gimp/2.0/scripts/ Installiert alle Dateien des Verzeichnises contrib/script-fu/ in das Verzeichnis /usr/share/gimp/2.0/scripts/ des Paketes planetpenguin-racer-gimp-dev. Debian-Paketierung für Fortgeschrittene 9 / 45 Mehrere Binary-Pakete pro Source-Paket Handhabung in debian/rules debhelper-dateien Werden debhelper-skripts nicht direkt mit Parametern aufgerufen, sondern mittels Parameter-Dateien (z.b. install), so kann der Names des Binärpakets vorangestellt werden, und der Type als Extension verwendet werden: debian/xdialog.dirs usr/bin debian/xdialog-doc.dirs /usr/share/doc/xdialog/examples /usr/share/doc/xdialog/html Hierdurch wird im Paket xdialog das Verzeichnis usr/bin und im Paket xdialog-doc die Verzeichnisse /usr/share/doc/xdialog/examples und /usr/share/doc/xdialog/html erstellt. Debian-Paketierung für Fortgeschrittene 10 / 45 Mehrere Binary-Pakete pro Source-Paket Handhabung in debian/rules Vorgehensweise in debian/rules Im Regelfall (ein Architektur abhängiges und ein unabhängiges Paket) geht man also so vor: debian/rules install: build $(MAKE) install DESTDIR=$(CURDIR)/debian/tmp binary-indep: build install dh_install -i binary-arch: build install dh_install -a

3 Debian-Paketierung für Fortgeschrittene 12 / 45 Allgemeines Liste aller möglichen Paket-Beziehungen Depends Pre-Depends Recommends Suggests Enhances Breaks Conflicts Replaces Provides Build-Depends Build-Depends-Indep Build-Conflicts Build-Conflicts-Indep Debian-Paketierung für Fortgeschrittene 13 / 45 Allgemeines Allgemeines Die Beziehungen eines Paketes werden in debian/control definiert. Abhängigkeiten können Alternativen enthalten: Depends: aspell ispell Bei virtuellen Paketen (z.b. mail-transport-agent) muss als erstes ein echtes Paket aufgezählt werden. Können Versions-Angaben enthalten: Depends: libc6 (>= 2.7-1) Debian-Paketierung für Fortgeschrittene 15 / 45 Abhängigkeiten zwischen Source-Paketen Abhängigkeiten zwischen Source-Paketen Build-Depends Ein Pakete wird benötigt, um dieses Source-Paket zu bauen. Build-Depends-Indep Ein Paket wird benötigt, um den Architektur unabhängigen Teil dieses Source-Paketes zu bauen. Build-Conflicts Ein Paket darf nicht installiert sein, um dieses Source-Paket zu bauen. Build-Conflicts-Indep Ein Paket darf nicht installiert sein, um den Architektur unabhängigen Teil dieses Source-Paketes zu bauen. Debian-Paketierung für Fortgeschrittene 17 / 45 Abhängigkeiten zwischen Binär-Paketen Strenge Abhängigkeiten zwischen Binärpaketen I Depends Ein Paket muss installiert sein, damit dieses Binärpaket benutzt werden kann. Viele Abhängigkeiten (verlinkte Bibliotheken, benutzter Python-Interpreter) werden automatisch erkannt: Depends: ${shlibs:depends}, ${misc:depends}, ${perl:depends}, ${python:depends}. Dazu muss lediglich das passende debhelper-skript in debian/rules aufgerufen werden: binary-arch: build install dh_shlibdeps

4 Debian-Paketierung für Fortgeschrittene 18 / 45 Abhängigkeiten zwischen Binär-Paketen Strenge Abhängigkeiten zwischen Binärpaketen II Pre-Depends Ein Paket muss installiert, bevor dieses Binärpaket installiert werden kann. Typisches Beispiel: Das preinst-script des Binärpakets wurde in perl geschrieben Durch Pre-Depends können gefährliche Schleifen entstehen! Nur einsetzen, wo wirklich notwendig! Noch besser: GAR NICHT! Debian-Paketierung für Fortgeschrittene 19 / 45 Abhängigkeiten zwischen Binär-Paketen Weiche Abhängigkeiten Recommends Es wird empfohlen, ein anderes Paket installiert zu haben, wenn dieses Binärpaket installiert wird. Im Regelfall werden Recommends durch die Paket-Verwaltung automatisch mit installiert, können jedoch problemlos wieder entfernt werden. Suggests Es wird vorgeschlagen, ein anderes Paket installiert zu haben, wenn dieses Binärpaket installiert wird. Im Gegensatz zu Recommends werden solche Pakete nicht automatisch mit installiert, sondern lediglich angezeigt. Enhances Dieses Binärpaket erweitert die Funktionalität eines anderen Paketes; sozusagen ein Rückwärts-Suggests. Wird von Debians-Paketverwaltung (meines Wissens nach) ignoriert und daher auch kaum benutzt. Debian-Paketierung für Fortgeschrittene 20 / 45 Abhängigkeiten zwischen Binär-Paketen Konflikte und ähnliches zwischen Binärpakete Conflicts Ein anderes Binärpaket darf nicht gleichzeitig mit diesem Paket installiert sein (zum Beispiel mehrere Mail-Server). Breaks Ein anderes Binärpaket darf zwar gleichzeitig installiert, jedoch nicht konfiguriert (und damit benutzbar) sein. Replaces Dieses Binärpaket ersetzt ein anderes Paket (idr. einer bestimmten Version, komplett oder einzelne Dateien). Debian-Paketierung für Fortgeschrittene 21 / 45 Abhängigkeiten zwischen Binär-Paketen Virtuelle Pakete Virtuelle Pakete sind keine real existierende Pakete, sondern klar definierte Gruppen von Paketen, die die gleiche Funktionalität bereitstellen. Einige Beispiele: www-browser, x-terminal-emulator oder java2-runtime. Ein Paket kann sich dieser Gruppe von funktional ähnlichen Paketen selbst hinzufügen indem es ein Provides: <virtuelles-paket> setzt. Abhängigkeiten auf virtuelle Pakete können nicht versioniert sein! Eine Liste einiger virtueller Pakete gibt es unter: virtual-package-names-list.txt. Paket-Maintainer eng verwandter Pakete dürfen aber auch eigene virtuelle Pakete definieren.

5 Debian-Paketierung für Fortgeschrittene 22 / 45 Nützliche debhelper-scripts Debian-Paketierung für Fortgeschrittene 23 / 45 Nützliche debhelper-scripts Allgemeines zu debhelper I Allgemeines zu debhelper II... und zwar: Debhelper ist eine Sammlung von Skripten, die das erstellen von Debian-Paketen erleichtert. Für viele alltägliche Tätigkeiten gibt es bereits passende Skripts, die in debian/rules aufgerufen werden können. Neben den bereits genannten Parametern -arch, -indep, -package=package und -no-package=package gibt es noch folgende Parameter, die von allen debhelper-skripten erkannt werden... -verbose: Zeige alle Kommandos detailiert auf. -no-act: Führe nichts aus. -ignore=datei: Ignoriert eine debhelper-konfigurationsdatei. -tmpdir=tmpdir: Benutze tmpdir als temporäres Verzeichnis. -mainpackage=foo: Legt das primäre Paket fest (install statt <paketname>.install, etc.) Debian-Paketierung für Fortgeschrittene 24 / 45 Nützliche debhelper-scripts Debian-Paketierung für Fortgeschrittene 25 / 45 Nützliche debhelper-scripts Allgemeines zu debhelper III Häufige Parameter für debhelper-skripts sind: -n: Verhindert das ändern von Maintainer-Scripts -exclude=item: Ignoriert einen Eintrag (z.b. komprimiere keine PDF-Dateien in /usr/share/doc) -all: Führt ein Kommando auf allen Paketen, nicht nur dem primären aus. debhelper ist sehr gut dokumentiert! Neben den Beispielen in /usr/share/doc/debhelper/examples existiert für jedes Kommando eine ausführliche Manpage. Diverse nützliche debhelper-kommandos I Ein kleiner Auszug; für weiter siehe debhelper(7). dh_install, dh_installdirs, dh_installdocs, dh_link, dh_clean Installiert Dateien, Verzeichnisse, Dokumentation oder Links. dh_clean räumt Überbleibsel aus dem Build-Prozess auf. dh_shlibdeps, dh_pysupport/dh_pycentral, dh_perl Ermittelt die korrekten Abhängigkeiten eines Paketes. dh_icons, dh_installmenu Aktualisiert den Icon-Cache; installiert einen Menu-Eintrag in Debians-Menu-System.

6 Debian-Paketierung für Fortgeschrittene 26 / 45 Nützliche debhelper-scripts Debian-Paketierung für Fortgeschrittene 27 / 45 pbuilder Diverse nützliche debhelper-kommandos II dh_installinfo, dh_installman Install Manpages oder Info-Pages. dh_installcron Installiert einen Cron-Job. dh_installifupdown, dh_installppp Installiert Skripte, die beim hochfahren eines Netzwerk-Interfaces oder eine PPP-Verbindung ausgeführt werden. dh_installinit, dh_installlogcheck, dh_installlogrotate Installiert ein Init-Skript, Zusätzliche Ignore-Settings für logcheck bzw. Konfigurations-Dateien für Log-Rotate. dh_installdebconf Installiert Templates zur Interaktion mit dem Benutzer. pbuilder und piuparts pbuilder bzw. cowbuilder eignen sich dazu saubere, minimale chroot-umgebungen zu warten, Pakete darin zu bauen, Installationen und Aktualisierungen zu testen (gut um beispielsweise build-depends zu testen). Mit pbuilder create kann eine solche Umgebung erstellt werden; danach ist ein gelegentliches pbuilder update notwendig. Mit pbuilder login kann man sich in ein solches, minimales chroot einlogen, um weitere Tests durchzuführen. Durch mehrere Konfigurations-Dateien können auch unterschiedliche Suiten (stable, testing, unstable) verwaltet werden. Ein Tool, welches automatisch diverse Tests bezüglich der Installation und Aktualisierung von Paketen durchführt ist piuparts. Aufruf: piuparts -basetgz=tarball <paketdatei>. Debian-Paketierung für Fortgeschrittene 28 / 45 Debian-Paketierung für Fortgeschrittene 29 / 45 Warum spezielles Patchmanagement? Zwar liegen Debians Änderungen an einem Paket bereits in einem separatem diff vor, aber das ist oft unzureichend: wirklich saubere Trennung von Upstream Quell-Code uns eigenen Anpassungen Einfaches Weiterreichen von Änderungen, entfernen von eingespielten Änderungen bei neuer Upstream-Version Übersicht über eigene Änderungen, deren Zusammenhang, und Beweggründe Erleichtert NMUs und security Uploads Ermöglicht Architektur-Spezifische Änderungen... Es sollte vermieden werden, die gleiche Datei in mehreren Patches zu verändern! Ansätze zum quilt Erlaubt das erstellen von Patches für einzelne, benannte Dateien. dpatch Erlaubt das erstellen neuer Patches für gesamtes Source-Paketes. Wenn man eines dieser Tools einsetzt, dann nicht vergessen, die Build-Depends passend zu setzen!

7 Debian-Paketierung für Fortgeschrittene 31 / 45 Quilt Einbinden von quilt in debian/rules include /usr/share/quilt/quilt.make clean: unpatch build-stamp: patch Debian-Paketierung für Fortgeschrittene 32 / 45 Quilt Erstellen eines neuen Patches für quilt 1. export QUILT_PATCHES=debian/patches Korrigiere Verzeichnis für Patches. 2. quilt push -a Wende alle bisherigen Patches an. 3. quilt new das-ist-mein-neuer-patch.patch Erstelle eines neuen Patches. 4. quilt edit src/eine/source-datei.c Füge eine Datei dem aktuellen Patch hinzu und öffnet Sie im Editor Quilt erstell eine Sicherungskopie dieser Datei. 5. quilt refresh Quilt vergleicht nun die veränderte Datei mit der Sicherungskopie und erstellt den Patch. 6. quilt pop -a Zurückspielen aller Patches, so dass man wieder eine saubere Umgebung hat. Debian-Paketierung für Fortgeschrittene 34 / 45 dpatch Einbinden von dpatch in debian/rules Debian-Paketierung für Fortgeschrittene 35 / 45 dpatch Erstellen eines neuen Patches für dpatch include /usr/share/dpatch/dpatch.make clean: unpatch build-stamp: patch dpatch-edit-patch patch XX_patchname dpatch kopiert den kompletten Source in ein temporäres Verzeichnis und öffnet dort eine Subshell. Dort kann nach belieben an Dateien editiert werden. Durch exit 0 wird die shell verlassen, und der neue Patch erstellt.

8 Debian-Paketierung für Fortgeschrittene 36 / 45 Interaktion mit dem Benutzer mittels Debconf Debian-Paketierung für Fortgeschrittene 37 / 45 Interaktion mit dem Benutzer mittels Debconf debconf ist... debconf ist... Debian-Paketierung für Fortgeschrittene 38 / 45 Interaktion mit dem Benutzer mittels Debconf Debian-Paketierung für Fortgeschrittene 39 / 45 Interaktion mit dem Benutzer mittels Debconf debconf ist... debconf: Interaktion mit dem Benutzer debconf erlaubt es einem Maintainer mit dem Benutzer zur Installation eines Paketes zu kommunizieren. Zum Beispiel zum abfagen von Konfigurations-Parametern. Administratoren können antworten Preseeden, also antworten Vorgeben und so angepasste Installationen vornehmen.. wie das geht, schauen wir uns am besten mal an einem Beispiel an.

9 Debian-Paketierung für Fortgeschrittene 41 / 45 Anderes Integration mit Versionskontrolle Debian-Paketierung für Fortgeschrittene 43 / 45 Anderes Andere Tipps Integration mit Versionskontrolle $ apt-cache search -- -buildpackage bzr-builddeb - bzr plugin for Debian package management cvs-autoreleasedeb - Automatically release/upload debian packages from CVS svn-autoreleasedeb - Automatically release/upload debian packages from SVN arch-buildpackage - Werkzeug zur Verwaltung von Debian-Paketen mit Arch cvs-buildpackage - Ein Satz an Debian-Paket-Scripten für CVS-Quellbäume. darcs-buildpackage - Suite, die beim Arbeiten mit Debian-Paketen aus Darcs-Archiven hilft Kopfzeile Vcs-* in debian/control Linux Standard Base Initskripte (Kopf mit Abhängigkeiten von anderen Services) devscripts - Skripte, die das Leben eines Debian-Paketbetreuers erleichtern bashisms vermeiden; Shellskripte mit dash -n oder git-buildpackage - Suite, die bei Debian-Paketen in Git-Depots hilft checkbashisms immer auf Syntaxfehler prüfen mercurial-buildpackage - Suite für die Wartung von Debian-Paketen in Mercurial-Depots ruby-pkg-tools - Werkzeuge zum Bau von Debian Ruby-Paketen tla-buildpackage - Nützliche Suite für Debian-Pakete in Arch-Archiven Unter anderem: bts, checkbashisms, debchange/dch, svn-buildpackage - helper programs to maintain Debian packages with Subversion Wird hier erstmal nicht behandelt, zu unterschiedliche Ansprüche. Andere nützliche Tipps lintian benutzen, um häufige Fehler zu finden Target get-orig-source in debian/rules debian/watch zum automatisierten Kontrollieren der aktuellen Version Das Paket devscripts enthält viele nützliche Skripts zur Paketierung und interatkion mit Debians-Infrastruktur. desktop2menu, dget, licensecheck, pts-subscribe, rc-alert, uscan, uupdate, wnpp-alert, wnpp-check. Debian-Paketierung für Fortgeschrittene 44 / 45 Zu Debian Beitragen Debian-Paketierung für Fortgeschrittene 45 / 45 Danke Zu Debian Beitragen Drei Möglichkeiten: 1. per Sponsor Anfragen auf der debian-mentors 1 und / oder debian-science 2 Liste. 2. Als Debian-Maintainer Erlaubnis, die eigenen Pakete selbst hochzuladen; benötigt wird GnuPG-Key, Zustimmung zu den Debian Free Software Guidelines, ein Befürworter seitens des Projektes. 3. Als Debian-Developer Darf Wählen, neue Pakete hochladen, fremde Pakete NMUen, etc. Längerer Prozess zum sicherstellen der Philosophie und der technischen Fähigkeiten; setzt vorheriges Engagement voraus Danke für die Aufmerksamkeit! Vielen Dank für ihre Aufmerksamkeit! Für weitere Fragen und Beispiele stehe ich sehr gerne zur Verfügung! tolimar@debian.org

10 Debian-Paketierung für Fortgeschrittene 45 / 45 Weiterführende Literatur Debian Policy Manual: Grundlegendes Dokument über den Aufbau von Debian-Paketen und deren Interaktion mit anderen http: // Debian Developer s Reference: Diverse Prozesse innerhalb des Debian-Projekts http: // Debian New Maintainers Guide: Einführung in das Erstellen von Debian-Paketen an einem Beispiel maint-guide