PyCon DE 2011 Leipzig: Vortrag Debian Paketierung

8/4/2019 PyCon DE 2011 Leipzig: Vortrag Debian Paketierung

http://slidepdf.com/reader/full/pycon-de-2011-leipzig-vortrag-debian-paketierung 1/78

PyCon DE 2011 - Debian-Paketierung

Paketierung von Python-Code für Debian

Jan Dittberner

Communardo Software GmbH

5. Oktober 2011PyCon DE 2011 – 1. Deutsche Python-Konferenz

. . . . . .

http://www.communardo.de/

mailto:[email protected]



. . . . . .

. . .. .Einleitung .. . . .. . . ..

Python-Module paketieren .. .Hinweise für Upstreams Demo/Fragen

EinleitungÜber den VortragendenÜber Debian

Jan Dittberner Communardo Software GmbH






. . . . . .

. . .. .Einleitung .. . . .. . . ..


Über den Vortragenden

Wer ist Jan Dittberner?

Softwarearchitekt bei Communardo in Dresden

Debian Developer

CAcert.org Infrastrukturadministrator

Spezialgebiete: freie Software, Kryptografie, …









. . . . . .

. . .. .Einleitung .. . . .. . . ..



Wer ist Jan Dittberner?

Softwarearchitekt bei Communardo in Dresden

Debian Developer

CAcert.org Infrastrukturadministrator

Spezialgebiete: freie Software, Kryptografie, … verheiratet, 3 Kinder, eine Katze









. . . . . .

. . .. .Einleitung .. . . .. . . ..



Was habe ich mit Python zu tun?

Maintainer von sqlalchemy-migrate



f /




http://ddportfolio.debian.net/

http://cracklib2.sf.net/

http://sqlalchemy-migrate.googlecode.com/



. . . . . .

. . .. .Einleitung .. . . .. . . ..





Maintainer des Python-Bindings für cracklib2



Ei l i P h M d l k i Hi i fü U D /F









. . . . . .

. . .. .Einleitung .. . . .. . . ..






Entwicklung und Hosting des Debian Developer

Portfolio Service (Pylons-Anwendung):http://ddportfolio.debian.net/



Ei l it P th M d l k ti Hi is fü U st s D /F









. . . . . .

. . .. .Einleitung .. . . .. . . ..








Maintainer diverser Debian-Pakete fürPython-Module und Mitglied in den DebianPython Module und ApplicationPackaging-Teams



Einleitung Python Module paketieren Hinweise für Upstreams Demo/Fragen









. . . . . .

. . .. .Einleitung .. . . .. . . ..








Maintainer diverser Debian-Pakete fürPython-Module und Mitglied in den DebianPython Module und ApplicationPackaging-Teams

Entwicklung diverser interner Python-Tools fürProjekte



Einleitung Python-Module paketieren Hinweise für Upstreams Demo/Fragen









. . . . . .

. . .. .Einleitung .. . . .. . . ..



Communardo Software GmbH Anbieter von Softwarelösungen zur Optimierung

der Kommunikation und Zusammenarbeit inTeams, Projekten und Unternehmen

Software- und Beratungshaus für gesamten

Realisierungszyklus









. . . . . .

. . .. .Einleitung .. . . .. . . ..

Python Module paketieren .. .Hinweise für Upstreams Demo/Fragen


Communardo Software GmbH

Jan Dittberner Communardo Software GmbHPyCon DE 2011 - Debian-Paketierung







. . . . . .

. . .. .Einleitung .. . . .. . . ..

Python Module paketieren .. .Hinweise für Upstreams Demo/Fragen

Über Debian

eine der umfangreichsten Distributionen freierSoftware








. . . . . .

. . .. .g .. . . .. . . ..

y p .. .p / g

Über Debian


1993 gegründet ... 2011 – 18. Geburtstag








. . . . . .

. . .. . .. . . .. . . .... .

/

Über Debian



hoher Anspruch an technische Qualität undFreiheit, festgeschrieben im Social Contract [1]

inklusive DFSG (Debian Free SoftwareGuidelines)








. . . . . .

. . .. . .. . . .. . . .... .

Über Debian





reines Community-Projekt mit demokratischerWahl des Projektleiters und Doocracy








. . . . . .

. . .. . .. . . .. . . .... .

Über Debian





reines Community-Projekt mit demokratischerWahl des Projektleiters und Doocracy

mehr als 800 Projektmitglieder (DebianDevelopers), viele weitere Beitragende








. . . . . .

. . .. . .. . . .. . . .... .

Über Debian

Portierungen für 12 offizielle (10 mitLinux-Kernel, 2 mit FreeBSD-Kernel) undweitere inoffizielle Architekturen








. . . . . .

. . .. . .. . . .. . . .... .

Über Debian


mehr als 28000 Software-Pakete für AMD64-und i386-Architekturen








. . . . . .

. . .. . .. . . .. . . .... .

Über Debian


mehr als 28000 Software-Pakete für AMD64-und i386-Architekturen

Basis für viele weitere Distributionen(populärster Vertreter: Ubuntu)








. . . . . .

. . .. . .. . . .. . . .... .

Python-Module paketierenPython und DebianAufbau von Debian-PaketenTools

Debian Bugtracking System BTS

Helfer für Arbeit mit Quellpaketendebhelper

Best Practice







. . . . . .

. . .. . .. . . .. . . .... .

Python und Debian

mehrere Python-Versionen in den Repositories


. . .Einleitung .Python-Module paketieren .Hinweise für Upstreams Demo/Fragen







. . . . . .

. . . . . .. . . ... .

Python und Debian


/usr/bin/python == Python 2.x,/usr/bin/python3 == Python 3.x









. . . . . .

. . . . . .. . . ... .

Python und Debian



Team-Maintenance für Python-Module (DPMT [2]) undPython-Anwendungen (PAPT [3])









. . . . . .

. . . . . .. . . ... .

Python und Debian




IRC-Channel: #debian-python (OFTC, irc.debian.org)









. . . . . .

. . . . . .. . . ... .

Python und Debian




IRC-Channel: #debian-python (OFTC, irc.debian.org) Mailingliste: [email protected]









. . . . . .

. . . . . .. . . ... .

Python und Debian




IRC-Channel: #debian-python (OFTC, irc.debian.org) Mailingliste: [email protected]

Kooperation mit Upstreams, Debian-Derivaten und anderenDistributionen ist erwünscht!









. . . . . .

. . . . . .. . . ... .

Aufbau von Debian-Paketen

Quellpakete

Upstream-Archiv (möglicherweise befreit von unfreienBestandteilen)







. . . . . .

. . . . . .. . . ... .

Aufbau von Debian-Paketen

Quellpakete


.diff.gz oder .debian.tar.gz mit Debian-Anpassungen(je nach Version des Formats)


. . .. .Einleitung .. . . .






. . . . . .

. . . ..Aufbau von Debian-Paketen

Quellpakete


.diff.gz oder .debian.tar.gz mit Debian-Anpassungen(je nach Version des Formats)

aus einem Quellpaket können mehrere Binärpakete erzeugtwerden


. . .. .Einleitung .. . . .






. . . . . .


Quellpakete - wichtige Dateien in debian/

copyright – Lizenz- undCopyrightinformationen


. . .. .Einleitung .. . . .







. . . . . .




control – Metadaten wie Maintainer,Abhängigkeiten, Beschreibungen, Definition derBinärpakete


. . .. .Einleitung .. . . .







. . . . . .





changelog – dokumentiert Änderungen amPaket, definiert Versionsnummer


. . .. .Einleitung .. . . .







. . . . . .





changelog – dokumentiert Änderungen amPaket, definiert Versionsnummer

rules – Script mit Regeln zum Bauen der

Binärpakete


. . .. .Einleitung .. . . .Python-Module paketieren .. .Hinweise für Upstreams Demo/Fragen






. . . . . .


Binärpakete bauen

dpkg-buildpackage -rfakeroot


. . .. .Einleitung .. . . .Python-Module paketieren .. .Hinweise für Upstreams Demo/Fragen






. . . . . .


Binärpakete bauen

dpkg-buildpackage -rfakeroot

pdebuild

…


. . .. .Einleitung .. . . .. . . .Python-Module paketieren .. .Hinweise für Upstreams Demo/Fragen






. . . . . .

.Aufbau von Debian-Paketen

Binärpakete - Aufbau

Dateiendung .deb








. . . . . .



Dateiendung .deb

Unix-ar-Archiv, mit 2 .tar.{gz,bz2,lzma,xz}-Dateien








. . . . . .



Dateiendung .deb


control.tar.gz für Metadaten und Maintainer-Skripte








. . . . . .



Dateiendung .deb



data.tar.{gz,bz2,lzma,xz} mit den zu installierendenDateien








. . . . . .



Dateiendung .deb



data.tar.{gz,bz2,lzma,xz}mit den zu installierendenDateien

*_all.deb für architekturunabhängige Dateien (Daten,Python-Module, Skripte ...)









. . . . . .



Dateiendung .deb



data.tar.{gz,bz2,lzma,xz} mit den zu installierendenDateien

*_all.deb für architekturunabhängige Dateien (Daten,Python-Module, Skripte ...)

*_<arch>.deb für architekturabhängige Dateien (kompilierter

native Code wie Python-Extensions)









. . . . . .

.Tools


http://bugs.debian.org



. . .. .Einleitung .. . . .. . . ..Python-Module paketieren .. .Hinweise für Upstreams Demo/Fragen




http://bugs.debian.org/



. . . . . .

Tools



Interaktion per E-Mail oder mit reportbug [4] sowie mit bts

aus dem Paket devscripts [5]










. . . . . .

Tools




aus dem Paket devscripts [5] WNPP – Work needing and prospective packages [6]










. . . . . .

Tools





RFP – Pakete die sich jemand wünscht










. . . . . .

Tools





RFP – Pakete die sich jemand wünscht ITP – Pakete die jemand erstellen will










. . . . . .

Tools

Helfer für Arbeit mit Quellpaketen

dch – Bearbeiten von debian/changelog









. . . . . .

Tools



debcommit – Arbeiten mit Versionskontrollsystemen mitInformationen aus debian/changelog und debian/control




T l






. . . . . .

Tools



debcommit – Arbeiten mit Versionskontrollsystemen mitInformationen aus debian/changelog und debian/control

svn-buildpackage – Bauen von Paketen mit Unterstützung

von Subversion (gibt es auch für andere VCS)




T l






. . . . . .

Tools

debhelper

Sammlung von Skripten für debian/rules

Command-Sequencer dh für Automatisierung von Paketbuildsmit gängigen Buildsystemen




Tools





. . . . . .

Tools

debhelper



dh_python2

Spezifika vonPython-Packages

Byte-Kompilierung Dependency-Berechnung




Tools





. . . . . .

Tools

debhelper



dh_python2

Spezifika vonPython-Packages

Byte-Kompilierung Dependency-Berechnung

dh_sphinxdoc

Baut Sphinx-Dokumentation

automatische Verlinkung mitpaketierten Versionen dernötigen JavaScript-Dateien




Tools





. . . . . .

Tools

Minimale debian/rules-Datei mit dh

#! / u s r / b i n / make

%:dh −−w i t h p yt ho n2 , s p h i n x d o c $@




Best Practice






. . . . . .

Best Practice

Pakete werden für Debian unstable gebaut (wandern später

automatisch nach testing und ggf. stable)



. . .. .Einleitung .. . . .. . . ..


Best Practice






. . . . . .


automatisch nach testing und ggf. stable) Verwenden von pbuilder [7], cowbuilder [8] oder einem

aktuellen unstable-chroot zum Bauen



. . .. .Einleitung .. . . .. . . ..


Best Practice






. . . . . .


automatisch nach testing und ggf. stable) Verwenden von pbuilder [7], cowbuilder [8] oder einem

aktuellen unstable-chroot zum Bauen

Verwenden eines Versionskontrollsystems (DPMT und PAPTverwenden Subversion)



. . .. .Einleitung .. . . .. . . ..







. . . . . .

Hinweise für UpstreamsWie kommt Software in Debian?gute Voraussetzungen für Paketierung



. . .. .Einleitung

.. . . .. . . ..

Python-Module paketieren

.. .Hinweise für Upstreams Demo/Fragen

Wie kommt Software in Debian?





. . . . . .

”normaler“ Ablauf für neues Paket

interessante Software gefunden



. . .. .Einleitung

.. . . .. . . ..









. . . . . .



Suche in WNPP, ob schon jemand daran arbeitet



. . .. .Einleitung

.. . . .. . . ..









. . . . . .




RFP (Request for Packaging) oder ITP (Intent toPackage) im Bugtracking-System



. . .. .Einleitung

.. . . .. . . ..









. . . . . .





Ermittlung von Lizenzinformationen und anderen fürdie Paketierung notwendigen Daten



. . .. .Einleitung

.. . . .. . . ..









. . . . . .






Paketierungsarbeit durch Debian-Developer oderinteressierten Maintainer



. . .. .Einleitung

.. . . .. . . ..









. . . . . .







Upload durch Debian-Developer



. . .. .Einleitung

.. . . .. . . ..









. . . . . .







Upload durch Debian-Developer bei erstem Upload Freigabe oder Ablehnung durch

einen FTP-Master (vor allem wegen Lizenzprüfung)



. . .. .Einleitung

.. . . .. . . ..



gute Voraussetzungen für Paketierung






. . . . . .

nichts von”

what to do if you don’t want your modulein Debian?“ [9] tun



. . .. .Einleitung

.. . . .. . . ..










. . . . . .

paketierte Versionen von Abhängigkeiten verwenden



. . .. .Einleitung

.. . . .. . . ..










. . . . . .


API- und ABI-Interfaces möglichst stabil halten(besonders bei Modulen wichtig)



. . .. .Einleitung

.. . . .. . . ..










. . . . . .



alle zum Bauen benötigten Dateien mitliefern



. . .. .Einleitung

.. . . .. . . ..










. . . . . .



alle zum Bauen benötigten Dateien mitliefern

saubere Versionierung nach PEP-0386 [10], eine

Version pro Source-Archiv



. . .. .Einleitung

.. . . .. . . ..










. . . . . .

eine anerkannte DFSG-kompatible Lizenz (korrekt)

nutzen, die Nutzung dokumentieren und Lizenztextmitliefern



. . .. .Einleitung

.. . . .. . . ..










. . . . . .



keine fest eingebauten Dateipfade verwenden



. . .. .Einleitung

.. . . .. . . ..










. . . . . .




eine ordentlich gepflegte setup.py



. . .. .Einleitung

.. . . .. . . ..










. . . . . .




eine ordentlich gepflegte setup.py

Tests im Source-Archiv



. . .. .Einleitung

.. . . .. . . ..










. . . . . .

Demo – Paketierung von python-fudge



. . .. .Einleitung

.. . . .. . . ..








. . . . . .

Zeit für Fragen



Kontakt Literatur





. . . . . .

Jan Dittberner

Communardo Software GmbH E-Mail: [email protected]

IRC: jandd (OFTC, Freenode)

Blog: http://www.communardo.de/

home/techblog/author/jdi



Kontakt Literatur




http://www.communardo.de/home/techblog/author/jdi

http://www.communardo.de/home/techblog/author/jdi


http://packages.qa.debian.org/d/devscripts.html



. . . . . .

[1] Debi an Social Contract . url:

http://www.debian.org/social_contract.[2] Debian Python Modules Team. url:

http://wiki.debian.org/Teams/PythonModulesTeam.

[3] Python Applications Packaging Team. url: http:

//wiki.debian.org/Teams/PythonAppsPackagingTeam.[4] Wie werde Fehler in Debian mit Reportbug berichtet? url:

http://www.debian.org/Bugs/Reporting.

[5] devscripts source package . url:

http://packages.qa.debian.org/d/devscripts.html.[6] Debian Bug Tracking System: Work needing and prospective

packages . url: http://bugs.debian.org/wnpp.



Kontakt Literatur

[7] pbuilder source package url:



http://bugs.debian.org/wnpp

http://packages.qa.debian.org/d/devscripts.html

http://www.debian.org/Bugs/Reporting

http://wiki.debian.org/Teams/PythonAppsPackagingTeam

http://wiki.debian.org/Teams/PythonAppsPackagingTeam

http://wiki.debian.org/Teams/PythonModulesTeam

http://www.debian.org/social_contract

http://www.python.org/dev/peps/pep-0386/




. . . . . .

[7] pbuil der sourc e package . url:http://packages.debian.org/p/pbuilder.html.

[8] cowbuilder source package . url:http://packages.debian.org/c/cowbuilder.html.

[9] Piotr Ożarowski. what to do if you don’t want your module in Debian. 2010. url:

http://mail.python.org/pipermail/python-dev/2010-April/099729.html.

[10] Tarek Ziadé. PEP-386: Changing the version comparisonmodule in Distutils . 2010. url:

http://www.python.org/dev/peps/pep-0386/ .






http://www.python.org/dev/peps/pep-0386/

http://mail.python.org/pipermail/python-dev/2010-April/099729.html

http://mail.python.org/pipermail/python-dev/2010-April/099729.html

http://packages.debian.org/c/cowbuilder.html

http://packages.debian.org/p/pbuilder.html

PyCon DE 2011 Leipzig: Vortrag Debian Paketierung

Documents

Transcript of PyCon DE 2011 Leipzig: Vortrag Debian Paketierung