Delixs - Benutzerbeiträge [de]

Entwicklerhandbuch/Paketbau

2010-02-08T05:12:10Z

ThorstenStrusch: /* debian Pakete konfigurieren: debconf */ manpage -> pdf hinzugefügt

__NOTOC__
{{Uberarbeiten}}

__TOC__

== debian Pakete konfigurieren: debconf ==

Das Einstiegsdokument um das Thema anzugehen, sollte

man 7 debconf

sein. Diese Manual-Seite ist verfügbar, wenn das Paket "debconf-doc"
installiert ist.

man debconf-devel

beschreibt ausführlich (ca. 13 DIN-A4 Seiten), wie man mit Debconf
programmiert. Natürlich in einer shell. Perl Programmierer sollten das
Paket "debaux-debconf" nach installieren.

In Debian wird fast alles in Manual-Seiten erklärt. Daher ist das Lesen
dieser Seiten für einen Entwickler unerlässlich. Manchmal will man aber
eine man-Seite nicht auf dem Schirm lesen, sondern als Papier-Ausdruck
neben sich liegen haben. Das geht mit diesem Kommando:

man -t debconf-devel | lpr -Plp0

Vorausgesetzt, man will die man Seite "debconf-devel" auf den lokalen
Drucker (Warteschlange) lp0 drucken. Zwischen dem großen P und dem
Drucker-Namen darf kein Leerzeichen sein. Der Drucker muss Postscript
können. Aber welcher Druckertreiber unter Linux kann das nicht?

Wer lieber ein PDF Dokument erhalten möchte, kann dies mit dem tool ps2pdf (debian-Paket gs-common) erzeugen:

man -t debconf-devel | ps2pdf - debconfdevel.pdf

=== Was ist "Debconf"? ===

Debconf ist ein Framework das dazu dient, Pakete bzw Programme zu
konfigurieren.

Es ist limitiert! Es ist keine Registry wie unter Windows. Debconf soll
nur dazu benutzt werden eine sinnvolle Grundkonfiguration der Pakete
einzustellen.

=== Woraus besteht Debconf? ===

Zunächst mal aus 2 Datenbanken. Eine enthält Fragen, die andere
Antworten. Wenn Fragen gestellt werden sollen, muss es auch eine
Möglichkeit geben, diese dem Benutzer zu präsentieren, dafür sind die
Frontends zuständig. Es gibt diverse Frontends. Bekannt dürfte
das "Dialog-Frontend" sein. Mein Favorit ist Gnome, KDE ist auch sehr
hübsch.

Jede Frage kann in jedem Frontend dargestellt werden! Für die Frontends
Gnome bzw KDE muss nicht zwingend Gnome und KDE installiert sein, eine
simple VGA-Grafik mit VESA ist ausreichend.

'''praktisches Beispiel:''' Du hast ein installiertes Debian mit X-Window (die ADE reicht aus, auch
wenn sie weder Gnome noch KDE hat). Knoppix oder Suse tuts auch. Selbst
Windows, wenn denn cygwin installiert ist.

In einem X-Terminal Fenster ( Du bist ein normaler User, nicht root)
gibst Du ein:

xhost +

Das ermöglicht allen lokalen Usern (dies gilt nur für Debian, nicht für
andere Linuxe) X-Windows Anwendungen auf Deinem X-Server zu starten.

Um die verschiedenen Frontends zu Testen, gibt man folgendes sein

su -
export DISPLAY=:0.0

Das aktuelle Frontend:

dpkg-reconfigure debconf

Das Dialog Interface. Nennt sich "dialog" ist aber "whiptail" und damit
also nicht Aufruf-kompatibel zu "dialog".

DEBIAN_FRONTEND=dialog dpkg-reconfigure debconf

Die beiden grafischen Frontends

DEBIAN_FRONTEND=gnome dpkg-reconfigure debconf
DEBIAN_FRONTEND=kde dpkg-reconfigure debconf

Das Editor Interface mit dem allseits beliebten Editor mcedit:

DEBIAN_FRONTEND=editor EDITOR=mcedit dpkg-reconfigure debconf

Der mcedit ist im Paket mc enthalten. Im Zweifel also ein

aptitude install mc

durchführen.

Die Debconf Fragen sind multi-lingual. Wenn man eine Sprache wählen
will, muss die Variable LANG angepasst werden, z.B.:

LANG=C dpkg-reconfigure debconf

oder für russisch, sofern installiert

LANG=ru dpkg-reconfigure debconf

Verfügbare Sprachen, eigentlich verfügbare Schriften, kann man erfragen
mit:

locale -a

Zurück zu Debconf, ein wichtiges Kommando ist:

debconf-show

Ohne Parameter gibt es die Aufruf-Syntax auf. Mit

debconf-show debconf

kann man sich anzeigen lassen, wie das Paket "debconf" konfiguriert ist.
Bei mir sieht das so aus:

debconf-show debconf
debconf-apt-progress/preparing:
debconf-apt-progress/title:
debconf-apt-progress/info:
debconf-apt-progress/media-change:
* debconf/frontend: Gnome
* debconf/priority: medium

In der Antwort-DB von Debconf steht also zu dem Paket "debconf"
folgendes drin:

frontend: Gnome
priority: medium

In der obigen Ausgabe von debconf-show haben nur zwei von sechs Fragen
eine Antwort hinterlegt (die beiden mit dem '*' am Anfang.

Die Debconf Datenbanken sind ASCII DBs und liegen
unter /var/cache/debconf. Eine Anfrage an die Antwort-DB mit grep,
ergibt dies:

grep 'debconf/frontend' /var/cache/debconf/config.dat
Name: debconf/frontend
Template: debconf/frontend

Wo ist der Wert "Gnome" geblieben? Hier:

grep -A 1 'debconf/frontend' /var/cache/debconf/config.dat
Name: debconf/frontend
Template: debconf/frontend
Value: Gnome

Er steht im Feld "Value" eine Zeile tiefer.

Dafür gibt es natürlich auch ein Tool,

debconf-get-selections |grep debconf/frontend
debconf debconf/frontend select Gnome

Die Ausgabe sieht hier etwas anders aus, aber das Resultat ist dasselbe.
Die Ausgabe von "debconf-get-selections" ist geeignet, um sie in einer
preseed-Datei weiter zu benutzen.

Nicht immer werden alle Fragen, die hinterlegt sind, auch angezeigt. Das
wird primär mit dem Schalter "DEBIAN_PRIORITY" gesteuert:

Installieren wir zunächst mal ein Paket, bei dem sich das gut
demonstrieren lässt: samba

aptitude install samba

Nun die Prioritäten testen:

DEBIAN_PRIORITY=high dpkg-reconfigure samba
DEBIAN_PRIORITY=medium dpkg-reconfigure samba
DEBIAN_PRIORITY=low dpkg-reconfigure samba

Um das Samba Paket vollständig zu entfernen muss der --purge Schalter
beim "aptitude remove samba" gesetzt werden. Sonst bleiben die Antworten
in der Debconf-DB erhalten. Also

aptitude --purge remove samba samba-common

Kann mit

debconf-show samba

bzw mit

debconf-show samba-common

überprüft werden.

Das "purgen" also das Entfernen der Einträge in der Debconf-DB ist sehr
wichtig, wenn man das "preseeding" Testen will.

debconf-show --listowners

zeigt alle installierten Pakete an, die Einträge in der Debconf-DB
haben, debconf-show <Paketname> zeigt die Einträge für das Paket an.
Hier einige Beispiele:

Die Einstellungen des Installers:

debconf-show d-i
debian-installer/language: de
debian-installer/country: DE
debian-installer/keymap: de-latin1-nodeadkeys

Die installierten Profiles von simple-cdd:

debconf-show simple-cdd
simple-cdd/profiles: ARK45, ARK45_devel, ARK45_CD_build

Die installierten Sprachen:

debconf-show locales
* locales/default_environment_locale: de_DE.UTF-8
* locales/locales_to_be_generated: de_DE ISO-8859-1, de_DE.UTF-8 UTF-8,
de_DE@euro ISO-8859-15, en_US ISO-8859-1, en_US.ISO-8859-15
ISO-8859-15, en_US.UTF-8 UTF-8

Und um jetzt das vorher genannte Beispiel mit einer russischen GUI zu
ermöglichen, muss man hier "ru_RU.UTF-8" zusätzlich auswählen und dann:

LANG=ru_RU.UTF-8 dpkg-reconfigure debconf

Und schon kann der PC und die Anwendung (Schul-Server) russisch. Bei mir
geht das leider nicht so schnell. Das klappt dann, wenn das Template
dieser Frage auch russisch enthält.

Die Anworten in der Config.dat, werden immer mit LANG=C abgespeichert,
also amerikanisch mit einem 7-bit Zeichensatz.

debconf-get-selections |grep debconf/frontend
debconf debconf/frontend select Gnome

Wenn diese Ausgabe in einer preseed Datei benutzt wird, wird die
dazugehörige Frage nicht mehr angezeigt. Um ein Preseeding zu setzen,
aber dem Benutzer trotzdem die Möglichkeit zu geben sich anders zu
entscheiden, muss das "seen-Flag" für diese Frage auf false gesetzt
werden:

debconf debconf/frontend select Gnome
debconf debconf/frontend seen false

=== Frontends ===

* [[Delixs:Entwicklerhandbuch/Debconf/Frontends|Frontends für Debconf]]

== Beispiel für eine automatische Installation ==

Ein Hinweis noch zum leider oft nicht wahrgenommenen

<source lang=bash>
DEBIAN_FRONTEND=noninteractive
</source>
Damit kannst du einen Schwung Pakete ohne Nachfragen
installieren. Sofern du vorher die debconf Antworten
injiziert hast, verhalten sich die Dienst wie vorgesehen.

<source lang=bash>
#!/bin/sh
export DEBIAN_FRONTEND=noninteractive
SELECTIONFILE=/etc/delixs/package_selection.txt
# mit dpkg --get-selections erstellt, nur PURGE und INSTALL
SELECTIONFILELOCAL=/etc/delixs/package_selection.local.txt
SELECTIONARCHFILE=/etc/delixs/package_selection.${SERVER_ARCH}
PATH=$PATH:/sbin:/usr/sbin:/usr/local/sbin
# Paketliste aktualisieren
aptitude update
# Paketauswahl auf minimal zurücksetzen
dpkg --clear-selections
# globale Paket-Auswahl einlesen
dpkg --set-selections < $SELECTIONFILE
# Architektur Paket-Auswahl einlesen
test -s $SELECTIONARCHFILE && dpkg --set-selections < $SELECTIONARCHFILE
# ggf. lokale Paket-Auswahl einlesen
test -s $SELECTIONFILELOCAL && dpkg --set-selections <
$SELECTIONFILELOCAL
# Upgrade durchführen
aptitude --yes dselect-upgrade
aptitude dist-upgrade
# runtergeladene Pakete aufräumen
aptitude clean
</source>
Damit kannst du nach einer Minimalinstallation deine Pakete
ins System drücken, ohne dass du eine Nachfrage erhälst.

Stolperfalle: in der globalen Selections dürfen keine Architektur
abhängige Pakete stecken, die gehören in die jeweils zu erstellende
$SELECTIONARCHFILE. Beispiel dafür: kernel, kernel-module, libc6-$ARCH.
Die Variable SERVER_ARCH kann ich auf zwei Arten abfragen - entweder über den installierten kernel, oder über die Architektur des installierten Systems.
Beide müssen nicht übereinstimmen. (ein amd64 kernel vertrgät sich mit einem i386er Userland)

Hier die Variante über das installierte System:
<source lang="bash">
#!/bin/sh
ARCH=$(dpkg --print-architecture)
case "$ARCH" in
amd64)
export SERVER_ARCH=amd64
;;
i386)
export SERVER_ARCH=i386
;;
*)
export SERVER_ARCH=
# das darf nie passieren
logger "Die Architektur ist unbekannt (${PWD}/$0)"
;;
esac
echo $SERVER_ARCH
</source>
Hier die Variante über den laufenden kernel:
<source lang="bash">
[ -x /bin/uname ] && ARCH=$(uname -m) || logger -t delixs "uname\ (Paket: coreutils) fehlt, kein Softwareupdate moeglich."
case "$ARCH" in
i686)
export SERVER_ARCH=i386
;;
x86_64)
export SERVER_ARCH=amd64
;;
*)
export SERVER_ARCH=i386
# das darf nie passieren
logger -t delixs "Die Architektur stimmt nicht - ueberpreufe das dringend (${PWD}/$0)"
;;
esac
</source>

Evtl. hilft das an der ein oder anderen Stelle weiter. Auch wenn das beim Einsatz von tasks nicht zum Einsatz kommen muss/braucht.

== Weblinks ==

=== um Scripte in deb-Pakete zu packen: ===

* http://www.brummer.de.hm/buildpaket.html
* http://www.martin-bock.de/pc/pc-0101.html

=== schon "portierte" CPAN-Module suchen ===

* http://faq.perl-community.de/bin/view/Wissensbasis/ModuleWieInstalliereIchEinModul#Debian_GNU_Linux

=== CPAN-Module nach Deb-Pakete ===

* http://service.gmx.net/de/cgi/derefer?TYPE=3&DEST=http%3A%2F%2Fwww.blogator.de%2F2007%2F08%2F10%2Fperl-module-als-debian-paket-bauen%2F
* http://it.biologie.uni-muenchen.de/itg/knowhow/msg00028.html

----
<div align="right">[[Delixs:Entwicklerhandbuch|zurück]] | [[Hauptseite]]</div>

Entwicklerhandbuch/Paketbau

2010-02-02T06:52:54Z

ThorstenStrusch: /* Beispiel für eine automatische Installation */ syntax der Scripte auf bash gesetzt

__NOTOC__
{{Uberarbeiten}}

__TOC__

== debian Pakete konfigurieren: debconf ==

Das Einstiegsdokument um das Thema anzugehen, sollte

man 7 debconf

sein. Diese Manual-Seite ist verfügbar, wenn das Paket "debconf-doc"
installiert ist.

man debconf-devel

beschreibt ausführlich (ca. 13 DIN-A4 Seiten), wie man mit Debconf
programmiert. Natürlich in einer shell. Perl Programmierer sollten das
Paket "debaux-debconf" nach installieren.

In Debian wird fast alles in Manual-Seiten erklärt. Daher ist das Lesen
dieser Seiten für einen Entwickler unerlässlich. Manchmal will man aber
eine man-Seite nicht auf dem Schirm lesen, sondern als Papier-Ausdruck
neben sich liegen haben. Das geht mit diesem Kommando:

man -t debconf-devel | lpr -Plp0

Vorausgesetzt, man will die man Seite "debconf-devel" auf den lokalen
Drucker (Warteschlange) lp0 drucken. Zwischen dem großen P und dem
Drucker-Namen darf kein Leerzeichen sein. Der Drucker muss Postscript
können. Aber welcher Druckertreiber unter Linux kann das nicht?

=== Was ist "Debconf"? ===

Debconf ist ein Framework das dazu dient, Pakete bzw Programme zu
konfigurieren.

Es ist limitiert! Es ist keine Registry wie unter Windows. Debconf soll
nur dazu benutzt werden eine sinnvolle Grundkonfiguration der Pakete
einzustellen.

=== Woraus besteht Debconf? ===

Zunächst mal aus 2 Datenbanken. Eine enthält Fragen, die andere
Antworten. Wenn Fragen gestellt werden sollen, muss es auch eine
Möglichkeit geben, diese dem Benutzer zu präsentieren, dafür sind die
Frontends zuständig. Es gibt diverse Frontends. Bekannt dürfte
das "Dialog-Frontend" sein. Mein Favorit ist Gnome, KDE ist auch sehr
hübsch.

Jede Frage kann in jedem Frontend dargestellt werden! Für die Frontends
Gnome bzw KDE muss nicht zwingend Gnome und KDE installiert sein, eine
simple VGA-Grafik mit VESA ist ausreichend.

'''praktisches Beispiel:''' Du hast ein installiertes Debian mit X-Window (die ADE reicht aus, auch
wenn sie weder Gnome noch KDE hat). Knoppix oder Suse tuts auch. Selbst
Windows, wenn denn cygwin installiert ist.

In einem X-Terminal Fenster ( Du bist ein normaler User, nicht root)
gibst Du ein:

xhost +

Das ermöglicht allen lokalen Usern (dies gilt nur für Debian, nicht für
andere Linuxe) X-Windows Anwendungen auf Deinem X-Server zu starten.

Um die verschiedenen Frontends zu Testen, gibt man folgendes sein

su -
export DISPLAY=:0.0

Das aktuelle Frontend:

dpkg-reconfigure debconf

Das Dialog Interface. Nennt sich "dialog" ist aber "whiptail" und damit
also nicht Aufruf-kompatibel zu "dialog".

DEBIAN_FRONTEND=dialog dpkg-reconfigure debconf

Die beiden grafischen Frontends

DEBIAN_FRONTEND=gnome dpkg-reconfigure debconf
DEBIAN_FRONTEND=kde dpkg-reconfigure debconf

Das Editor Interface mit dem allseits beliebten Editor mcedit:

DEBIAN_FRONTEND=editor EDITOR=mcedit dpkg-reconfigure debconf

Der mcedit ist im Paket mc enthalten. Im Zweifel also ein

aptitude install mc

durchführen.

Die Debconf Fragen sind multi-lingual. Wenn man eine Sprache wählen
will, muss die Variable LANG angepasst werden, z.B.:

LANG=C dpkg-reconfigure debconf

oder für russisch, sofern installiert

LANG=ru dpkg-reconfigure debconf

Verfügbare Sprachen, eigentlich verfügbare Schriften, kann man erfragen
mit:

locale -a

Zurück zu Debconf, ein wichtiges Kommando ist:

debconf-show

Ohne Parameter gibt es die Aufruf-Syntax auf. Mit

debconf-show debconf

kann man sich anzeigen lassen, wie das Paket "debconf" konfiguriert ist.
Bei mir sieht das so aus:

debconf-show debconf
debconf-apt-progress/preparing:
debconf-apt-progress/title:
debconf-apt-progress/info:
debconf-apt-progress/media-change:
* debconf/frontend: Gnome
* debconf/priority: medium

In der Antwort-DB von Debconf steht also zu dem Paket "debconf"
folgendes drin:

frontend: Gnome
priority: medium

In der obigen Ausgabe von debconf-show haben nur zwei von sechs Fragen
eine Antwort hinterlegt (die beiden mit dem '*' am Anfang.

Die Debconf Datenbanken sind ASCII DBs und liegen
unter /var/cache/debconf. Eine Anfrage an die Antwort-DB mit grep,
ergibt dies:

grep 'debconf/frontend' /var/cache/debconf/config.dat
Name: debconf/frontend
Template: debconf/frontend

Wo ist der Wert "Gnome" geblieben? Hier:

grep -A 1 'debconf/frontend' /var/cache/debconf/config.dat
Name: debconf/frontend
Template: debconf/frontend
Value: Gnome

Er steht im Feld "Value" eine Zeile tiefer.

Dafür gibt es natürlich auch ein Tool,

debconf-get-selections |grep debconf/frontend
debconf debconf/frontend select Gnome

Die Ausgabe sieht hier etwas anders aus, aber das Resultat ist dasselbe.
Die Ausgabe von "debconf-get-selections" ist geeignet, um sie in einer
preseed-Datei weiter zu benutzen.

Nicht immer werden alle Fragen, die hinterlegt sind, auch angezeigt. Das
wird primär mit dem Schalter "DEBIAN_PRIORITY" gesteuert:

Installieren wir zunächst mal ein Paket, bei dem sich das gut
demonstrieren lässt: samba

aptitude install samba

Nun die Prioritäten testen:

DEBIAN_PRIORITY=high dpkg-reconfigure samba
DEBIAN_PRIORITY=medium dpkg-reconfigure samba
DEBIAN_PRIORITY=low dpkg-reconfigure samba

Um das Samba Paket vollständig zu entfernen muss der --purge Schalter
beim "aptitude remove samba" gesetzt werden. Sonst bleiben die Antworten
in der Debconf-DB erhalten. Also

aptitude --purge remove samba samba-common

Kann mit

debconf-show samba

bzw mit

debconf-show samba-common

überprüft werden.

Das "purgen" also das Entfernen der Einträge in der Debconf-DB ist sehr
wichtig, wenn man das "preseeding" Testen will.

debconf-show --listowners

zeigt alle installierten Pakete an, die Einträge in der Debconf-DB
haben, debconf-show <Paketname> zeigt die Einträge für das Paket an.
Hier einige Beispiele:

Die Einstellungen des Installers:

debconf-show d-i
debian-installer/language: de
debian-installer/country: DE
debian-installer/keymap: de-latin1-nodeadkeys

Die installierten Profiles von simple-cdd:

debconf-show simple-cdd
simple-cdd/profiles: ARK45, ARK45_devel, ARK45_CD_build

Die installierten Sprachen:

debconf-show locales
* locales/default_environment_locale: de_DE.UTF-8
* locales/locales_to_be_generated: de_DE ISO-8859-1, de_DE.UTF-8 UTF-8,
de_DE@euro ISO-8859-15, en_US ISO-8859-1, en_US.ISO-8859-15
ISO-8859-15, en_US.UTF-8 UTF-8

Und um jetzt das vorher genannte Beispiel mit einer russischen GUI zu
ermöglichen, muss man hier "ru_RU.UTF-8" zusätzlich auswählen und dann:

LANG=ru_RU.UTF-8 dpkg-reconfigure debconf

Und schon kann der PC und die Anwendung (Schul-Server) russisch. Bei mir
geht das leider nicht so schnell. Das klappt dann, wenn das Template
dieser Frage auch russisch enthält.

Die Anworten in der Config.dat, werden immer mit LANG=C abgespeichert,
also amerikanisch mit einem 7-bit Zeichensatz.

debconf-get-selections |grep debconf/frontend
debconf debconf/frontend select Gnome

Wenn diese Ausgabe in einer preseed Datei benutzt wird, wird die
dazugehörige Frage nicht mehr angezeigt. Um ein Preseeding zu setzen,
aber dem Benutzer trotzdem die Möglichkeit zu geben sich anders zu
entscheiden, muss das "seen-Flag" für diese Frage auf false gesetzt
werden:

debconf debconf/frontend select Gnome
debconf debconf/frontend seen false

=== Frontends ===

* [[Delixs:Entwicklerhandbuch/Debconf/Frontends|Frontends für Debconf]]

== Beispiel für eine automatische Installation ==

Ein Hinweis noch zum leider oft nicht wahrgenommenen

<source lang=bash>
DEBIAN_FRONTEND=noninteractive
</source>
Damit kannst du einen Schwung Pakete ohne Nachfragen
installieren. Sofern du vorher die debconf Antworten
injiziert hast, verhalten sich die Dienst wie vorgesehen.

<source lang=bash>
#!/bin/sh
export DEBIAN_FRONTEND=noninteractive
SELECTIONFILE=/etc/delixs/package_selection.txt
# mit dpkg --get-selections erstellt, nur PURGE und INSTALL
SELECTIONFILELOCAL=/etc/delixs/package_selection.local.txt
SELECTIONARCHFILE=/etc/delixs/package_selection.${SERVER_ARCH}
PATH=$PATH:/sbin:/usr/sbin:/usr/local/sbin
# Paketliste aktualisieren
aptitude update
# Paketauswahl auf minimal zurücksetzen
dpkg --clear-selections
# globale Paket-Auswahl einlesen
dpkg --set-selections < $SELECTIONFILE
# Architektur Paket-Auswahl einlesen
test -s $SELECTIONARCHFILE && dpkg --set-selections < $SELECTIONARCHFILE
# ggf. lokale Paket-Auswahl einlesen
test -s $SELECTIONFILELOCAL && dpkg --set-selections <
$SELECTIONFILELOCAL
# Upgrade durchführen
aptitude --yes dselect-upgrade
aptitude dist-upgrade
# runtergeladene Pakete aufräumen
aptitude clean
</source>
Damit kannst du nach einer Minimalinstallation deine Pakete
ins System drücken, ohne dass du eine Nachfrage erhälst.

Stolperfalle: in der globalen Selections dürfen keine Architektur
abhängige Pakete stecken, die gehören in die jeweils zu erstellende
$SELECTIONARCHFILE. Beispiel dafür: kernel, kernel-module, libc6-$ARCH.
Die Variable SERVER_ARCH kann ich auf zwei Arten abfragen - entweder über den installierten kernel, oder über die Architektur des installierten Systems.
Beide müssen nicht übereinstimmen. (ein amd64 kernel vertrgät sich mit einem i386er Userland)

Hier die Variante über das installierte System:
<source lang="bash">
#!/bin/sh
ARCH=$(dpkg --print-architecture)
case "$ARCH" in
amd64)
export SERVER_ARCH=amd64
;;
i386)
export SERVER_ARCH=i386
;;
*)
export SERVER_ARCH=
# das darf nie passieren
logger "Die Architektur ist unbekannt (${PWD}/$0)"
;;
esac
echo $SERVER_ARCH
</source>
Hier die Variante über den laufenden kernel:
<source lang="bash">
[ -x /bin/uname ] && ARCH=$(uname -m) || logger -t delixs "uname\ (Paket: coreutils) fehlt, kein Softwareupdate moeglich."
case "$ARCH" in
i686)
export SERVER_ARCH=i386
;;
x86_64)
export SERVER_ARCH=amd64
;;
*)
export SERVER_ARCH=i386
# das darf nie passieren
logger -t delixs "Die Architektur stimmt nicht - ueberpreufe das dringend (${PWD}/$0)"
;;
esac
</source>

Evtl. hilft das an der ein oder anderen Stelle weiter. Auch wenn das beim Einsatz von tasks nicht zum Einsatz kommen muss/braucht.

== Weblinks ==

=== um Scripte in deb-Pakete zu packen: ===

* http://www.brummer.de.hm/buildpaket.html
* http://www.martin-bock.de/pc/pc-0101.html

=== schon "portierte" CPAN-Module suchen ===

* http://faq.perl-community.de/bin/view/Wissensbasis/ModuleWieInstalliereIchEinModul#Debian_GNU_Linux

=== CPAN-Module nach Deb-Pakete ===

* http://service.gmx.net/de/cgi/derefer?TYPE=3&DEST=http%3A%2F%2Fwww.blogator.de%2F2007%2F08%2F10%2Fperl-module-als-debian-paket-bauen%2F
* http://it.biologie.uni-muenchen.de/itg/knowhow/msg00028.html

----
<div align="right">[[Delixs:Entwicklerhandbuch|zurück]] | [[Hauptseite]]</div>

Entwicklerhandbuch/Paketbau

2010-02-02T06:50:53Z

ThorstenStrusch: Architektur abfragen über Userland und kernel möglich. Das Ergebnis kann unterschiedlich sein

__NOTOC__
{{Uberarbeiten}}

__TOC__

== debian Pakete konfigurieren: debconf ==

Das Einstiegsdokument um das Thema anzugehen, sollte

man 7 debconf

sein. Diese Manual-Seite ist verfügbar, wenn das Paket "debconf-doc"
installiert ist.

man debconf-devel

beschreibt ausführlich (ca. 13 DIN-A4 Seiten), wie man mit Debconf
programmiert. Natürlich in einer shell. Perl Programmierer sollten das
Paket "debaux-debconf" nach installieren.

In Debian wird fast alles in Manual-Seiten erklärt. Daher ist das Lesen
dieser Seiten für einen Entwickler unerlässlich. Manchmal will man aber
eine man-Seite nicht auf dem Schirm lesen, sondern als Papier-Ausdruck
neben sich liegen haben. Das geht mit diesem Kommando:

man -t debconf-devel | lpr -Plp0

Vorausgesetzt, man will die man Seite "debconf-devel" auf den lokalen
Drucker (Warteschlange) lp0 drucken. Zwischen dem großen P und dem
Drucker-Namen darf kein Leerzeichen sein. Der Drucker muss Postscript
können. Aber welcher Druckertreiber unter Linux kann das nicht?

=== Was ist "Debconf"? ===

Debconf ist ein Framework das dazu dient, Pakete bzw Programme zu
konfigurieren.

Es ist limitiert! Es ist keine Registry wie unter Windows. Debconf soll
nur dazu benutzt werden eine sinnvolle Grundkonfiguration der Pakete
einzustellen.

=== Woraus besteht Debconf? ===

Zunächst mal aus 2 Datenbanken. Eine enthält Fragen, die andere
Antworten. Wenn Fragen gestellt werden sollen, muss es auch eine
Möglichkeit geben, diese dem Benutzer zu präsentieren, dafür sind die
Frontends zuständig. Es gibt diverse Frontends. Bekannt dürfte
das "Dialog-Frontend" sein. Mein Favorit ist Gnome, KDE ist auch sehr
hübsch.

Jede Frage kann in jedem Frontend dargestellt werden! Für die Frontends
Gnome bzw KDE muss nicht zwingend Gnome und KDE installiert sein, eine
simple VGA-Grafik mit VESA ist ausreichend.

'''praktisches Beispiel:''' Du hast ein installiertes Debian mit X-Window (die ADE reicht aus, auch
wenn sie weder Gnome noch KDE hat). Knoppix oder Suse tuts auch. Selbst
Windows, wenn denn cygwin installiert ist.

In einem X-Terminal Fenster ( Du bist ein normaler User, nicht root)
gibst Du ein:

xhost +

Das ermöglicht allen lokalen Usern (dies gilt nur für Debian, nicht für
andere Linuxe) X-Windows Anwendungen auf Deinem X-Server zu starten.

Um die verschiedenen Frontends zu Testen, gibt man folgendes sein

su -
export DISPLAY=:0.0

Das aktuelle Frontend:

dpkg-reconfigure debconf

Das Dialog Interface. Nennt sich "dialog" ist aber "whiptail" und damit
also nicht Aufruf-kompatibel zu "dialog".

DEBIAN_FRONTEND=dialog dpkg-reconfigure debconf

Die beiden grafischen Frontends

DEBIAN_FRONTEND=gnome dpkg-reconfigure debconf
DEBIAN_FRONTEND=kde dpkg-reconfigure debconf

Das Editor Interface mit dem allseits beliebten Editor mcedit:

DEBIAN_FRONTEND=editor EDITOR=mcedit dpkg-reconfigure debconf

Der mcedit ist im Paket mc enthalten. Im Zweifel also ein

aptitude install mc

durchführen.

Die Debconf Fragen sind multi-lingual. Wenn man eine Sprache wählen
will, muss die Variable LANG angepasst werden, z.B.:

LANG=C dpkg-reconfigure debconf

oder für russisch, sofern installiert

LANG=ru dpkg-reconfigure debconf

Verfügbare Sprachen, eigentlich verfügbare Schriften, kann man erfragen
mit:

locale -a

Zurück zu Debconf, ein wichtiges Kommando ist:

debconf-show

Ohne Parameter gibt es die Aufruf-Syntax auf. Mit

debconf-show debconf

kann man sich anzeigen lassen, wie das Paket "debconf" konfiguriert ist.
Bei mir sieht das so aus:

debconf-show debconf
debconf-apt-progress/preparing:
debconf-apt-progress/title:
debconf-apt-progress/info:
debconf-apt-progress/media-change:
* debconf/frontend: Gnome
* debconf/priority: medium

In der Antwort-DB von Debconf steht also zu dem Paket "debconf"
folgendes drin:

frontend: Gnome
priority: medium

In der obigen Ausgabe von debconf-show haben nur zwei von sechs Fragen
eine Antwort hinterlegt (die beiden mit dem '*' am Anfang.

Die Debconf Datenbanken sind ASCII DBs und liegen
unter /var/cache/debconf. Eine Anfrage an die Antwort-DB mit grep,
ergibt dies:

grep 'debconf/frontend' /var/cache/debconf/config.dat
Name: debconf/frontend
Template: debconf/frontend

Wo ist der Wert "Gnome" geblieben? Hier:

grep -A 1 'debconf/frontend' /var/cache/debconf/config.dat
Name: debconf/frontend
Template: debconf/frontend
Value: Gnome

Er steht im Feld "Value" eine Zeile tiefer.

Dafür gibt es natürlich auch ein Tool,

debconf-get-selections |grep debconf/frontend
debconf debconf/frontend select Gnome

Die Ausgabe sieht hier etwas anders aus, aber das Resultat ist dasselbe.
Die Ausgabe von "debconf-get-selections" ist geeignet, um sie in einer
preseed-Datei weiter zu benutzen.

Nicht immer werden alle Fragen, die hinterlegt sind, auch angezeigt. Das
wird primär mit dem Schalter "DEBIAN_PRIORITY" gesteuert:

Installieren wir zunächst mal ein Paket, bei dem sich das gut
demonstrieren lässt: samba

aptitude install samba

Nun die Prioritäten testen:

DEBIAN_PRIORITY=high dpkg-reconfigure samba
DEBIAN_PRIORITY=medium dpkg-reconfigure samba
DEBIAN_PRIORITY=low dpkg-reconfigure samba

Um das Samba Paket vollständig zu entfernen muss der --purge Schalter
beim "aptitude remove samba" gesetzt werden. Sonst bleiben die Antworten
in der Debconf-DB erhalten. Also

aptitude --purge remove samba samba-common

Kann mit

debconf-show samba

bzw mit

debconf-show samba-common

überprüft werden.

Das "purgen" also das Entfernen der Einträge in der Debconf-DB ist sehr
wichtig, wenn man das "preseeding" Testen will.

debconf-show --listowners

zeigt alle installierten Pakete an, die Einträge in der Debconf-DB
haben, debconf-show <Paketname> zeigt die Einträge für das Paket an.
Hier einige Beispiele:

Die Einstellungen des Installers:

debconf-show d-i
debian-installer/language: de
debian-installer/country: DE
debian-installer/keymap: de-latin1-nodeadkeys

Die installierten Profiles von simple-cdd:

debconf-show simple-cdd
simple-cdd/profiles: ARK45, ARK45_devel, ARK45_CD_build

Die installierten Sprachen:

debconf-show locales
* locales/default_environment_locale: de_DE.UTF-8
* locales/locales_to_be_generated: de_DE ISO-8859-1, de_DE.UTF-8 UTF-8,
de_DE@euro ISO-8859-15, en_US ISO-8859-1, en_US.ISO-8859-15
ISO-8859-15, en_US.UTF-8 UTF-8

Und um jetzt das vorher genannte Beispiel mit einer russischen GUI zu
ermöglichen, muss man hier "ru_RU.UTF-8" zusätzlich auswählen und dann:

LANG=ru_RU.UTF-8 dpkg-reconfigure debconf

Und schon kann der PC und die Anwendung (Schul-Server) russisch. Bei mir
geht das leider nicht so schnell. Das klappt dann, wenn das Template
dieser Frage auch russisch enthält.

Die Anworten in der Config.dat, werden immer mit LANG=C abgespeichert,
also amerikanisch mit einem 7-bit Zeichensatz.

debconf-get-selections |grep debconf/frontend
debconf debconf/frontend select Gnome

Wenn diese Ausgabe in einer preseed Datei benutzt wird, wird die
dazugehörige Frage nicht mehr angezeigt. Um ein Preseeding zu setzen,
aber dem Benutzer trotzdem die Möglichkeit zu geben sich anders zu
entscheiden, muss das "seen-Flag" für diese Frage auf false gesetzt
werden:

debconf debconf/frontend select Gnome
debconf debconf/frontend seen false

=== Frontends ===

* [[Delixs:Entwicklerhandbuch/Debconf/Frontends|Frontends für Debconf]]

== Beispiel für eine automatische Installation ==

Ein Hinweis noch zum leider oft nicht wahrgenommenen

DEBIAN_FRONTEND=noninteractive

Damit kannst du einen Schwung Pakete ohne Nachfragen
installieren. Sofern du vorher die debconf Antworten
injiziert hast, verhalten sich die Dienst wie vorgesehen.

#!/bin/sh
export DEBIAN_FRONTEND=noninteractive
SELECTIONFILE=/etc/delixs/package_selection.txt
# mit dpkg --get-selections erstellt, nur PURGE und INSTALL
SELECTIONFILELOCAL=/etc/delixs/package_selection.local.txt
SELECTIONARCHFILE=/etc/delixs/package_selection.${SERVER_ARCH}
PATH=$PATH:/sbin:/usr/sbin:/usr/local/sbin
# Paketliste aktualisieren
aptitude update
# Paketauswahl auf minimal zurücksetzen
dpkg --clear-selections
# globale Paket-Auswahl einlesen
dpkg --set-selections < $SELECTIONFILE
# Architektur Paket-Auswahl einlesen
test -s $SELECTIONARCHFILE && dpkg --set-selections < $SELECTIONARCHFILE
# ggf. lokale Paket-Auswahl einlesen
test -s $SELECTIONFILELOCAL && dpkg --set-selections <
$SELECTIONFILELOCAL
# Upgrade durchführen
aptitude --yes dselect-upgrade
aptitude dist-upgrade
# runtergeladene Pakete aufräumen
aptitude clean

Damit kannst du nach einer Minimalinstallation deine Pakete
ins System drücken, ohne dass du eine Nachfrage erhälst.

Stolperfalle: in der globalen Selections dürfen keine Architektur
abhängige Pakete stecken, die gehören in die jeweils zu erstellende
$SELECTIONARCHFILE. Beispiel dafür: kernel, kernel-module, libc6-$ARCH.
Die Variable SERVER_ARCH kann ich auf zwei Arten abfragen - entweder über den installierten kernel, oder über die Architektur des installierten Systems.
Beide müssen nicht übereinstimmen. (ein amd64 kernel vertrgät sich mit einem i386er Userland)

Hier die Variante über das installierte System:
<source lang="bash">
#!/bin/sh

ARCH=$(dpkg --print-architecture)
case "$ARCH" in
amd64)
export SERVER_ARCH=amd64
;;
i386)
export SERVER_ARCH=i386
;;
*)
export SERVER_ARCH=
# das darf nie passieren
logger "Die Architektur ist unbekannt (${PWD}/$0)"
;;
esac
echo $SERVER_ARCH
</source>
Hier die Variante über den laufenden kernel:
<source lang="bash">
[ -x /bin/uname ] && ARCH=$(uname -m) || logger -t delixs "uname\ (Paket: coreutils) fehlt, kein Softwareupdate moeglich."
case "$ARCH" in
i686)
export SERVER_ARCH=i386
;;
x86_64)
export SERVER_ARCH=amd64
;;
*)
export SERVER_ARCH=i386
# das darf nie passieren
logger -t delixs "Die Architektur stimmt nicht - ueberpreufe das dringend (${PWD}/$0)"
;;
esac
</source>

Evtl. hilft das an der ein oder anderen Stelle weiter. Auch wenn das beim Einsatz von tasks nicht zum Einsatz kommen muss/braucht.

== Weblinks ==

=== um Scripte in deb-Pakete zu packen: ===

* http://www.brummer.de.hm/buildpaket.html
* http://www.martin-bock.de/pc/pc-0101.html

=== schon "portierte" CPAN-Module suchen ===

* http://faq.perl-community.de/bin/view/Wissensbasis/ModuleWieInstalliereIchEinModul#Debian_GNU_Linux

=== CPAN-Module nach Deb-Pakete ===

* http://service.gmx.net/de/cgi/derefer?TYPE=3&DEST=http%3A%2F%2Fwww.blogator.de%2F2007%2F08%2F10%2Fperl-module-als-debian-paket-bauen%2F
* http://it.biologie.uni-muenchen.de/itg/knowhow/msg00028.html

----
<div align="right">[[Delixs:Entwicklerhandbuch|zurück]] | [[Hauptseite]]</div>

Entwicklerhandbuch/Paketverwaltung

2009-12-21T22:47:04Z

ThorstenStrusch: /* ssh Clientkonfiguration */ die richtigen Rechte auf dem privaten key sind wichtig.

__NOTOC__
{{ZumTest}}

== Paketverwaltung mit dput, mini-dinstall und svn-buildpackage ==
=== Einführung ===

Installiere auf deinem debian/lenny Rechner die entsprechenden Pakete mit den folgenden Befehl:

<source lang="bash">
aptitude install dput mini-dinstall svn-buildpackage devscripts openssh-client
</source>

Arbeitest du unter gnome:

<source lang="bash">
aptitude install ssh-askpass-gnome
</source>

Arbeitest du unter kde:

<source lang="bash">
aptitude install ssh-askpass
</source>

=== svn-buildpackage ===

Mit svn-buildpackage hast du die Möglichkeit debian Pakete
(die wir im SVN vohalten) für die entspr. Architekturen zu bauen.
Wir möchten i386 und amd64 unterstützen.
Es werden dabei binäre Debianpakete und source-Pakete erstellt.

Erstere erkennst du an der Dateiendung .deb, letztere bestehen aus
zwei Dateien. Eine endet auf dsc, die andere auf tar.gz.

Die source-Pakete kannst du herunterladen, wenn du in deiner
sources.list eine Zeile mit deb-src am Anfang stehen hast.
Die binären Dateien kannst du herunterladen, wenn du deb als
erstes Argument in der Zeile stehen hast.

svn-buildpackage erstellt ausserdem zu jedem Paket eine
<nowiki>$PAKETNAME_$VERSION-$UNTERVERSION_$ARCHITEKTUR.changes</nowiki> Datei.
(z.B. delixs-firstrun-config_0.1-58_all.deb)
Mit dieser Datei kann dput arbeiten.

'''INFO:'''
Zum Erstellen eines debian-Pakets sollten wir also nicht mehr
<code>fakeroot ./debian/rules binary</code> nutzen. Hierbei wird weder
die changes Datei noch die source-Dateien erstellt. Lasst uns also
wie später unten beschrieben mit dem alias svn-b arbeiten.

=== dput ===

Dieses Programm ermöglicht es die binär- und source-Pakete in ein
debian Repository zu laden. Also auf solche 'Server', die du in der
/etc/apt/sources.list als Installationsquellen eintragen kannst.

dput unterstützt dabei mehrere Verfahren zum Hochladen, die wichtigsten
sind ftp,ssh/sftp und lokales Kopieren.

=== mini-dinstall ===

dieses Programm erzeugt nun ein Repository mit allen Schickanen:

<source lang="bash">
$\tree
|-- delixs1
| |-- all
| | |-- Packages
| | |-- Packages.bz2
| | |-- Packages.gz
| | `-- Release
| |-- all.db
| |-- amd64
| | |-- Packages
| | |-- Packages.bz2
| | |-- Packages.gz
| | `-- Release
| |-- amd64.db
| |-- i386
| | |-- Packages
| | |-- Packages.bz2
| | |-- Packages.gz
| | `-- Release
| |-- i386.db
| `-- source
| |-- Sources
| |-- Sources.bz2
| `-- Sources.gz
</source>

* unter delixs/all liegen die architekturunabhängigen binären debian-Pakete (debs)
* unter delixs/amd64 liegen die binären amd64 debian-Pakete (debs)
* unter delixs/i386 liegen die binären i386 debian-Pakete (debs)
* unter source liegen alle Versionen dieser Pakete im source-Format. Jeweils eine dsc und eine tar.gz Datei

== apt-Konfiguration ==

Um jetzt auch mit den frisch erstellten Repositories arbeiten zu können, sind zwei Dateien notwendig, die im Folgenden beschrieben werden.

Der Ausdruck $(ARCH) bewirkt, dass apt sich die PC Architektur selbst sucht. Das delixs-Projekt unterstützt i386 und amd64.

=== lokales Repository aktivieren ===

Erstelle eine Datei /etc/apt/sources.list.d/file.list wie unten angegeben:

<source lang="apt_sources">
cat /etc/apt/sources.list.d/file.list

deb file:/home/thorsten/public_html/debian aramec/all
deb file:/home/thorsten/public_html/debian aramec/$(ARCH)/
deb-src file:/home/thorsten/public_html/debian aramec/source/
</source>

Als root führe <code>aptitude update</code> durch und das Repository ist eingebunden und einsatzfähig.

=== offizielles Repository aktivieren ===

Erstelle eine Datei /etc/apt/sources.list.d/delixs.list wie unten angegeben:

<source lang="apt_sources">
cat /etc/apt/sources.list.d/aramec.list

deb file:/home/thorsten/public_html/debian aramec/all
deb file:/home/thorsten/public_html/debian aramec/$(ARCH)/
deb-src file:/home/thorsten/public_html/debian aramec/source/
</source>

Als root führe <code>aptitude update</code> durch und das Repository ist zwar eingebunden aber wegen eines noch nicht bekannten GPG-Schlüssels wird ihm nicht vertraut.

=== gpg Schlüssel importieren ===

'''XXX''' wird noch im Detail beschrieben
* manuell mit wget http://deb.delixs.de/debian/keyring.asc
* automatisch mittels aptitude install delixs-archive-keyring

== Konfiguration ==
=== alias svn-b ===

Wenn du ein Paket bauen und hochladen möchtest, rufst du dafür i.A. svn-buildpackage auf. Folgenden alias solltest du in deine ~/.bashrc packen:

<source lang="bash">
alias svn-b="svn-buildpackage -us -uc -rfakeroot --svn-ignore"
</source>

Damit reicht ein '''svn-b''' zum Bauen des Pakets. Es wird dann eine Ebene höher im Order '''build-area''' liegen.

== der Benutzer dupload ==

=== dput Konfiguration ===

Mit der folgenden Konfiguration kennt dput zwei Ziele für den Paketupload

# local - deinen Rechner
# delixs - unser offizielles delixs-Repository

<source lang="properties">
$ cat ~/.dput.cf
[local]
method = local
hostname = localhost
incoming = ~/public_html/debian/mini-dinstall/incoming
run_dinstall = 0
allow_unsigned_uploads = 0
verify_sigs = 1
post_upload_command = /usr/bin/mini-dinstall --batch

[delixs]
fqdn = deb.delixs.de
method = scp
login = dupload
incoming = ./incoming
run_dinstall = 0
allow_unsigned_uploads = 0
verify_sigs = 1
</source>

=== mini-dinstall Konfiguration ===

mini-dinstall soll mir ein Repository unter ~/public_html/delixs/ anlegen. Dafür ist folgende Konfiguration nötig:

<source lang="properties">
$ cat ~/.mini-dinstall.conf
# Adapted Colin's mini-dinstall.conf
# Infos unter /usr/share/doc/dput
# und http://debiananwenderhandbuch.de/mini-dinstall.html
[DEFAULT]
architectures = all, i386, amd64
archivedir = ~/public_html/delixs/
use_dnotify = 0
verify_sigs = 0
#extra_keyrings = ~/.gnupg/pubring.gpg
mail_on_success = 0
archive_style = simple-subdir
poll_time = 10
mail_log_level = NONE
generate_release = 1
release_description = delixs Packages
# Releases:
[aramec]
[testing]
</source>

=== ssh Clientkonfiguration ===

Damit dput beim Hochladen auf den dev-server (deb.delixs.de) sich gleich mit den korrekten Einstellugnen wie dem Benutzer verbindet, leg dir die Datei ~/.ssh/config mit folgendem Inhalt an:

<source lang="bash">
host deb.delixs.de
CheckHostIP no
User dupload
Ciphers arcfour
Protocol 2
IdentityFile ~/.ssh/id_dsa.dupload
</source>

Die Datei id_dsa.dupload bekommst du per Mail zugeschickt. Die Rechte müssen bei dem privaten key auf 0640 gesetzt werden.
Wenn der key für alle lesbar ist (z.B. 0644), dann funktioniert der Upload nicht, da der key zurückgewiesen wird.

=== gpg-Schlüssel ===

Wenn du Pakete auf den dev-Server lädst, muss die Release Datei mit gpg signiert werden. Ansonsten würde jeder Server, der dieses Repository nutzt, über ein unsicheres Archiv meckern.

Darum musst du dich hier nicht kümmern, das erzeugt das Programm mini-dinstall auf dem Server. Bei dir im lokalen Repository brauchst du den Aufwand nicht treiben, lokal verfügbare Release-Dateien müssen nicht signiert werden.

== Beispiel ==

Nachfolgend ein Beispiel, wo ich das (nicht existierende) Paket delixs-firstrun-config
in der Version 0.1-58 in das lokale Repository hochlade. Am Ende wird automatisch mini-dinstall ausgeführt.

<source lang="bash">
$ dput local delixs-firstrun-config_0.1-58_i3864.changes
$ \tree ~/public_html/debian/delixs1/
/home/thorsten/public_html/debian/delixs1/
|-- all
| |-- Packages
| |-- Packages.bz2
| |-- Packages.gz
| |-- Release
| `-- delixs-firstrun-config_0.1-58_all.deb
|-- all.db
|-- amd64
| |-- Packages
| |-- Packages.bz2
| |-- Packages.gz
| `-- Release
|-- amd64.db
|-- i386
| |-- Packages
| |-- Packages.bz2
| |-- Packages.gz
| `-- Release
|-- i386.db
|-- delixs-firstrun-config_0.1-58_i386.changes
`-- source
|-- Sources
|-- Sources.bz2
|-- Sources.gz
|-- delixs-firstrun-config_0.1-58.dsc
`-- delixs-firstrun-config_0.1-58.tar.gz

</source>

'''Erklärung:'''
* Unter all liegt das architekturunabhängige Paket delixs-firstrun-config_0.1-58_all.deb
* direkt im Ordner delixs1 liegt die changes-Datei.
* unter source liegen die beiden Dateien delixs-firstrun-config_0.1-58.{dsc,tar-gz}

Im Ordner, von dem du das Paket hochgeladen hast (wahrscheinlich build-area), wurde die Datei
delixs-firstrun-config_0.1-58_i386.upload angelegt. Der Inhalt:

<source lang="bash">
$ cat delixs-firstrun-config_0.1-58_i386.upload
Successfully uploaded delixs-firstrun-config_0.1-58.dsc to localhost.
Successfully uploaded delixs-firstrun-config_0.1-58.tar.gz to localhost.
Successfully uploaded delixs-firstrun-config_0.1-58_all.deb to localhost.
Successfully uploaded delixs-firstrun-config_0.1-58_i386.changes to localhost.
</source>

Durch dieses logfile weis dput, dass es die Datei nicht nochmal hochladen muss, wenn du es ein zweites Mal probieren solltest.

== Weblinks ==

* [http://wiki.debianforum.de/EigenesRepository wiki.debianforum.de/EigenesRepository]

----
<div align="right">[[Entwicklerhandbuch|zurück]] | [[Hauptseite]]</div>

Thorsten Strusch 2009

Entwicklerhandbuch/Repositorieverwaltung

2009-11-19T21:43:51Z

ThorstenStrusch: /* scp-chroot */ sftp -> scp

__NOTOC__
{{Uberarbeiten}}

'''Auf dieser Seite wird das Setup des dev-servers beschrieben. Möglicherweise gehört diese Seite ins trac!'''

= Funktionsweise =

Der Benutzer '''dupload''' hat über die sshd_config ein chroot unterhalb von ''$REPOSITORYROOT/mini-dinstall/incoming'' und darf nur scp benutzen. Ein login ist ausschliesslich über einen ssh-key möglich.

incron überwacht das Repository auf eine .changes-Datei und stößt nach einem ''"IN_MODIFY,IN_CREATE"'' das Script mini-dinstall --batch aus.
Die Pakete werden daraufhin einsortiert und die Releases signiert.

= Aufbau des Repositories =

* URL: deb.delixs.de
* aramec für den 1. Wurf
* delixs1 für lenny als Unterbau
* delixs2 für squeezy als Unterbau

= Konfigurationen =

Nachfolgend Vorschläge über die Konfigurationsdateien der beteiligten Dienste

== Apache ==
die Datei /etc/apache2/sites-available/deb.delixs.de
<source lang="apache">
<VirtualHost *:80>
ServerAdmin webmaster@delixs.de
ServerName deb.delixs.de
DocumentRoot /home/deb.delixs.de/

ErrorLog /var/log/apache2/error.log

# Possible values include: debug, info, notice, warn, error, crit,
# alert, emerg.
LogLevel warn

CustomLog /var/log/apache2/access.log combined
ServerSignature On

</VirtualHost>
</source>

== mini-dinstall ==

Pfad wo das Repository auf dem dev-Server liegt: '''/home/deb.delixs.de'''

<source lang="properties">
$ cat /home/$USER/.mini-dinstall.conf
# Adapted Colin's mini-dinstall.conf
# Infos unter /usr/share/doc/dput
# und http://debiananwenderhandbuch.de/mini-dinstall.html
[DEFAULT]
architectures = all, i386
archivedir = /home/deb.delixs.de/delixs/
use_dnotify = 0
verify_sigs = 0
extra_keyrings = ~/.gnupg/pubring.gpg
mail_on_success = 1
archive_style = simple-subdir
poll_time = 10
mail_log_level = NONE
generate_release = 1
release_description = delixs Packages
# Releases:
[aramec]
[testing]
</source>

== Benutzer dupload ==

Um nicht allen Entwicklern einen ssh-login auf dem dev-server geben zu müssen, legen wir den Benutzer dupload ''(debian-upload)'' ein.
In seinem Heimverzeichnis ist der Ordner incoming, auf den ein links von mini-dinstall/ioncoming zeigt.
Für ihn lassen wir ausschliesslich einen Zugang per ssh-key zu.

Sollte einmal der private-Teil verloren gehen, muss er bei allen Entwicklern ausgetauscht werden.

== scp-chroot ==

Der Benutzer dupload bekommt als loginshell /usr/bin/rssh, über die /etc/rssh.conf ist ihm nur scp erlaubt.

== incron Setup ==

brauchen wir ein seperates incron-setup oder funktioniert auch der dnotify-Support unter lenny?

== gpg-key ==
Jeder User benötigt einen eigenen gpg-key. Der öffentliche key muss in der ML bekannt gegeben werden, damit er auf dem Server in das Schlüsselbund eingefügt werden kann.

== Weblinks ==

* [http://wiki.debianforum.de/EigenesRepository wiki.debianforum.de/EigenesRepository]

----
<div align="right">[[Entwicklerhandbuch|zurück]] | [[Hauptseite]]</div>

Thorsten Strusch 2009

Entwicklerhandbuch/Repositorieverwaltung

2009-11-19T21:42:42Z

ThorstenStrusch: /* gpg-key */ wir nutzen gpg!

__NOTOC__
{{Uberarbeiten}}

'''Auf dieser Seite wird das Setup des dev-servers beschrieben. Möglicherweise gehört diese Seite ins trac!'''

= Funktionsweise =

Der Benutzer '''dupload''' hat über die sshd_config ein chroot unterhalb von ''$REPOSITORYROOT/mini-dinstall/incoming'' und darf nur scp benutzen. Ein login ist ausschliesslich über einen ssh-key möglich.

incron überwacht das Repository auf eine .changes-Datei und stößt nach einem ''"IN_MODIFY,IN_CREATE"'' das Script mini-dinstall --batch aus.
Die Pakete werden daraufhin einsortiert und die Releases signiert.

= Aufbau des Repositories =

* URL: deb.delixs.de
* aramec für den 1. Wurf
* delixs1 für lenny als Unterbau
* delixs2 für squeezy als Unterbau

= Konfigurationen =

Nachfolgend Vorschläge über die Konfigurationsdateien der beteiligten Dienste

== Apache ==
die Datei /etc/apache2/sites-available/deb.delixs.de
<source lang="apache">
<VirtualHost *:80>
ServerAdmin webmaster@delixs.de
ServerName deb.delixs.de
DocumentRoot /home/deb.delixs.de/

ErrorLog /var/log/apache2/error.log

# Possible values include: debug, info, notice, warn, error, crit,
# alert, emerg.
LogLevel warn

CustomLog /var/log/apache2/access.log combined
ServerSignature On

</VirtualHost>
</source>

== mini-dinstall ==

Pfad wo das Repository auf dem dev-Server liegt: '''/home/deb.delixs.de'''

<source lang="properties">
$ cat /home/$USER/.mini-dinstall.conf
# Adapted Colin's mini-dinstall.conf
# Infos unter /usr/share/doc/dput
# und http://debiananwenderhandbuch.de/mini-dinstall.html
[DEFAULT]
architectures = all, i386
archivedir = /home/deb.delixs.de/delixs/
use_dnotify = 0
verify_sigs = 0
extra_keyrings = ~/.gnupg/pubring.gpg
mail_on_success = 1
archive_style = simple-subdir
poll_time = 10
mail_log_level = NONE
generate_release = 1
release_description = delixs Packages
# Releases:
[aramec]
[testing]
</source>

== Benutzer dupload ==

Um nicht allen Entwicklern einen ssh-login auf dem dev-server geben zu müssen, legen wir den Benutzer dupload ''(debian-upload)'' ein.
In seinem Heimverzeichnis ist der Ordner incoming, auf den ein links von mini-dinstall/ioncoming zeigt.
Für ihn lassen wir ausschliesslich einen Zugang per ssh-key zu.

Sollte einmal der private-Teil verloren gehen, muss er bei allen Entwicklern ausgetauscht werden.

== sftp-chroot ==

Der Benutzer dupload bekommt keine loginshell, er darf nur sftp zum Hoch/runterladen benutzen:

<source lang="bash">
Subsystem sftp internal-sftp
Match user dupload
ChrootDirectory $REPOSITORYROOT/mini-dinstall/incoming
X11Forwarding no
AllowTcpForwarding no
ForceCommand internal-sftp
</source>

== incron Setup ==

brauchen wir ein seperates incron-setup oder funktioniert auch der dnotify-Support unter lenny?

== gpg-key ==
Jeder User benötigt einen eigenen gpg-key. Der öffentliche key muss in der ML bekannt gegeben werden, damit er auf dem Server in das Schlüsselbund eingefügt werden kann.

== Weblinks ==

* [http://wiki.debianforum.de/EigenesRepository wiki.debianforum.de/EigenesRepository]

----
<div align="right">[[Entwicklerhandbuch|zurück]] | [[Hauptseite]]</div>

Thorsten Strusch 2009

Entwicklerhandbuch/Repositorieverwaltung

2009-11-19T21:41:44Z

ThorstenStrusch: /* Benutzer dupload */

__NOTOC__
{{Uberarbeiten}}

'''Auf dieser Seite wird das Setup des dev-servers beschrieben. Möglicherweise gehört diese Seite ins trac!'''

= Funktionsweise =

Der Benutzer '''dupload''' hat über die sshd_config ein chroot unterhalb von ''$REPOSITORYROOT/mini-dinstall/incoming'' und darf nur scp benutzen. Ein login ist ausschliesslich über einen ssh-key möglich.

incron überwacht das Repository auf eine .changes-Datei und stößt nach einem ''"IN_MODIFY,IN_CREATE"'' das Script mini-dinstall --batch aus.
Die Pakete werden daraufhin einsortiert und die Releases signiert.

= Aufbau des Repositories =

* URL: deb.delixs.de
* aramec für den 1. Wurf
* delixs1 für lenny als Unterbau
* delixs2 für squeezy als Unterbau

= Konfigurationen =

Nachfolgend Vorschläge über die Konfigurationsdateien der beteiligten Dienste

== Apache ==
die Datei /etc/apache2/sites-available/deb.delixs.de
<source lang="apache">
<VirtualHost *:80>
ServerAdmin webmaster@delixs.de
ServerName deb.delixs.de
DocumentRoot /home/deb.delixs.de/

ErrorLog /var/log/apache2/error.log

# Possible values include: debug, info, notice, warn, error, crit,
# alert, emerg.
LogLevel warn

CustomLog /var/log/apache2/access.log combined
ServerSignature On

</VirtualHost>
</source>

== mini-dinstall ==

Pfad wo das Repository auf dem dev-Server liegt: '''/home/deb.delixs.de'''

<source lang="properties">
$ cat /home/$USER/.mini-dinstall.conf
# Adapted Colin's mini-dinstall.conf
# Infos unter /usr/share/doc/dput
# und http://debiananwenderhandbuch.de/mini-dinstall.html
[DEFAULT]
architectures = all, i386
archivedir = /home/deb.delixs.de/delixs/
use_dnotify = 0
verify_sigs = 0
extra_keyrings = ~/.gnupg/pubring.gpg
mail_on_success = 1
archive_style = simple-subdir
poll_time = 10
mail_log_level = NONE
generate_release = 1
release_description = delixs Packages
# Releases:
[aramec]
[testing]
</source>

== Benutzer dupload ==

Um nicht allen Entwicklern einen ssh-login auf dem dev-server geben zu müssen, legen wir den Benutzer dupload ''(debian-upload)'' ein.
In seinem Heimverzeichnis ist der Ordner incoming, auf den ein links von mini-dinstall/ioncoming zeigt.
Für ihn lassen wir ausschliesslich einen Zugang per ssh-key zu.

Sollte einmal der private-Teil verloren gehen, muss er bei allen Entwicklern ausgetauscht werden.

== sftp-chroot ==

Der Benutzer dupload bekommt keine loginshell, er darf nur sftp zum Hoch/runterladen benutzen:

<source lang="bash">
Subsystem sftp internal-sftp
Match user dupload
ChrootDirectory $REPOSITORYROOT/mini-dinstall/incoming
X11Forwarding no
AllowTcpForwarding no
ForceCommand internal-sftp
</source>

== incron Setup ==

brauchen wir ein seperates incron-setup oder funktioniert auch der dnotify-Support unter lenny?

== gpg-key ==

Zwei Möglichkeiten
# wir hinterlegen das Passwort auf der Platte im Klartext
# wir benutzen den gpg-agent, der es eine Weile im Speicher behält

Nachteil bei Möglichkeit 1: unsicher<br>
Nachteil bei Möglichkeit 2: man muss mind. nach jedem Reboot den agent wieder mit dem PW füttern

== Weblinks ==

* [http://wiki.debianforum.de/EigenesRepository wiki.debianforum.de/EigenesRepository]

----
<div align="right">[[Entwicklerhandbuch|zurück]] | [[Hauptseite]]</div>

Thorsten Strusch 2009

Entwicklerhandbuch/Repositorieverwaltung

2009-11-19T21:40:32Z

ThorstenStrusch: /* mini-dinstall */

__NOTOC__
{{Uberarbeiten}}

'''Auf dieser Seite wird das Setup des dev-servers beschrieben. Möglicherweise gehört diese Seite ins trac!'''

= Funktionsweise =

Der Benutzer '''dupload''' hat über die sshd_config ein chroot unterhalb von ''$REPOSITORYROOT/mini-dinstall/incoming'' und darf nur scp benutzen. Ein login ist ausschliesslich über einen ssh-key möglich.

incron überwacht das Repository auf eine .changes-Datei und stößt nach einem ''"IN_MODIFY,IN_CREATE"'' das Script mini-dinstall --batch aus.
Die Pakete werden daraufhin einsortiert und die Releases signiert.

= Aufbau des Repositories =

* URL: deb.delixs.de
* aramec für den 1. Wurf
* delixs1 für lenny als Unterbau
* delixs2 für squeezy als Unterbau

= Konfigurationen =

Nachfolgend Vorschläge über die Konfigurationsdateien der beteiligten Dienste

== Apache ==
die Datei /etc/apache2/sites-available/deb.delixs.de
<source lang="apache">
<VirtualHost *:80>
ServerAdmin webmaster@delixs.de
ServerName deb.delixs.de
DocumentRoot /home/deb.delixs.de/

ErrorLog /var/log/apache2/error.log

# Possible values include: debug, info, notice, warn, error, crit,
# alert, emerg.
LogLevel warn

CustomLog /var/log/apache2/access.log combined
ServerSignature On

</VirtualHost>
</source>

== mini-dinstall ==

Pfad wo das Repository auf dem dev-Server liegt: '''/home/deb.delixs.de'''

<source lang="properties">
$ cat /home/$USER/.mini-dinstall.conf
# Adapted Colin's mini-dinstall.conf
# Infos unter /usr/share/doc/dput
# und http://debiananwenderhandbuch.de/mini-dinstall.html
[DEFAULT]
architectures = all, i386
archivedir = /home/deb.delixs.de/delixs/
use_dnotify = 0
verify_sigs = 0
extra_keyrings = ~/.gnupg/pubring.gpg
mail_on_success = 1
archive_style = simple-subdir
poll_time = 10
mail_log_level = NONE
generate_release = 1
release_description = delixs Packages
# Releases:
[aramec]
[testing]
</source>

== Benutzer dupload ==

Um nicht allen Entwicklern einen ssh-login auf dem dev-server geben zu müssen, legen wir den Benutzer dupload ''(debian-upload)'' ein, der im incoming Verzeichnis von mini-dinstall eingesperrt ist. Für ihn lassen wir ausschliesslich einen Zugang per ssh-key zu.

Sollte einmal der private-Teil verloren gehen, muss er bei allen Entwicklern ausgetauscht werden.

== sftp-chroot ==

Der Benutzer dupload bekommt keine loginshell, er darf nur sftp zum Hoch/runterladen benutzen:

<source lang="bash">
Subsystem sftp internal-sftp
Match user dupload
ChrootDirectory $REPOSITORYROOT/mini-dinstall/incoming
X11Forwarding no
AllowTcpForwarding no
ForceCommand internal-sftp
</source>

== incron Setup ==

brauchen wir ein seperates incron-setup oder funktioniert auch der dnotify-Support unter lenny?

== gpg-key ==

Zwei Möglichkeiten
# wir hinterlegen das Passwort auf der Platte im Klartext
# wir benutzen den gpg-agent, der es eine Weile im Speicher behält

Nachteil bei Möglichkeit 1: unsicher<br>
Nachteil bei Möglichkeit 2: man muss mind. nach jedem Reboot den agent wieder mit dem PW füttern

== Weblinks ==

* [http://wiki.debianforum.de/EigenesRepository wiki.debianforum.de/EigenesRepository]

----
<div align="right">[[Entwicklerhandbuch|zurück]] | [[Hauptseite]]</div>

Thorsten Strusch 2009

Entwicklerhandbuch/Repositorieverwaltung

2009-11-19T21:39:17Z

ThorstenStrusch: /* Apache */ den vHost angegeben

__NOTOC__
{{Uberarbeiten}}

'''Auf dieser Seite wird das Setup des dev-servers beschrieben. Möglicherweise gehört diese Seite ins trac!'''

= Funktionsweise =

Der Benutzer '''dupload''' hat über die sshd_config ein chroot unterhalb von ''$REPOSITORYROOT/mini-dinstall/incoming'' und darf nur scp benutzen. Ein login ist ausschliesslich über einen ssh-key möglich.

incron überwacht das Repository auf eine .changes-Datei und stößt nach einem ''"IN_MODIFY,IN_CREATE"'' das Script mini-dinstall --batch aus.
Die Pakete werden daraufhin einsortiert und die Releases signiert.

= Aufbau des Repositories =

* URL: deb.delixs.de
* aramec für den 1. Wurf
* delixs1 für lenny als Unterbau
* delixs2 für squeezy als Unterbau

= Konfigurationen =

Nachfolgend Vorschläge über die Konfigurationsdateien der beteiligten Dienste

== Apache ==
die Datei /etc/apache2/sites-available/deb.delixs.de
<source lang="apache">
<VirtualHost *:80>
ServerAdmin webmaster@delixs.de
ServerName deb.delixs.de
DocumentRoot /home/deb.delixs.de/

ErrorLog /var/log/apache2/error.log

# Possible values include: debug, info, notice, warn, error, crit,
# alert, emerg.
LogLevel warn

CustomLog /var/log/apache2/access.log combined
ServerSignature On

</VirtualHost>
</source>

== mini-dinstall ==

Pfad wo das Repository auf dem dev-Server liegt: '''/home/deb.delixs.de'''

=> '''Wollen wir mini-dinstall als root oder als seperater User laufen lassen?'''

<source lang="properties">
$ cat /home/$USER/.mini-dinstall.conf
# Adapted Colin's mini-dinstall.conf
# Infos unter /usr/share/doc/dput
# und http://debiananwenderhandbuch.de/mini-dinstall.html
[DEFAULT]
architectures = all, i386
archivedir = /home/deb.delixs.de/delixs/
use_dnotify = 0
verify_sigs = 0
# aktivieren, sobald key erzeugt ist
#extra_keyrings = ~/.gnupg/pubring.gpg
mail_on_success = 1
archive_style = simple-subdir
poll_time = 10
mail_log_level = NONE
generate_release = 1
release_description = delixs Packages
# Releases:
[aramec]
[delixs1]
[delixs1-testing]
</source>

== Benutzer dupload ==

Um nicht allen Entwicklern einen ssh-login auf dem dev-server geben zu müssen, legen wir den Benutzer dupload ''(debian-upload)'' ein, der im incoming Verzeichnis von mini-dinstall eingesperrt ist. Für ihn lassen wir ausschliesslich einen Zugang per ssh-key zu.

Sollte einmal der private-Teil verloren gehen, muss er bei allen Entwicklern ausgetauscht werden.

== sftp-chroot ==

Der Benutzer dupload bekommt keine loginshell, er darf nur sftp zum Hoch/runterladen benutzen:

<source lang="bash">
Subsystem sftp internal-sftp
Match user dupload
ChrootDirectory $REPOSITORYROOT/mini-dinstall/incoming
X11Forwarding no
AllowTcpForwarding no
ForceCommand internal-sftp
</source>

== incron Setup ==

brauchen wir ein seperates incron-setup oder funktioniert auch der dnotify-Support unter lenny?

== gpg-key ==

Zwei Möglichkeiten
# wir hinterlegen das Passwort auf der Platte im Klartext
# wir benutzen den gpg-agent, der es eine Weile im Speicher behält

Nachteil bei Möglichkeit 1: unsicher<br>
Nachteil bei Möglichkeit 2: man muss mind. nach jedem Reboot den agent wieder mit dem PW füttern

== Weblinks ==

* [http://wiki.debianforum.de/EigenesRepository wiki.debianforum.de/EigenesRepository]

----
<div align="right">[[Entwicklerhandbuch|zurück]] | [[Hauptseite]]</div>

Thorsten Strusch 2009

Entwicklerhandbuch/Repositorieverwaltung

2009-11-19T21:38:10Z

ThorstenStrusch: /* Funktionsweise */ sftp -> scp

__NOTOC__
{{Uberarbeiten}}

'''Auf dieser Seite wird das Setup des dev-servers beschrieben. Möglicherweise gehört diese Seite ins trac!'''

= Funktionsweise =

Der Benutzer '''dupload''' hat über die sshd_config ein chroot unterhalb von ''$REPOSITORYROOT/mini-dinstall/incoming'' und darf nur scp benutzen. Ein login ist ausschliesslich über einen ssh-key möglich.

incron überwacht das Repository auf eine .changes-Datei und stößt nach einem ''"IN_MODIFY,IN_CREATE"'' das Script mini-dinstall --batch aus.
Die Pakete werden daraufhin einsortiert und die Releases signiert.

= Aufbau des Repositories =

* URL: deb.delixs.de
* aramec für den 1. Wurf
* delixs1 für lenny als Unterbau
* delixs2 für squeezy als Unterbau

= Konfigurationen =

Nachfolgend Vorschläge über die Konfigurationsdateien der beteiligten Dienste

== Apache ==

<source lang="apache">
deb.delixs.de
</source>

== mini-dinstall ==

Pfad wo das Repository auf dem dev-Server liegt: '''/home/deb.delixs.de'''

=> '''Wollen wir mini-dinstall als root oder als seperater User laufen lassen?'''

<source lang="properties">
$ cat /home/$USER/.mini-dinstall.conf
# Adapted Colin's mini-dinstall.conf
# Infos unter /usr/share/doc/dput
# und http://debiananwenderhandbuch.de/mini-dinstall.html
[DEFAULT]
architectures = all, i386
archivedir = /home/deb.delixs.de/delixs/
use_dnotify = 0
verify_sigs = 0
# aktivieren, sobald key erzeugt ist
#extra_keyrings = ~/.gnupg/pubring.gpg
mail_on_success = 1
archive_style = simple-subdir
poll_time = 10
mail_log_level = NONE
generate_release = 1
release_description = delixs Packages
# Releases:
[aramec]
[delixs1]
[delixs1-testing]
</source>

== Benutzer dupload ==

Um nicht allen Entwicklern einen ssh-login auf dem dev-server geben zu müssen, legen wir den Benutzer dupload ''(debian-upload)'' ein, der im incoming Verzeichnis von mini-dinstall eingesperrt ist. Für ihn lassen wir ausschliesslich einen Zugang per ssh-key zu.

Sollte einmal der private-Teil verloren gehen, muss er bei allen Entwicklern ausgetauscht werden.

== sftp-chroot ==

Der Benutzer dupload bekommt keine loginshell, er darf nur sftp zum Hoch/runterladen benutzen:

<source lang="bash">
Subsystem sftp internal-sftp
Match user dupload
ChrootDirectory $REPOSITORYROOT/mini-dinstall/incoming
X11Forwarding no
AllowTcpForwarding no
ForceCommand internal-sftp
</source>

== incron Setup ==

brauchen wir ein seperates incron-setup oder funktioniert auch der dnotify-Support unter lenny?

== gpg-key ==

Zwei Möglichkeiten
# wir hinterlegen das Passwort auf der Platte im Klartext
# wir benutzen den gpg-agent, der es eine Weile im Speicher behält

Nachteil bei Möglichkeit 1: unsicher<br>
Nachteil bei Möglichkeit 2: man muss mind. nach jedem Reboot den agent wieder mit dem PW füttern

== Weblinks ==

* [http://wiki.debianforum.de/EigenesRepository wiki.debianforum.de/EigenesRepository]

----
<div align="right">[[Entwicklerhandbuch|zurück]] | [[Hauptseite]]</div>

Thorsten Strusch 2009

Entwicklerhandbuch/Paketverwaltung

2009-11-19T21:37:23Z

ThorstenStrusch: /* dput Konfiguration */ sftp -> scp , login hinzugefügt

__NOTOC__
{{ZumTest}}

== Paketverwaltung mit dput, mini-dinstall und svn-buildpackage ==
=== Einführung ===

Installiere auf deinem debian/lenny Rechner die entsprechenden Pakete mit den folgenden Befehl:

<source lang="bash">
aptitude install dput mini-dinstall svn-buildpackage devscripts openssh-client
</source>

Arbeitest du unter gnome:

<source lang="bash">
aptitude install ssh-askpass-gnome
</source>

Arbeitest du unter kde:

<source lang="bash">
aptitude install ssh-askpass
</source>

=== svn-buildpackage ===

Mit svn-buildpackage hast du die Möglichkeit debian Pakete
(die wir im SVN vohalten) für die entspr. Architekturen zu bauen.
Wir möchten i386 und amd64 unterstützen.
Es werden dabei binäre Debianpakete und source-Pakete erstellt.

Erstere erkennst du an der Dateiendung .deb, letztere bestehen aus
zwei Dateien. Eine endet auf dsc, die andere auf tar.gz.

Die source-Pakete kannst du herunterladen, wenn du in deiner
sources.list eine Zeile mit deb-src am Anfang stehen hast.
Die binären Dateien kannst du herunterladen, wenn du deb als
erstes Argument in der Zeile stehen hast.

svn-buildpackage erstellt ausserdem zu jedem Paket eine
<nowiki>$PAKETNAME_$VERSION-$UNTERVERSION_$ARCHITEKTUR.changes</nowiki> Datei.
(z.B. delixs-firstrun-config_0.1-58_all.deb)
Mit dieser Datei kann dput arbeiten.

'''INFO:'''
Zum Erstellen eines debian-Pakets sollten wir also nicht mehr
<code>fakeroot ./debian/rules binary</code> nutzen. Hierbei wird weder
die changes Datei noch die source-Dateien erstellt. Lasst uns also
wie später unten beschrieben mit dem alias svn-b arbeiten.

=== dput ===

Dieses Programm ermöglicht es die binär- und source-Pakete in ein
debian Repository zu laden. Also auf solche 'Server', die du in der
/etc/apt/sources.list als Installationsquellen eintragen kannst.

dput unterstützt dabei mehrere Verfahren zum Hochladen, die wichtigsten
sind ftp,ssh/sftp und lokales Kopieren.

=== mini-dinstall ===

dieses Programm erzeugt nun ein Repository mit allen Schickanen:

<source lang="bash">
$\tree
|-- delixs1
| |-- all
| | |-- Packages
| | |-- Packages.bz2
| | |-- Packages.gz
| | `-- Release
| |-- all.db
| |-- amd64
| | |-- Packages
| | |-- Packages.bz2
| | |-- Packages.gz
| | `-- Release
| |-- amd64.db
| |-- i386
| | |-- Packages
| | |-- Packages.bz2
| | |-- Packages.gz
| | `-- Release
| |-- i386.db
| `-- source
| |-- Sources
| |-- Sources.bz2
| `-- Sources.gz
</source>

* unter delixs/all liegen die architekturunabhängigen binären debian-Pakete (debs)
* unter delixs/amd64 liegen die binären amd64 debian-Pakete (debs)
* unter delixs/i386 liegen die binären i386 debian-Pakete (debs)
* unter source liegen alle Versionen dieser Pakete im source-Format. Jeweils eine dsc und eine tar.gz Datei

== apt-Konfiguration ==

Um jetzt auch mit den frisch erstellten Repositories arbeiten zu können, sind zwei Dateien notwendig, die im Folgenden beschrieben werden.

Der Ausdruck $(ARCH) bewirkt, dass apt sich die PC Architektur selbst sucht. Das delixs-Projekt unterstützt i386 und amd64.

=== lokales Repository aktivieren ===

Erstelle eine Datei /etc/apt/sources.list.d/file.list wie unten angegeben:

<source lang="apt_sources">
cat /etc/apt/sources.list.d/file.list

deb file:/home/thorsten/public_html/debian aramec/all
deb file:/home/thorsten/public_html/debian aramec/$(ARCH)/
deb-src file:/home/thorsten/public_html/debian aramec/source/
</source>

Als root führe <code>aptitude update</code> durch und das Repository ist eingebunden und einsatzfähig.

=== offizielles Repository aktivieren ===

Erstelle eine Datei /etc/apt/sources.list.d/delixs.list wie unten angegeben:

<source lang="apt_sources">
cat /etc/apt/sources.list.d/aramec.list

deb file:/home/thorsten/public_html/debian aramec/all
deb file:/home/thorsten/public_html/debian aramec/$(ARCH)/
deb-src file:/home/thorsten/public_html/debian aramec/source/
</source>

Als root führe <code>aptitude update</code> durch und das Repository ist zwar eingebunden aber wegen eines noch nicht bekannten GPG-Schlüssels wird ihm nicht vertraut.

=== gpg Schlüssel importieren ===

'''XXX''' wird noch im Detail beschrieben
* manuell mit wget http://deb.delixs.de/debian/keyring.asc
* automatisch mittels aptitude install delixs-archive-keyring

== Konfiguration ==
=== alias svn-b ===

Wenn du ein Paket bauen und hochladen möchtest, rufst du dafür i.A. svn-buildpackage auf. Folgenden alias solltest du in deine ~/.bashrc packen:

<source lang="bash">
alias svn-b="svn-buildpackage -us -uc -rfakeroot --svn-ignore"
</source>

Damit reicht ein '''svn-b''' zum Bauen des Pakets. Es wird dann eine Ebene höher im Order '''build-area''' liegen.

== der Benutzer dupload ==

=== dput Konfiguration ===

Mit der folgenden Konfiguration kennt dput zwei Ziele für den Paketupload

# local - deinen Rechner
# delixs - unser offizielles delixs-Repository

<source lang="properties">
$ cat ~/.dput.cf
[local]
method = local
hostname = localhost
incoming = ~/public_html/debian/mini-dinstall/incoming
run_dinstall = 0
allow_unsigned_uploads = 0
verify_sigs = 1
post_upload_command = /usr/bin/mini-dinstall --batch

[delixs]
fqdn = deb.delixs.de
method = scp
login = dupload
incoming = ./incoming
run_dinstall = 0
allow_unsigned_uploads = 0
verify_sigs = 1
</source>

=== mini-dinstall Konfiguration ===

mini-dinstall soll mir ein Repository unter ~/public_html/delixs/ anlegen. Dafür ist folgende Konfiguration nötig:

<source lang="properties">
$ cat ~/.mini-dinstall.conf
# Adapted Colin's mini-dinstall.conf
# Infos unter /usr/share/doc/dput
# und http://debiananwenderhandbuch.de/mini-dinstall.html
[DEFAULT]
architectures = all, i386, amd64
archivedir = ~/public_html/delixs/
use_dnotify = 0
verify_sigs = 0
#extra_keyrings = ~/.gnupg/pubring.gpg
mail_on_success = 0
archive_style = simple-subdir
poll_time = 10
mail_log_level = NONE
generate_release = 1
release_description = delixs Packages
# Releases:
[aramec]
[testing]
</source>

=== ssh Clientkonfiguration ===

Damit dput beim Hochladen auf den dev-server (deb.delixs.de) sich gleich mit den korrekten Einstellugnen wie dem Benutzer verbindet, leg dir die Datei ~/.ssh/config mit folgendem Inhalt an:

<source lang="bash">
host deb.delixs.de
CheckHostIP no
User dupload
Ciphers arcfour
Protocol 2
IdentityFile ~/.ssh/id_dsa.dupload
</source>

'''XXX''' Die Datei id_dsa.dupload bekommst du noch

=== gpg-Schlüssel ===

Wenn du Pakete auf den dev-Server lädst, muss die Release Datei mit gpg signiert werden. Ansonsten würde jeder Server, der dieses Repository nutzt, über ein unsicheres Archiv meckern.

Darum musst du dich hier nicht kümmern, das erzeugt das Programm mini-dinstall auf dem Server. Bei dir im lokalen Repository brauchst du den Aufwand nicht treiben, lokal verfügbare Release-Dateien müssen nicht signiert werden.

== Beispiel ==

Nachfolgend ein Beispiel, wo ich das (nicht existierende) Paket delixs-firstrun-config
in der Version 0.1-58 in das lokale Repository hochlade. Am Ende wird automatisch mini-dinstall ausgeführt.

<source lang="bash">
$ dput local delixs-firstrun-config_0.1-58_i3864.changes
$ \tree ~/public_html/debian/delixs1/
/home/thorsten/public_html/debian/delixs1/
|-- all
| |-- Packages
| |-- Packages.bz2
| |-- Packages.gz
| |-- Release
| `-- delixs-firstrun-config_0.1-58_all.deb
|-- all.db
|-- amd64
| |-- Packages
| |-- Packages.bz2
| |-- Packages.gz
| `-- Release
|-- amd64.db
|-- i386
| |-- Packages
| |-- Packages.bz2
| |-- Packages.gz
| `-- Release
|-- i386.db
|-- delixs-firstrun-config_0.1-58_i386.changes
`-- source
|-- Sources
|-- Sources.bz2
|-- Sources.gz
|-- delixs-firstrun-config_0.1-58.dsc
`-- delixs-firstrun-config_0.1-58.tar.gz

</source>

'''Erklärung:'''
* Unter all liegt das architekturunabhängige Paket delixs-firstrun-config_0.1-58_all.deb
* direkt im Ordner delixs1 liegt die changes-Datei.
* unter source liegen die beiden Dateien delixs-firstrun-config_0.1-58.{dsc,tar-gz}

Im Ordner, von dem du das Paket hochgeladen hast (wahrscheinlich build-area), wurde die Datei
delixs-firstrun-config_0.1-58_i386.upload angelegt. Der Inhalt:

<source lang="bash">
$ cat delixs-firstrun-config_0.1-58_i386.upload
Successfully uploaded delixs-firstrun-config_0.1-58.dsc to localhost.
Successfully uploaded delixs-firstrun-config_0.1-58.tar.gz to localhost.
Successfully uploaded delixs-firstrun-config_0.1-58_all.deb to localhost.
Successfully uploaded delixs-firstrun-config_0.1-58_i386.changes to localhost.
</source>

Durch dieses logfile weis dput, dass es die Datei nicht nochmal hochladen muss, wenn du es ein zweites Mal probieren solltest.

== Weblinks ==

* [http://wiki.debianforum.de/EigenesRepository wiki.debianforum.de/EigenesRepository]

----
<div align="right">[[Entwicklerhandbuch|zurück]] | [[Hauptseite]]</div>

Thorsten Strusch 2009

Entwicklerhandbuch/GPG Schluessel

2009-11-15T11:28:23Z

ThorstenStrusch: /* öffentlichen Schlüssel dem Projekt bekannt geben */

= GPG für das Signieren eines debian Pakets =
Für ein sicheres und gemeinsames arbeiten an einem debian Repository sollte jeder seine Pakete und Uploads mit seinem eigenen gpg-key unterschreiben.

Hier eine kurze Anleitung, wie dieser Key anzulegen ist.

== Paketinstallation ==
Kurz und schmerzlos gpg installieren:
<source lang="bash">
$ sudo aptitude install gnupg gnupg-agent
</source>

== Schlüssel erzeugen ==
Der nachfolgende Aufruf erzeugt den Schlüssel. Bitte benutze deinen vollen Namen und deine delixs-Adresse.
Der Aufruf endet so in etwa wie hier
<source lang="bash">
$ gpg --gen-key
[...]
gpg: Schlüssel 0DDF17D0 ist als uneingeschränkt vertrauenswürdig gekennzeichnet
Öffentlichen und geheimen Schlüssel erzeugt und signiert.

gpg: "Trust-DB" wird überprüft
gpg: 3 marginal-needed, 1 complete-needed, PGP Vertrauensmodell
gpg: Tiefe: 0 gültig: 1 unterschrieben: 0 Vertrauen: 0-, 0q, 0n, 0m, 0f, 1u
gpg: nächste "Trust-DB"-Pflichtüberprüfung am 2014-11-12
pub 1024D/0DDF17D0 2009-11-13 [verfällt: 2014-11-12]
Schl.-Fingerabdruck = 1E25 3B8E EC5E 4DC4 7CA6 DC25 74B0 E102 0DDF 17D0
uid Thorsten Strusch <post@thorstenstrusch.de>
sub 2048g/3D7D81D5 2009-11-13 [verfällt: 2014-11-12]
</source>

Die Schlüssel ID ('''hier 0DDF17D0''') solltest du dir merken, wir brauche sie noch weiter unten.

== Passwortverwaltung mit gnupg-agent ==
Sowohl dpkg-buildpackage als auch dput verlangen beim Erstellen des Pakets bzw. beim Signieren oder Hochladen nach dem Passwort für den Schlüssel.
Damit man nicht immer wieder den key eintippen muss, kann sich der gpg Agent das Passwort Weile merken. Schreib dafür folgendes in deine ~/.bashrc

<source lang="bash">
GPG_TTY=`tty`
export GPG_TTY

# Für die Signierung des Archivs
if test -f $HOME/.gpg-agent-info && kill -0 `cut -d: -f 2 $HOME/.gpg-agent-info` 2>/dev/null; then
GPG_AGENT_INFO=`cat $HOME/.gpg-agent-info`
export GPG_AGENT_INFO
else
eval `gpg-agent --daemon`
echo $GPG_AGENT_INFO >$HOME/.gpg-agent-info
fi
</source>
Damit der agent überhaupt benutzt wird, muss man das in der gpg-Konfiguration freischalten:
<source lang="bash">
echo "use-agent" > ~/.gnupg/gpg.conf
</source>

=== Gnome Desktop ===
Unter dem Gnome Desktop kann die Anwengung seahorse aus dem gleichnamigen debian-Paket installiert werden. Es reicht ein <code>aptitude install seahorse</code>.

== öffentlichen Schlüssel dem Projekt bekannt geben ==
Damit du mit deinem Schlüssel signierte Pakete in das delixs-Repository hochladen darfst, muss du uns deinen öffentlichen Schlüssel geben.

Zuerst benötigst du die ID deines Schlüssels. Hier im Beispiel ist es die '''0DDF17D0'''
<source lang="bash">
$ gpg --list-keys
/home/thorsten/.gnupg/pubring.gpg
---------------------------------
pub 1024D/0DDF17D0 2009-11-13 [verfällt: 2014-11-12]
uid Thorsten Strusch <post@thorstenstrusch.de>
sub 2048g/3D7D81D5 2009-11-13 [verfällt: 2014-11-12]
</source>
Jetzt exportiere diesen Schlüssel mit der eben erfahrenen keyID (oder der Emailadresse) in eine Datei. Wir wählen über den Schalter armor das ASCII-Format, weil man es per Mail verschicken kann, ohne Gefahr zu laufen, dass es dabei zersört wird.
<source lang="bash">
gpg --output $USERNAME.asc --armor --export 0DDF17D0
bzw.
gpg --output $USERNAME.asc --armor --export post@thorstenstrusch.de
</source>
Maile die entstandene Datei (= der öffentliche Schlüssel deines gpg-keys) an die delixs-Mailingliste.

= Eine Emailadresse zum Schlüssel hinzufügen =
Meist hat man mehr als nur eine Emailadresse in Gebrauch, möchte aber
natürlich nur einen gpg-key benutzen.

Also muss eine weitere Identität zum Schlüssel hinzugefügt werden.
In diesem Beispiel füge ich meine Projektadressse th.strusch@delixs.de
hinzu:

<source lang="bash">
$ gpg --edit-key post@thorstenstrusch.de
gpg (GnuPG) 1.4.9; Copyright (C) 2008 Free Software Foundation, Inc.
This is free software: you are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law.

Geheimer Schlüssel ist vorhanden.

pub 1024D/0DDF17D0 erzeugt: 2009-11-13 verfällt: 2014-11-12 Aufruf: SC
Vertrauen: uneingeschränkt Gültigkeit: uneingeschränkt
sub 2048g/3D7D81D5 erzeugt: 2009-11-13 verfällt: 2014-11-12 Aufruf: E
[ uneing.] (1). Thorsten Strusch <post@thorstenstrusch.de>

Befehl> adduid
Ihr Name ("Vorname Nachname"): Thorsten Strusch
Email-Adresse: th.strusch@delixs.de
Kommentar:
Sie haben diese User-ID gewählt:
"Thorsten Strusch <th.strusch@delixs.de>"

Ändern: (N)ame, (K)ommentar, (E)-Mail oder (F)ertig/(B)eenden? F

Sie benötigen eine Passphrase, um den geheimen Schlüssel zu entsperren.
Benutzer: "Thorsten Strusch <post@thorstenstrusch.de>"
1024-Bit DSA Schlüssel, ID 0DDF17D0, erzeugt 2009-11-13

pub 1024D/0DDF17D0 erzeugt: 2009-11-13 verfällt: 2014-11-12 Aufruf: SC
Vertrauen: uneingeschränkt Gültigkeit: uneingeschränkt
sub 2048g/3D7D81D5 erzeugt: 2009-11-13 verfällt: 2014-11-12 Aufruf: E
[ uneing.] (1) Thorsten Strusch <post@thorstenstrusch.de>
[ unbek.] (2). Thorsten Strusch <th.strusch@delixs.de>

Befehl> quit
Änderungen speichern? ja
</source>

Mal schauen, ob es geklappt hat:
<source lang="bash">
$ gpg --list-keys
/home/thorsten/.gnupg/pubring.gpg
---------------------------------
pub 1024D/0DDF17D0 2009-11-13
uid Thorsten Strusch <post@thorstenstrusch.de>
uid Thorsten Strusch <th.strusch@delixs.de>
sub 2048g/3D7D81D5 2009-11-13 [verfällt: 2014-11-12]
</source>

= Links =
[http://wiki.debianforum.de/EigenesRepository wiki.debianforum.de/EigenesRepository]

Entwicklerhandbuch/GPG Schluessel

2009-11-15T11:27:14Z

ThorstenStrusch: /* öffentlichen Schlüssel bekannt geben */

= GPG für das Signieren eines debian Pakets =
Für ein sicheres und gemeinsames arbeiten an einem debian Repository sollte jeder seine Pakete und Uploads mit seinem eigenen gpg-key unterschreiben.

Hier eine kurze Anleitung, wie dieser Key anzulegen ist.

== Paketinstallation ==
Kurz und schmerzlos gpg installieren:
<source lang="bash">
$ sudo aptitude install gnupg gnupg-agent
</source>

== Schlüssel erzeugen ==
Der nachfolgende Aufruf erzeugt den Schlüssel. Bitte benutze deinen vollen Namen und deine delixs-Adresse.
Der Aufruf endet so in etwa wie hier
<source lang="bash">
$ gpg --gen-key
[...]
gpg: Schlüssel 0DDF17D0 ist als uneingeschränkt vertrauenswürdig gekennzeichnet
Öffentlichen und geheimen Schlüssel erzeugt und signiert.

gpg: "Trust-DB" wird überprüft
gpg: 3 marginal-needed, 1 complete-needed, PGP Vertrauensmodell
gpg: Tiefe: 0 gültig: 1 unterschrieben: 0 Vertrauen: 0-, 0q, 0n, 0m, 0f, 1u
gpg: nächste "Trust-DB"-Pflichtüberprüfung am 2014-11-12
pub 1024D/0DDF17D0 2009-11-13 [verfällt: 2014-11-12]
Schl.-Fingerabdruck = 1E25 3B8E EC5E 4DC4 7CA6 DC25 74B0 E102 0DDF 17D0
uid Thorsten Strusch <post@thorstenstrusch.de>
sub 2048g/3D7D81D5 2009-11-13 [verfällt: 2014-11-12]
</source>

Die Schlüssel ID ('''hier 0DDF17D0''') solltest du dir merken, wir brauche sie noch weiter unten.

== Passwortverwaltung mit gnupg-agent ==
Sowohl dpkg-buildpackage als auch dput verlangen beim Erstellen des Pakets bzw. beim Signieren oder Hochladen nach dem Passwort für den Schlüssel.
Damit man nicht immer wieder den key eintippen muss, kann sich der gpg Agent das Passwort Weile merken. Schreib dafür folgendes in deine ~/.bashrc

<source lang="bash">
GPG_TTY=`tty`
export GPG_TTY

# Für die Signierung des Archivs
if test -f $HOME/.gpg-agent-info && kill -0 `cut -d: -f 2 $HOME/.gpg-agent-info` 2>/dev/null; then
GPG_AGENT_INFO=`cat $HOME/.gpg-agent-info`
export GPG_AGENT_INFO
else
eval `gpg-agent --daemon`
echo $GPG_AGENT_INFO >$HOME/.gpg-agent-info
fi
</source>
Damit der agent überhaupt benutzt wird, muss man das in der gpg-Konfiguration freischalten:
<source lang="bash">
echo "use-agent" > ~/.gnupg/gpg.conf
</source>

=== Gnome Desktop ===
Unter dem Gnome Desktop kann die Anwengung seahorse aus dem gleichnamigen debian-Paket installiert werden. Es reicht ein <code>aptitude install seahorse</code>.

== öffentlichen Schlüssel dem Projekt bekannt geben ==
Damit du mit deinem Schlüssel signierte Pakete in das delixs-Repository hochladen darfst, muss du uns deinen öffentlichen Schlüssel geben.

Zuerst benötigst du die ID deines Schlüssels. Hier im Beispiel ist es die '''0DDF17D0'''
<source lang="bash">
$ gpg --list-keys
/home/thorsten/.gnupg/pubring.gpg
---------------------------------
pub 1024D/0DDF17D0 2009-11-13 [verfällt: 2014-11-12]
uid Thorsten Strusch <post@thorstenstrusch.de>
sub 2048g/3D7D81D5 2009-11-13 [verfällt: 2014-11-12]
</source>
Jetzt exportiere diesen Schlüssel mit der eben erfahrenen keyID in eine Datei. Wir wählen über den Schalter armor das ASCII-Format, weil man es per Mail verschicken kann, ohne Gefahr zu laufen, dass es dabei zersört wird.
<source lang="bash">
gpg --output $USERNAME.asc --armor --export 0DDF17D0
</source>
Maile die entstandene Datei (= der öffentliche Schlüssel deines gpg-keys) an die delixs-Mailingliste.

= Eine Emailadresse zum Schlüssel hinzufügen =
Meist hat man mehr als nur eine Emailadresse in Gebrauch, möchte aber
natürlich nur einen gpg-key benutzen.

Also muss eine weitere Identität zum Schlüssel hinzugefügt werden.
In diesem Beispiel füge ich meine Projektadressse th.strusch@delixs.de
hinzu:

<source lang="bash">
$ gpg --edit-key post@thorstenstrusch.de
gpg (GnuPG) 1.4.9; Copyright (C) 2008 Free Software Foundation, Inc.
This is free software: you are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law.

Geheimer Schlüssel ist vorhanden.

pub 1024D/0DDF17D0 erzeugt: 2009-11-13 verfällt: 2014-11-12 Aufruf: SC
Vertrauen: uneingeschränkt Gültigkeit: uneingeschränkt
sub 2048g/3D7D81D5 erzeugt: 2009-11-13 verfällt: 2014-11-12 Aufruf: E
[ uneing.] (1). Thorsten Strusch <post@thorstenstrusch.de>

Befehl> adduid
Ihr Name ("Vorname Nachname"): Thorsten Strusch
Email-Adresse: th.strusch@delixs.de
Kommentar:
Sie haben diese User-ID gewählt:
"Thorsten Strusch <th.strusch@delixs.de>"

Ändern: (N)ame, (K)ommentar, (E)-Mail oder (F)ertig/(B)eenden? F

Sie benötigen eine Passphrase, um den geheimen Schlüssel zu entsperren.
Benutzer: "Thorsten Strusch <post@thorstenstrusch.de>"
1024-Bit DSA Schlüssel, ID 0DDF17D0, erzeugt 2009-11-13

pub 1024D/0DDF17D0 erzeugt: 2009-11-13 verfällt: 2014-11-12 Aufruf: SC
Vertrauen: uneingeschränkt Gültigkeit: uneingeschränkt
sub 2048g/3D7D81D5 erzeugt: 2009-11-13 verfällt: 2014-11-12 Aufruf: E
[ uneing.] (1) Thorsten Strusch <post@thorstenstrusch.de>
[ unbek.] (2). Thorsten Strusch <th.strusch@delixs.de>

Befehl> quit
Änderungen speichern? ja
</source>

Mal schauen, ob es geklappt hat:
<source lang="bash">
$ gpg --list-keys
/home/thorsten/.gnupg/pubring.gpg
---------------------------------
pub 1024D/0DDF17D0 2009-11-13
uid Thorsten Strusch <post@thorstenstrusch.de>
uid Thorsten Strusch <th.strusch@delixs.de>
sub 2048g/3D7D81D5 2009-11-13 [verfällt: 2014-11-12]
</source>

= Links =
[http://wiki.debianforum.de/EigenesRepository wiki.debianforum.de/EigenesRepository]

Entwicklerhandbuch/GPG Schluessel

2009-11-15T11:26:42Z

ThorstenStrusch: eine Identität zum Schlüssel hinzufügen

= GPG für das Signieren eines debian Pakets =
Für ein sicheres und gemeinsames arbeiten an einem debian Repository sollte jeder seine Pakete und Uploads mit seinem eigenen gpg-key unterschreiben.

Hier eine kurze Anleitung, wie dieser Key anzulegen ist.

== Paketinstallation ==
Kurz und schmerzlos gpg installieren:
<source lang="bash">
$ sudo aptitude install gnupg gnupg-agent
</source>

== Schlüssel erzeugen ==
Der nachfolgende Aufruf erzeugt den Schlüssel. Bitte benutze deinen vollen Namen und deine delixs-Adresse.
Der Aufruf endet so in etwa wie hier
<source lang="bash">
$ gpg --gen-key
[...]
gpg: Schlüssel 0DDF17D0 ist als uneingeschränkt vertrauenswürdig gekennzeichnet
Öffentlichen und geheimen Schlüssel erzeugt und signiert.

gpg: "Trust-DB" wird überprüft
gpg: 3 marginal-needed, 1 complete-needed, PGP Vertrauensmodell
gpg: Tiefe: 0 gültig: 1 unterschrieben: 0 Vertrauen: 0-, 0q, 0n, 0m, 0f, 1u
gpg: nächste "Trust-DB"-Pflichtüberprüfung am 2014-11-12
pub 1024D/0DDF17D0 2009-11-13 [verfällt: 2014-11-12]
Schl.-Fingerabdruck = 1E25 3B8E EC5E 4DC4 7CA6 DC25 74B0 E102 0DDF 17D0
uid Thorsten Strusch <post@thorstenstrusch.de>
sub 2048g/3D7D81D5 2009-11-13 [verfällt: 2014-11-12]
</source>

Die Schlüssel ID ('''hier 0DDF17D0''') solltest du dir merken, wir brauche sie noch weiter unten.

== Passwortverwaltung mit gnupg-agent ==
Sowohl dpkg-buildpackage als auch dput verlangen beim Erstellen des Pakets bzw. beim Signieren oder Hochladen nach dem Passwort für den Schlüssel.
Damit man nicht immer wieder den key eintippen muss, kann sich der gpg Agent das Passwort Weile merken. Schreib dafür folgendes in deine ~/.bashrc

<source lang="bash">
GPG_TTY=`tty`
export GPG_TTY

# Für die Signierung des Archivs
if test -f $HOME/.gpg-agent-info && kill -0 `cut -d: -f 2 $HOME/.gpg-agent-info` 2>/dev/null; then
GPG_AGENT_INFO=`cat $HOME/.gpg-agent-info`
export GPG_AGENT_INFO
else
eval `gpg-agent --daemon`
echo $GPG_AGENT_INFO >$HOME/.gpg-agent-info
fi
</source>
Damit der agent überhaupt benutzt wird, muss man das in der gpg-Konfiguration freischalten:
<source lang="bash">
echo "use-agent" > ~/.gnupg/gpg.conf
</source>

=== Gnome Desktop ===
Unter dem Gnome Desktop kann die Anwengung seahorse aus dem gleichnamigen debian-Paket installiert werden. Es reicht ein <code>aptitude install seahorse</code>.

== öffentlichen Schlüssel bekannt geben ==
Damit du mit deinem Schlüssel signierte Pakete in das delixs-Repository hochladen darfst, muss du uns deinen öffentlichen Schlüssel geben.

Zuerst benötigst du die ID deines Schlüssels. Hier im Beispiel ist es die '''0DDF17D0'''
<source lang="bash">
$ gpg --list-keys
/home/thorsten/.gnupg/pubring.gpg
---------------------------------
pub 1024D/0DDF17D0 2009-11-13 [verfällt: 2014-11-12]
uid Thorsten Strusch <post@thorstenstrusch.de>
sub 2048g/3D7D81D5 2009-11-13 [verfällt: 2014-11-12]
</source>
Jetzt exportiere diesen Schlüssel mit der eben erfahrenen keyID in eine Datei. Wir wählen über den Schalter armor das ASCII-Format, weil man es per Mail verschicken kann, ohne Gefahr zu laufen, dass es dabei zersört wird.
<source lang="bash">
gpg --output $USERNAME.asc --armor --export 0DDF17D0
</source>
Maile die entstandene Datei (= der öffentliche Schlüssel deines gpg-keys) an die delixs-Mailingliste.

= Eine Emailadresse zum Schlüssel hinzufügen =
Meist hat man mehr als nur eine Emailadresse in Gebrauch, möchte aber
natürlich nur einen gpg-key benutzen.

Also muss eine weitere Identität zum Schlüssel hinzugefügt werden.
In diesem Beispiel füge ich meine Projektadressse th.strusch@delixs.de
hinzu:

<source lang="bash">
$ gpg --edit-key post@thorstenstrusch.de
gpg (GnuPG) 1.4.9; Copyright (C) 2008 Free Software Foundation, Inc.
This is free software: you are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law.

Geheimer Schlüssel ist vorhanden.

pub 1024D/0DDF17D0 erzeugt: 2009-11-13 verfällt: 2014-11-12 Aufruf: SC
Vertrauen: uneingeschränkt Gültigkeit: uneingeschränkt
sub 2048g/3D7D81D5 erzeugt: 2009-11-13 verfällt: 2014-11-12 Aufruf: E
[ uneing.] (1). Thorsten Strusch <post@thorstenstrusch.de>

Befehl> adduid
Ihr Name ("Vorname Nachname"): Thorsten Strusch
Email-Adresse: th.strusch@delixs.de
Kommentar:
Sie haben diese User-ID gewählt:
"Thorsten Strusch <th.strusch@delixs.de>"

Ändern: (N)ame, (K)ommentar, (E)-Mail oder (F)ertig/(B)eenden? F

Sie benötigen eine Passphrase, um den geheimen Schlüssel zu entsperren.
Benutzer: "Thorsten Strusch <post@thorstenstrusch.de>"
1024-Bit DSA Schlüssel, ID 0DDF17D0, erzeugt 2009-11-13

pub 1024D/0DDF17D0 erzeugt: 2009-11-13 verfällt: 2014-11-12 Aufruf: SC
Vertrauen: uneingeschränkt Gültigkeit: uneingeschränkt
sub 2048g/3D7D81D5 erzeugt: 2009-11-13 verfällt: 2014-11-12 Aufruf: E
[ uneing.] (1) Thorsten Strusch <post@thorstenstrusch.de>
[ unbek.] (2). Thorsten Strusch <th.strusch@delixs.de>

Befehl> quit
Änderungen speichern? ja
</source>

Mal schauen, ob es geklappt hat:
<source lang="bash">
$ gpg --list-keys
/home/thorsten/.gnupg/pubring.gpg
---------------------------------
pub 1024D/0DDF17D0 2009-11-13
uid Thorsten Strusch <post@thorstenstrusch.de>
uid Thorsten Strusch <th.strusch@delixs.de>
sub 2048g/3D7D81D5 2009-11-13 [verfällt: 2014-11-12]
</source>

= Links =
[http://wiki.debianforum.de/EigenesRepository wiki.debianforum.de/EigenesRepository]

Entwicklerhandbuch/GPG Schluessel

2009-11-14T08:46:26Z

ThorstenStrusch: /* privaten Schlüssel bekannt geben */ s#privaten#öffentlichen# - danke Hans-Dietrich!

Entwicklerhandbuch/GPG Schluessel

2009-11-14T01:20:51Z

ThorstenStrusch: /* Schlüssel erzeugen */

Entwicklerhandbuch/GPG Schluessel

2009-11-14T01:14:45Z

ThorstenStrusch: /* Passwortverwaltung mit gnupg-agent */ den gpg-agent benutzen.

Entwicklerhandbuch/GPG Schluessel

2009-11-14T01:06:42Z

ThorstenStrusch: gpg-key erstellen und in der ML bekannt machen. gpg-agent bedarf einer Überarbeitung

Benutzer:ThorstenStrusch

2009-11-14T00:38:01Z

ThorstenStrusch: für ein sicheres und gemeinsames Arbeit an einem debian Repository sollten jeder seine Pakete und Uploads mit seinem gpg-key unterschreiben.

Sandkasten für neue Artikel:

* [[ThorstenStrusch/developer:Paketverwaltung]]
* [[ThorstenStrusch/developer:gpg Schlüssel]]
* [[ThorstenStrusch/Infrastruktur:Repositorieverwaltung]]

== Kleine Shellkunde ==
=== arbeiten an der console ===

;STRG+k
: löscht vom aktuellen Punkt bis zum Zeilenende
;STRG+a bzw. HOME (manchmal heisst die Taste auch Pos1)
: springt an den Zeilenanfang
;STRG+e bzw Ende-Taste
: springt an das Zeilenende
;STRG+y
: fügt das zuletzt gelöschte an der aktuellen Cursor Position wieder ein

;ESC+d
: löscht das folgende Wort
;ESC+backspace
: löscht wortweise nach links
;ESC+b oder STRG+Pfeil links
: springt Wortweise zurück
; ESC+f oder STRG+Pfeil rechts
: springt wortweise vor
; STRG+h bzw backspace
: löscht einen Buchstaben nach links

;ESC+l
: schreibt das nächste Wort klein (l wie lower)
;ESC+u
: schreibt das nächste Wort gross (u wie upper)

;!! wiederholt den letzten Befehl
: hilfreich, wenn man z.B. als user "service apache2 restart" getippt
: hat aber wegen fehlender Rechte der Dienst nicht starten mag. Dann
: tippe ich in der Eingabeaufforderung "sudo !!" und die Shell führt
: "sudo service apache2 restart" aus

;Ersetzungen
: Ich tippe "grep suchwort /var/log/access.log.2" - aber die Suche ist
: nicht erfolgreich. Also mag ich im nächst älteren Logfile suchen
: und tippe "^2^3" Das führt zu einer Suche in der access.log.3
: oder
: Ich tippe "tar tvzf archiv.tar.gz", um mir den Inhalt anzusehen.
: Wenn ich es entpacken mag, tippe ich direkt danach "^tv^x" und der
: folgende Befehl wird ausgeführt: "tar xzf archiv.tar.gz".
: (Normalerweise müßte ich Pfeil hoch, Home, STRG+Pfeil rechts, entf,
: entf, x tippen.)

;Links
: http://www.debianhelp.de/kommandozeile.html

Entwicklerhandbuch/Paketverwaltung

2009-11-14T00:35:48Z

ThorstenStrusch: /* offizielles Repository aktivieren */

Hi Leute,

ich habe mich gestern Abend mit den drei Paketen dput, mini-dinstall
und svn-buildpackage beschäftigt.

= Einführung =
Installiere auf deinem debian/lenny Rechner die entsprechenden Pakete mit den folgenden Befehl:

<source lang="bash">
aptitude install dput mini-dinstall svn-buildpackage devscripts openssh-client
</source>

Arbeitest du unter gnome:
<source lang="bash">
aptitude install ssh-askpass-gnome
</source>
Arbeitest du unter kde:
<source lang="bash">
aptitude install ssh-askpass
</source>

== svn-buildpackage ==
Mit svn-buildpackage hast du die Möglichkeit debian Pakete
(die wir im SVN vohalten) für die entspr. Architekturen zu bauen.
Wir möchten i386 und amd64 unterstützen.
Es werden dabei binäre Debianpakete und source-Pakete erstellt.

Erstere erkennst du an der Dateiendung .deb, letztere bestehen aus
zwei Dateien. Eine endet auf dsc, die andere auf tar.gz.

Die source-Pakete kannst du herunterladen, wenn du in deiner
sources.list eine Zeile mit deb-src am Anfang stehen hast.
Die binären Dateien kannst du herunterladen, wenn du deb als
erstes Argument in der Zeile stehen hast.

svn-buildpackage erstellt ausserdem zu jedem Paket eine
<nowiki>$PAKETNAME_$VERSION-$UNTERVERSION_$ARCHITEKTUR.changes</nowiki> Datei.
(z.B. delixs-firstrun-config_0.1-58_all.deb)
Mit dieser Datei kann dput arbeiten.

'''INFO:'''
Zum Erstellen eines debian-Pakets sollten wir also nicht mehr
<code>fakeroot ./debian/rules binary</code> nutzen. Hierbei wird weder
die changes Datei noch die source-Dateien erstellt. Lasst uns also
wie später unten beschrieben mit dem alias svn-b arbeiten.

== dput ==
Dieses Programm ermöglicht es die binär- und source-Pakete in ein
debian Repository zu laden. Also auf solche 'Server', die du in der
/etc/apt/sources.list als Installationsquellen eintragen kannst.

dput unterstützt dabei mehrere Verfahren zum Hochladen, die wichtigsten
sind ftp,ssh/sftp und lokales Kopieren.

== mini-dinstall ==
dieses Programm erzeugt nun ein Repository mit allen Schickanen:

<source lang="bash">
$\tree
|-- delixs1
| |-- all
| | |-- Packages
| | |-- Packages.bz2
| | |-- Packages.gz
| | `-- Release
| |-- all.db
| |-- amd64
| | |-- Packages
| | |-- Packages.bz2
| | |-- Packages.gz
| | `-- Release
| |-- amd64.db
| |-- i386
| | |-- Packages
| | |-- Packages.bz2
| | |-- Packages.gz
| | `-- Release
| |-- i386.db
| `-- source
| |-- Sources
| |-- Sources.bz2
| `-- Sources.gz
</source>
* unter delixs/all liegen die architekturunabhängigen binären debian-Pakete (debs)
* unter delixs/amd64 liegen die binären amd64 debian-Pakete (debs)
* unter delixs/i386 liegen die binären i386 debian-Pakete (debs)
* unter source liegen alle Versionen dieser Pakete im source-Format. Jeweils eine dsc und eine tar.gz Datei

= apt-Konfiguration =
Um jetzt auch mit den frisch erstellten Repositories arbeiten zu können, sind zwei Dateien notwendig, die im Folgenden beschrieben werden.

Der Ausdruck $(ARCH) bewirkt, dass apt sich die PC Architektur selbst sucht. Das delixs-Projekt unterstützt i386 und amd64.

== lokales Repository aktivieren ==
Erstelle eine Datei /etc/apt/sources.list.d/file.list wie unten angegeben:
<source lang="apt_sources">
cat /etc/apt/sources.list.d/file.list
deb file:/home/thorsten/public_html/debian aramec/all
deb file:/home/thorsten/public_html/debian aramec/$(ARCH)/
deb-src file:/home/thorsten/public_html/debian aramec/source/
</source>
Als root führe <code>aptitude update</code> durch und das Repository ist eingebunden und einsatzfähig.
== offizielles Repository aktivieren ==
Erstelle eine Datei /etc/apt/sources.list.d/delixs.list wie unten angegeben:
<source lang="apt_sources">
cat /etc/apt/sources.list.d/aramec.list
deb file:/home/thorsten/public_html/debian aramec/all
deb file:/home/thorsten/public_html/debian aramec/$(ARCH)/
deb-src file:/home/thorsten/public_html/debian aramec/source/
</source>
Als root führe <code>aptitude update</code> durch und das Repository ist zwar eingebunden aber wegen eines noch nicht bekannten GPG-Schlüssels wird ihm nicht vertraut.

=== gpg Schlüssel importieren ===
'''XXX''' wird noch im Detail beschrieben
* manuell mit wget http://deb.delixs.de/debian/keyring.asc
* automatisch mittels aptitude install delixs-archive-keyring

= Konfiguration =

== alias svn-b ==
Wenn du ein Paket bauen und hochladen möchtest, rufst du dafür i.A. svn-buildpackage auf. Folgenden alias solltest du in deine ~/.bashrc packen:
<source lang="bash">
alias svn-b="svn-buildpackage -us -uc -rfakeroot --svn-ignore"
</source>
Damit reicht ein '''svn-b''' zum Bauen des Pakets. Es wird dann eine Ebene höher im Order '''build-area''' liegen.

== der Benutzer dupload ==

== dput Konfiguration ==
Mit der folgenden Konfiguration kennt dput zwei Ziele für den Paketupload
# local - deinen Rechner
# delixs - unser offizielles delixs-Repository

<source lang="properties">
$ cat ~/.dput.cf
[local]
method = local
hostname = localhost
incoming = ~/public_html/debian/mini-dinstall/incoming
run_dinstall = 0
allow_unsigned_uploads = 0
verify_sigs = 1
post_upload_command = /usr/bin/mini-dinstall --batch

[delixs]
fqdn = deb.delixs.de
method = sftp
incoming = ./
run_dinstall = 0
allow_unsigned_uploads = 0
verify_sigs = 1
</source>

== mini-dinstall Konfiguration ==
mini-dinstall soll mir ein Repository unter ~/public_html/delixs/ anlegen. Dafür ist folgende Konfiguration nötig:

<source lang="properties">
$ cat ~/.mini-dinstall.conf
# Adapted Colin's mini-dinstall.conf
# Infos unter /usr/share/doc/dput
# und http://debiananwenderhandbuch.de/mini-dinstall.html
[DEFAULT]
architectures = all, i386, amd64
archivedir = ~/public_html/delixs/
use_dnotify = 0
verify_sigs = 0
#extra_keyrings = ~/.gnupg/pubring.gpg
mail_on_success = 0
archive_style = simple-subdir
poll_time = 10
mail_log_level = NONE
generate_release = 1
release_description = delixs Packages
# Releases:
[aramec]
[testing]
</source>

== ssh Clientkonfiguration ==

Damit dput beim Hochladen auf den dev-server (deb.delixs.de) sich gleich mit den korrekten Einstellugnen wie dem Benutzer verbindet, leg dir die Datei ~/.ssh/config mit folgendem Inhalt an:
<source lang="bash">
host deb.delixs.de
CheckHostIP no
User dupload
Ciphers arcfour
Protocol 2
IdentityFile ~/.ssh/id_dsa.dupload
</source>

'''XXX''' Die Datei id_dsa.dupload bekommst du noch

== gpg-Schlüssel ==

Wenn du Pakete auf den dev-Server lädst, muss die Release Datei mit gpg signiert werden. Ansonsten würde jeder Server, der dieses Repository nutzt, über ein unsicheres Archiv meckern.

Darum musst du dich hier nicht kümmern, das erzeugt das Programm mini-dinstall auf dem Server. Bei dir im lokalen Repository brauchst du den Aufwand nicht treiben, lokal verfügbare Release-Dateien müssen nicht signiert werden.

= Beispiel =

Nachfolgend ein Beispiel, wo ich das (nicht existierende) Paket delixs-firstrun-config
in der Version 0.1-58 in das lokale Repository hochlade. Am Ende wird automatisch mini-dinstall ausgeführt.

<source lang="bash">
$ dput local delixs-firstrun-config_0.1-58_i3864.changes
$ \tree ~/public_html/debian/delixs1/
/home/thorsten/public_html/debian/delixs1/
|-- all
| |-- Packages
| |-- Packages.bz2
| |-- Packages.gz
| |-- Release
| `-- delixs-firstrun-config_0.1-58_all.deb
|-- all.db
|-- amd64
| |-- Packages
| |-- Packages.bz2
| |-- Packages.gz
| `-- Release
|-- amd64.db
|-- i386
| |-- Packages
| |-- Packages.bz2
| |-- Packages.gz
| `-- Release
|-- i386.db
|-- delixs-firstrun-config_0.1-58_i386.changes
`-- source
|-- Sources
|-- Sources.bz2
|-- Sources.gz
|-- delixs-firstrun-config_0.1-58.dsc
`-- delixs-firstrun-config_0.1-58.tar.gz

</source>

'''Erklärung:'''
* Unter all liegt das architekturunabhängige Paket delixs-firstrun-config_0.1-58_all.deb
* direkt im Ordner delixs1 liegt die changes-Datei.
* unter source liegen die beiden Dateien delixs-firstrun-config_0.1-58.{dsc,tar-gz}

Im Ordner, von dem du das Paket hochgeladen hast (wahrscheinlich build-area), wurde die Datei
delixs-firstrun-config_0.1-58_i386.upload angelegt. Der Inhalt:

<source lang="bash">
$ cat delixs-firstrun-config_0.1-58_i386.upload
Successfully uploaded delixs-firstrun-config_0.1-58.dsc to localhost.
Successfully uploaded delixs-firstrun-config_0.1-58.tar.gz to localhost.
Successfully uploaded delixs-firstrun-config_0.1-58_all.deb to localhost.
Successfully uploaded delixs-firstrun-config_0.1-58_i386.changes to localhost.
</source>
Durch dieses logfile weis dput, dass es die Datei nicht nochmal hochladen muss, wenn du es ein zweites Mal probieren solltest.

Entwicklerhandbuch/Paketverwaltung

2009-11-14T00:35:25Z

ThorstenStrusch: /* Konfiguration */ die source.list.d-Einträge für das lokale und das offz. Repository

Hi Leute,

ich habe mich gestern Abend mit den drei Paketen dput, mini-dinstall
und svn-buildpackage beschäftigt.

= Einführung =
Installiere auf deinem debian/lenny Rechner die entsprechenden Pakete mit den folgenden Befehl:

<source lang="bash">
aptitude install dput mini-dinstall svn-buildpackage devscripts openssh-client
</source>

Arbeitest du unter gnome:
<source lang="bash">
aptitude install ssh-askpass-gnome
</source>
Arbeitest du unter kde:
<source lang="bash">
aptitude install ssh-askpass
</source>

== svn-buildpackage ==
Mit svn-buildpackage hast du die Möglichkeit debian Pakete
(die wir im SVN vohalten) für die entspr. Architekturen zu bauen.
Wir möchten i386 und amd64 unterstützen.
Es werden dabei binäre Debianpakete und source-Pakete erstellt.

Erstere erkennst du an der Dateiendung .deb, letztere bestehen aus
zwei Dateien. Eine endet auf dsc, die andere auf tar.gz.

Die source-Pakete kannst du herunterladen, wenn du in deiner
sources.list eine Zeile mit deb-src am Anfang stehen hast.
Die binären Dateien kannst du herunterladen, wenn du deb als
erstes Argument in der Zeile stehen hast.

svn-buildpackage erstellt ausserdem zu jedem Paket eine
<nowiki>$PAKETNAME_$VERSION-$UNTERVERSION_$ARCHITEKTUR.changes</nowiki> Datei.
(z.B. delixs-firstrun-config_0.1-58_all.deb)
Mit dieser Datei kann dput arbeiten.

'''INFO:'''
Zum Erstellen eines debian-Pakets sollten wir also nicht mehr
<code>fakeroot ./debian/rules binary</code> nutzen. Hierbei wird weder
die changes Datei noch die source-Dateien erstellt. Lasst uns also
wie später unten beschrieben mit dem alias svn-b arbeiten.

== dput ==
Dieses Programm ermöglicht es die binär- und source-Pakete in ein
debian Repository zu laden. Also auf solche 'Server', die du in der
/etc/apt/sources.list als Installationsquellen eintragen kannst.

dput unterstützt dabei mehrere Verfahren zum Hochladen, die wichtigsten
sind ftp,ssh/sftp und lokales Kopieren.

== mini-dinstall ==
dieses Programm erzeugt nun ein Repository mit allen Schickanen:

<source lang="bash">
$\tree
|-- delixs1
| |-- all
| | |-- Packages
| | |-- Packages.bz2
| | |-- Packages.gz
| | `-- Release
| |-- all.db
| |-- amd64
| | |-- Packages
| | |-- Packages.bz2
| | |-- Packages.gz
| | `-- Release
| |-- amd64.db
| |-- i386
| | |-- Packages
| | |-- Packages.bz2
| | |-- Packages.gz
| | `-- Release
| |-- i386.db
| `-- source
| |-- Sources
| |-- Sources.bz2
| `-- Sources.gz
</source>
* unter delixs/all liegen die architekturunabhängigen binären debian-Pakete (debs)
* unter delixs/amd64 liegen die binären amd64 debian-Pakete (debs)
* unter delixs/i386 liegen die binären i386 debian-Pakete (debs)
* unter source liegen alle Versionen dieser Pakete im source-Format. Jeweils eine dsc und eine tar.gz Datei

= apt-Konfiguration =
Um jetzt auch mit den frisch erstellten Repositories arbeiten zu können, sind zwei Dateien notwendig, die im Folgenden beschrieben werden.

Der Ausdruck $(ARCH) bewirkt, dass apt sich die PC Architektur selbst sucht. Das delixs-Projekt unterstützt i386 und amd64.

== lokales Repository aktivieren ==
Erstelle eine Datei /etc/apt/sources.list.d/file.list wie unten angegeben:
<source lang="apt_sources">
cat /etc/apt/sources.list.d/file.list
deb file:/home/thorsten/public_html/debian aramec/all
deb file:/home/thorsten/public_html/debian aramec/$(ARCH)/
deb-src file:/home/thorsten/public_html/debian aramec/source/
</source>
Als root führe <code>aptitude update</code> durch und das Repository ist eingebunden und einsatzfähig.
== offizielles Repository aktivieren ==
<source lang="apt_sources">
cat /etc/apt/sources.list.d/aramec.list
deb file:/home/thorsten/public_html/debian aramec/all
deb file:/home/thorsten/public_html/debian aramec/$(ARCH)/
deb-src file:/home/thorsten/public_html/debian aramec/source/
</source>
Als root führe <code>aptitude update</code> durch und das Repository ist zwar eingebunden aber wegen eines noch nicht bekannten GPG-Schlüssels wird ihm nicht vertraut.

=== gpg Schlüssel importieren ===
'''XXX''' wird noch im Detail beschrieben
* manuell mit wget http://deb.delixs.de/debian/keyring.asc
* automatisch mittels aptitude install delixs-archive-keyring

= Konfiguration =

== alias svn-b ==
Wenn du ein Paket bauen und hochladen möchtest, rufst du dafür i.A. svn-buildpackage auf. Folgenden alias solltest du in deine ~/.bashrc packen:
<source lang="bash">
alias svn-b="svn-buildpackage -us -uc -rfakeroot --svn-ignore"
</source>
Damit reicht ein '''svn-b''' zum Bauen des Pakets. Es wird dann eine Ebene höher im Order '''build-area''' liegen.

== der Benutzer dupload ==

== dput Konfiguration ==
Mit der folgenden Konfiguration kennt dput zwei Ziele für den Paketupload
# local - deinen Rechner
# delixs - unser offizielles delixs-Repository

<source lang="properties">
$ cat ~/.dput.cf
[local]
method = local
hostname = localhost
incoming = ~/public_html/debian/mini-dinstall/incoming
run_dinstall = 0
allow_unsigned_uploads = 0
verify_sigs = 1
post_upload_command = /usr/bin/mini-dinstall --batch

[delixs]
fqdn = deb.delixs.de
method = sftp
incoming = ./
run_dinstall = 0
allow_unsigned_uploads = 0
verify_sigs = 1
</source>

== mini-dinstall Konfiguration ==
mini-dinstall soll mir ein Repository unter ~/public_html/delixs/ anlegen. Dafür ist folgende Konfiguration nötig:

<source lang="properties">
$ cat ~/.mini-dinstall.conf
# Adapted Colin's mini-dinstall.conf
# Infos unter /usr/share/doc/dput
# und http://debiananwenderhandbuch.de/mini-dinstall.html
[DEFAULT]
architectures = all, i386, amd64
archivedir = ~/public_html/delixs/
use_dnotify = 0
verify_sigs = 0
#extra_keyrings = ~/.gnupg/pubring.gpg
mail_on_success = 0
archive_style = simple-subdir
poll_time = 10
mail_log_level = NONE
generate_release = 1
release_description = delixs Packages
# Releases:
[aramec]
[testing]
</source>

== ssh Clientkonfiguration ==

Damit dput beim Hochladen auf den dev-server (deb.delixs.de) sich gleich mit den korrekten Einstellugnen wie dem Benutzer verbindet, leg dir die Datei ~/.ssh/config mit folgendem Inhalt an:
<source lang="bash">
host deb.delixs.de
CheckHostIP no
User dupload
Ciphers arcfour
Protocol 2
IdentityFile ~/.ssh/id_dsa.dupload
</source>

'''XXX''' Die Datei id_dsa.dupload bekommst du noch

== gpg-Schlüssel ==

Wenn du Pakete auf den dev-Server lädst, muss die Release Datei mit gpg signiert werden. Ansonsten würde jeder Server, der dieses Repository nutzt, über ein unsicheres Archiv meckern.

Darum musst du dich hier nicht kümmern, das erzeugt das Programm mini-dinstall auf dem Server. Bei dir im lokalen Repository brauchst du den Aufwand nicht treiben, lokal verfügbare Release-Dateien müssen nicht signiert werden.

= Beispiel =

Nachfolgend ein Beispiel, wo ich das (nicht existierende) Paket delixs-firstrun-config
in der Version 0.1-58 in das lokale Repository hochlade. Am Ende wird automatisch mini-dinstall ausgeführt.

<source lang="bash">
$ dput local delixs-firstrun-config_0.1-58_i3864.changes
$ \tree ~/public_html/debian/delixs1/
/home/thorsten/public_html/debian/delixs1/
|-- all
| |-- Packages
| |-- Packages.bz2
| |-- Packages.gz
| |-- Release
| `-- delixs-firstrun-config_0.1-58_all.deb
|-- all.db
|-- amd64
| |-- Packages
| |-- Packages.bz2
| |-- Packages.gz
| `-- Release
|-- amd64.db
|-- i386
| |-- Packages
| |-- Packages.bz2
| |-- Packages.gz
| `-- Release
|-- i386.db
|-- delixs-firstrun-config_0.1-58_i386.changes
`-- source
|-- Sources
|-- Sources.bz2
|-- Sources.gz
|-- delixs-firstrun-config_0.1-58.dsc
`-- delixs-firstrun-config_0.1-58.tar.gz

</source>

'''Erklärung:'''
* Unter all liegt das architekturunabhängige Paket delixs-firstrun-config_0.1-58_all.deb
* direkt im Ordner delixs1 liegt die changes-Datei.
* unter source liegen die beiden Dateien delixs-firstrun-config_0.1-58.{dsc,tar-gz}

Im Ordner, von dem du das Paket hochgeladen hast (wahrscheinlich build-area), wurde die Datei
delixs-firstrun-config_0.1-58_i386.upload angelegt. Der Inhalt:

<source lang="bash">
$ cat delixs-firstrun-config_0.1-58_i386.upload
Successfully uploaded delixs-firstrun-config_0.1-58.dsc to localhost.
Successfully uploaded delixs-firstrun-config_0.1-58.tar.gz to localhost.
Successfully uploaded delixs-firstrun-config_0.1-58_all.deb to localhost.
Successfully uploaded delixs-firstrun-config_0.1-58_i386.changes to localhost.
</source>
Durch dieses logfile weis dput, dass es die Datei nicht nochmal hochladen muss, wenn du es ein zweites Mal probieren solltest.

Entwicklerhandbuch/Paketverwaltung

2009-11-14T00:25:09Z

ThorstenStrusch: /* mini-dinstall Konfiguration */ aramec und testing reicht derzeit völlig aus

Hi Leute,

ich habe mich gestern Abend mit den drei Paketen dput, mini-dinstall
und svn-buildpackage beschäftigt.

= Einführung =
Installiere auf deinem debian/lenny Rechner die entsprechenden Pakete mit den folgenden Befehl:

<source lang="bash">
aptitude install dput mini-dinstall svn-buildpackage devscripts openssh-client
</source>

Arbeitest du unter gnome:
<source lang="bash">
aptitude install ssh-askpass-gnome
</source>
Arbeitest du unter kde:
<source lang="bash">
aptitude install ssh-askpass
</source>

== svn-buildpackage ==
Mit svn-buildpackage hast du die Möglichkeit debian Pakete
(die wir im SVN vohalten) für die entspr. Architekturen zu bauen.
Wir möchten i386 und amd64 unterstützen.
Es werden dabei binäre Debianpakete und source-Pakete erstellt.

Erstere erkennst du an der Dateiendung .deb, letztere bestehen aus
zwei Dateien. Eine endet auf dsc, die andere auf tar.gz.

Die source-Pakete kannst du herunterladen, wenn du in deiner
sources.list eine Zeile mit deb-src am Anfang stehen hast.
Die binären Dateien kannst du herunterladen, wenn du deb als
erstes Argument in der Zeile stehen hast.

svn-buildpackage erstellt ausserdem zu jedem Paket eine
<nowiki>$PAKETNAME_$VERSION-$UNTERVERSION_$ARCHITEKTUR.changes</nowiki> Datei.
(z.B. delixs-firstrun-config_0.1-58_all.deb)
Mit dieser Datei kann dput arbeiten.

'''INFO:'''
Zum Erstellen eines debian-Pakets sollten wir also nicht mehr
<code>fakeroot ./debian/rules binary</code> nutzen. Hierbei wird weder
die changes Datei noch die source-Dateien erstellt. Lasst uns also
wie später unten beschrieben mit dem alias svn-b arbeiten.

== dput ==
Dieses Programm ermöglicht es die binär- und source-Pakete in ein
debian Repository zu laden. Also auf solche 'Server', die du in der
/etc/apt/sources.list als Installationsquellen eintragen kannst.

dput unterstützt dabei mehrere Verfahren zum Hochladen, die wichtigsten
sind ftp,ssh/sftp und lokales Kopieren.

== mini-dinstall ==
dieses Programm erzeugt nun ein Repository mit allen Schickanen:

<source lang="bash">
$\tree
|-- delixs1
| |-- all
| | |-- Packages
| | |-- Packages.bz2
| | |-- Packages.gz
| | `-- Release
| |-- all.db
| |-- amd64
| | |-- Packages
| | |-- Packages.bz2
| | |-- Packages.gz
| | `-- Release
| |-- amd64.db
| |-- i386
| | |-- Packages
| | |-- Packages.bz2
| | |-- Packages.gz
| | `-- Release
| |-- i386.db
| `-- source
| |-- Sources
| |-- Sources.bz2
| `-- Sources.gz
</source>
* unter delixs/all liegen die architekturunabhängigen binären debian-Pakete (debs)
* unter delixs/amd64 liegen die binären amd64 debian-Pakete (debs)
* unter delixs/i386 liegen die binären i386 debian-Pakete (debs)
* unter source liegen alle Versionen dieser Pakete im source-Format. Jeweils eine dsc und eine tar.gz Datei

= Konfiguration =

== alias svn-b ==
Wenn du ein Paket bauen und hochladen möchtest, rufst du dafür i.A. svn-buildpackage auf. Folgenden alias solltest du in deine ~/.bashrc packen:
<source lang="bash">
alias svn-b="svn-buildpackage -us -uc -rfakeroot --svn-ignore"
</source>
Damit reicht ein '''svn-b''' zum Bauen des Pakets. Es wird dann eine Ebene höher im Order '''build-area''' liegen.

== der Benutzer dupload ==

== dput Konfiguration ==
Mit der folgenden Konfiguration kennt dput zwei Ziele für den Paketupload
# local - deinen Rechner
# delixs - unser offizielles delixs-Repository

<source lang="properties">
$ cat ~/.dput.cf
[local]
method = local
hostname = localhost
incoming = ~/public_html/debian/mini-dinstall/incoming
run_dinstall = 0
allow_unsigned_uploads = 0
verify_sigs = 1
post_upload_command = /usr/bin/mini-dinstall --batch

[delixs]
fqdn = deb.delixs.de
method = sftp
incoming = ./
run_dinstall = 0
allow_unsigned_uploads = 0
verify_sigs = 1
</source>

== mini-dinstall Konfiguration ==
mini-dinstall soll mir ein Repository unter ~/public_html/delixs/ anlegen. Dafür ist folgende Konfiguration nötig:

<source lang="properties">
$ cat ~/.mini-dinstall.conf
# Adapted Colin's mini-dinstall.conf
# Infos unter /usr/share/doc/dput
# und http://debiananwenderhandbuch.de/mini-dinstall.html
[DEFAULT]
architectures = all, i386, amd64
archivedir = ~/public_html/delixs/
use_dnotify = 0
verify_sigs = 0
#extra_keyrings = ~/.gnupg/pubring.gpg
mail_on_success = 0
archive_style = simple-subdir
poll_time = 10
mail_log_level = NONE
generate_release = 1
release_description = delixs Packages
# Releases:
[aramec]
[testing]
</source>

== ssh Clientkonfiguration ==

Damit dput beim Hochladen auf den dev-server (deb.delixs.de) sich gleich mit den korrekten Einstellugnen wie dem Benutzer verbindet, leg dir die Datei ~/.ssh/config mit folgendem Inhalt an:
<source lang="bash">
host deb.delixs.de
CheckHostIP no
User dupload
Ciphers arcfour
Protocol 2
IdentityFile ~/.ssh/id_dsa.dupload
</source>

'''XXX''' Die Datei id_dsa.dupload bekommst du noch

== gpg-Schlüssel ==

Wenn du Pakete auf den dev-Server lädst, muss die Release Datei mit gpg signiert werden. Ansonsten würde jeder Server, der dieses Repository nutzt, über ein unsicheres Archiv meckern.

Darum musst du dich hier nicht kümmern, das erzeugt das Programm mini-dinstall auf dem Server. Bei dir im lokalen Repository brauchst du den Aufwand nicht treiben, lokal verfügbare Release-Dateien müssen nicht signiert werden.

= Beispiel =

Nachfolgend ein Beispiel, wo ich das (nicht existierende) Paket delixs-firstrun-config
in der Version 0.1-58 in das lokale Repository hochlade. Am Ende wird automatisch mini-dinstall ausgeführt.

<source lang="bash">
$ dput local delixs-firstrun-config_0.1-58_i3864.changes
$ \tree ~/public_html/debian/delixs1/
/home/thorsten/public_html/debian/delixs1/
|-- all
| |-- Packages
| |-- Packages.bz2
| |-- Packages.gz
| |-- Release
| `-- delixs-firstrun-config_0.1-58_all.deb
|-- all.db
|-- amd64
| |-- Packages
| |-- Packages.bz2
| |-- Packages.gz
| `-- Release
|-- amd64.db
|-- i386
| |-- Packages
| |-- Packages.bz2
| |-- Packages.gz
| `-- Release
|-- i386.db
|-- delixs-firstrun-config_0.1-58_i386.changes
`-- source
|-- Sources
|-- Sources.bz2
|-- Sources.gz
|-- delixs-firstrun-config_0.1-58.dsc
`-- delixs-firstrun-config_0.1-58.tar.gz

</source>

'''Erklärung:'''
* Unter all liegt das architekturunabhängige Paket delixs-firstrun-config_0.1-58_all.deb
* direkt im Ordner delixs1 liegt die changes-Datei.
* unter source liegen die beiden Dateien delixs-firstrun-config_0.1-58.{dsc,tar-gz}

Im Ordner, von dem du das Paket hochgeladen hast (wahrscheinlich build-area), wurde die Datei
delixs-firstrun-config_0.1-58_i386.upload angelegt. Der Inhalt:

<source lang="bash">
$ cat delixs-firstrun-config_0.1-58_i386.upload
Successfully uploaded delixs-firstrun-config_0.1-58.dsc to localhost.
Successfully uploaded delixs-firstrun-config_0.1-58.tar.gz to localhost.
Successfully uploaded delixs-firstrun-config_0.1-58_all.deb to localhost.
Successfully uploaded delixs-firstrun-config_0.1-58_i386.changes to localhost.
</source>
Durch dieses logfile weis dput, dass es die Datei nicht nochmal hochladen muss, wenn du es ein zweites Mal probieren solltest.

Entwicklerhandbuch/Paketverwaltung

2009-11-14T00:24:32Z

ThorstenStrusch: /* dput Konfiguration */ fqdn ergänzt. Vorbereitungen auf die gpg Signierung getroffen

Hi Leute,

ich habe mich gestern Abend mit den drei Paketen dput, mini-dinstall
und svn-buildpackage beschäftigt.

= Einführung =
Installiere auf deinem debian/lenny Rechner die entsprechenden Pakete mit den folgenden Befehl:

<source lang="bash">
aptitude install dput mini-dinstall svn-buildpackage devscripts openssh-client
</source>

Arbeitest du unter gnome:
<source lang="bash">
aptitude install ssh-askpass-gnome
</source>
Arbeitest du unter kde:
<source lang="bash">
aptitude install ssh-askpass
</source>

== svn-buildpackage ==
Mit svn-buildpackage hast du die Möglichkeit debian Pakete
(die wir im SVN vohalten) für die entspr. Architekturen zu bauen.
Wir möchten i386 und amd64 unterstützen.
Es werden dabei binäre Debianpakete und source-Pakete erstellt.

Erstere erkennst du an der Dateiendung .deb, letztere bestehen aus
zwei Dateien. Eine endet auf dsc, die andere auf tar.gz.

Die source-Pakete kannst du herunterladen, wenn du in deiner
sources.list eine Zeile mit deb-src am Anfang stehen hast.
Die binären Dateien kannst du herunterladen, wenn du deb als
erstes Argument in der Zeile stehen hast.

svn-buildpackage erstellt ausserdem zu jedem Paket eine
<nowiki>$PAKETNAME_$VERSION-$UNTERVERSION_$ARCHITEKTUR.changes</nowiki> Datei.
(z.B. delixs-firstrun-config_0.1-58_all.deb)
Mit dieser Datei kann dput arbeiten.

'''INFO:'''
Zum Erstellen eines debian-Pakets sollten wir also nicht mehr
<code>fakeroot ./debian/rules binary</code> nutzen. Hierbei wird weder
die changes Datei noch die source-Dateien erstellt. Lasst uns also
wie später unten beschrieben mit dem alias svn-b arbeiten.

== dput ==
Dieses Programm ermöglicht es die binär- und source-Pakete in ein
debian Repository zu laden. Also auf solche 'Server', die du in der
/etc/apt/sources.list als Installationsquellen eintragen kannst.

dput unterstützt dabei mehrere Verfahren zum Hochladen, die wichtigsten
sind ftp,ssh/sftp und lokales Kopieren.

== mini-dinstall ==
dieses Programm erzeugt nun ein Repository mit allen Schickanen:

<source lang="bash">
$\tree
|-- delixs1
| |-- all
| | |-- Packages
| | |-- Packages.bz2
| | |-- Packages.gz
| | `-- Release
| |-- all.db
| |-- amd64
| | |-- Packages
| | |-- Packages.bz2
| | |-- Packages.gz
| | `-- Release
| |-- amd64.db
| |-- i386
| | |-- Packages
| | |-- Packages.bz2
| | |-- Packages.gz
| | `-- Release
| |-- i386.db
| `-- source
| |-- Sources
| |-- Sources.bz2
| `-- Sources.gz
</source>
* unter delixs/all liegen die architekturunabhängigen binären debian-Pakete (debs)
* unter delixs/amd64 liegen die binären amd64 debian-Pakete (debs)
* unter delixs/i386 liegen die binären i386 debian-Pakete (debs)
* unter source liegen alle Versionen dieser Pakete im source-Format. Jeweils eine dsc und eine tar.gz Datei

= Konfiguration =

== alias svn-b ==
Wenn du ein Paket bauen und hochladen möchtest, rufst du dafür i.A. svn-buildpackage auf. Folgenden alias solltest du in deine ~/.bashrc packen:
<source lang="bash">
alias svn-b="svn-buildpackage -us -uc -rfakeroot --svn-ignore"
</source>
Damit reicht ein '''svn-b''' zum Bauen des Pakets. Es wird dann eine Ebene höher im Order '''build-area''' liegen.

== der Benutzer dupload ==

== dput Konfiguration ==
Mit der folgenden Konfiguration kennt dput zwei Ziele für den Paketupload
# local - deinen Rechner
# delixs - unser offizielles delixs-Repository

<source lang="properties">
$ cat ~/.dput.cf
[local]
method = local
hostname = localhost
incoming = ~/public_html/debian/mini-dinstall/incoming
run_dinstall = 0
allow_unsigned_uploads = 0
verify_sigs = 1
post_upload_command = /usr/bin/mini-dinstall --batch

[delixs]
fqdn = deb.delixs.de
method = sftp
incoming = ./
run_dinstall = 0
allow_unsigned_uploads = 0
verify_sigs = 1
</source>

== mini-dinstall Konfiguration ==
mini-dinstall soll mir ein Repository unter ~/public_html/delixs/ anlegen. Dafür ist folgende Konfiguration nötig:

<source lang="properties">
$ cat ~/.mini-dinstall.conf
# Adapted Colin's mini-dinstall.conf
# Infos unter /usr/share/doc/dput
# und http://debiananwenderhandbuch.de/mini-dinstall.html
[DEFAULT]
architectures = all, i386, amd64
archivedir = ~/public_html/delixs/
use_dnotify = 0
verify_sigs = 0
#extra_keyrings = ~/.gnupg/pubring.gpg
mail_on_success = 0
archive_style = simple-subdir
poll_time = 10
mail_log_level = NONE
generate_release = 1
release_description = delixs Packages
# Releases:
[aramec]
[delixs1]
[delixs1-testing]
</source>

== ssh Clientkonfiguration ==

Damit dput beim Hochladen auf den dev-server (deb.delixs.de) sich gleich mit den korrekten Einstellugnen wie dem Benutzer verbindet, leg dir die Datei ~/.ssh/config mit folgendem Inhalt an:
<source lang="bash">
host deb.delixs.de
CheckHostIP no
User dupload
Ciphers arcfour
Protocol 2
IdentityFile ~/.ssh/id_dsa.dupload
</source>

'''XXX''' Die Datei id_dsa.dupload bekommst du noch

== gpg-Schlüssel ==

Wenn du Pakete auf den dev-Server lädst, muss die Release Datei mit gpg signiert werden. Ansonsten würde jeder Server, der dieses Repository nutzt, über ein unsicheres Archiv meckern.

Darum musst du dich hier nicht kümmern, das erzeugt das Programm mini-dinstall auf dem Server. Bei dir im lokalen Repository brauchst du den Aufwand nicht treiben, lokal verfügbare Release-Dateien müssen nicht signiert werden.

= Beispiel =

Nachfolgend ein Beispiel, wo ich das (nicht existierende) Paket delixs-firstrun-config
in der Version 0.1-58 in das lokale Repository hochlade. Am Ende wird automatisch mini-dinstall ausgeführt.

<source lang="bash">
$ dput local delixs-firstrun-config_0.1-58_i3864.changes
$ \tree ~/public_html/debian/delixs1/
/home/thorsten/public_html/debian/delixs1/
|-- all
| |-- Packages
| |-- Packages.bz2
| |-- Packages.gz
| |-- Release
| `-- delixs-firstrun-config_0.1-58_all.deb
|-- all.db
|-- amd64
| |-- Packages
| |-- Packages.bz2
| |-- Packages.gz
| `-- Release
|-- amd64.db
|-- i386
| |-- Packages
| |-- Packages.bz2
| |-- Packages.gz
| `-- Release
|-- i386.db
|-- delixs-firstrun-config_0.1-58_i386.changes
`-- source
|-- Sources
|-- Sources.bz2
|-- Sources.gz
|-- delixs-firstrun-config_0.1-58.dsc
`-- delixs-firstrun-config_0.1-58.tar.gz

</source>

'''Erklärung:'''
* Unter all liegt das architekturunabhängige Paket delixs-firstrun-config_0.1-58_all.deb
* direkt im Ordner delixs1 liegt die changes-Datei.
* unter source liegen die beiden Dateien delixs-firstrun-config_0.1-58.{dsc,tar-gz}

Im Ordner, von dem du das Paket hochgeladen hast (wahrscheinlich build-area), wurde die Datei
delixs-firstrun-config_0.1-58_i386.upload angelegt. Der Inhalt:

<source lang="bash">
$ cat delixs-firstrun-config_0.1-58_i386.upload
Successfully uploaded delixs-firstrun-config_0.1-58.dsc to localhost.
Successfully uploaded delixs-firstrun-config_0.1-58.tar.gz to localhost.
Successfully uploaded delixs-firstrun-config_0.1-58_all.deb to localhost.
Successfully uploaded delixs-firstrun-config_0.1-58_i386.changes to localhost.
</source>
Durch dieses logfile weis dput, dass es die Datei nicht nochmal hochladen muss, wenn du es ein zweites Mal probieren solltest.

Entwicklungsumgebung/Sysadm

2009-11-08T19:37:24Z

ThorstenStrusch: /* Einrichtung */ bash ist hier wichtig, mit der dsh wirds so nicht funktionieren

__NOTOC__
{{Uberarbeiten}}

== Systemadministration (der Nutzer: sysadm) ==
=== Installation ===

aptitude install xorg
aptitude install lxde
aptitude install iceweasel
aptitude install iceweasel-l10n-de

=== Konfiguration für Reboot, Shutdown und Suspend ===

Normale Nutzer haben eigentlich keinen Zugriff zum HAL power Management. Um das zu ändern, wird sysadm zur Gruppe "powerdev" hinzugefügt.

Geben Sie als root folgenden Befehl ein:

gpasswd -a sysadm powerdev

=== Einrichtung ===

automatisches starten und beenden X.ORG

in der /home/service/sysadm/.bashrc

if [ ! -e /tmp/.X*-lock ]; then
startx && logout;
fi

wenn X.ORG gestartet wird, dann soll auch Iceweasel gestartet werden

in der /home/service/sysadm/.xinitrc (neu angelegt!)

#!/bin/sh
#
# nur Browser
/usr/bin/openbox & display -window root /usr/share/lxde/wallpapers/delixs4.png & /usr/bin/iceweasel http://localhost/ && exit;
#
# oder alternativ kompletter Desktop
#exec startlxde

Openbox ist der Fenstermanager, der mit lxde automatisch installiert wurde.

Anmelden als sysadm startet nun automatisch X-Window und auch den
Browser. Das Beenden des Browsers beendet auch X-Window und man wird
auch gleich ausgeloggt.

In der Datei "/home/service/sysadm/.config/openbox/rc.xml" wird noch der Knopf zum minimieren abgestellt, damit das einzige Browserfenster nicht verschwinden kann. Dazu entfernen Sie das I aus der Zeichenkette (aus NLIMC wird also NLMC):

<source lang="xml">
<theme>
<name>Clearlooks</name>
<titleLayout>NLMC</titleLayout>
<keepBorder>yes</keepBorder>
...
</source>

Die openbox config kann auch automatisch erstellt und angepasst werden, wobei "sed -i" ein 'infile editing' bedeutet:

<source lang="bash">
#!/bin/bash
PFAD="/home/services/sysadm/.config/openbox/"
mkdir -p $PFAD
cp /etc/xdg/openbox/rc.xml ${PFAD}/
chown -R sysadm: ${PFAD%%.*}
sed -i '/titleLayout/{s#I##;p}' ${PFAD}/rc.xml
</source>

== Weblinks ==

* http://wiki.lxde.org/de/LXDE_Debian
* http://wiki.debian.org/EasyLXDE

----
<div align="right">[[Installation:Entwicklungsumgebung|zurück]] | [[Hauptseite]]</div>

Diskussion:Entwicklungsumgebung/Sysadm

2009-11-05T20:56:39Z

ThorstenStrusch: Vorschlag zum Automatischen Erstellen der angepaßten openbox config

'''Vorschlag:'''
Die openbox config könnte wie folgt automatisch erstellt und angepaßt werden - bitte einmal prüfen
<source lang="bash">
PFAD="/home/services/sysadm/.config/openbox/"
mkdir -p $PFAD
cp /etc/xdg/openbox/rc.xml ${PFAD}/
chown -R sysadm: ${PFAD%%.*}
sed -i '/titleLayout/{s#I##;p}' ${PFAD}/rc.xml
</source>
[[Benutzer:ThorstenStrusch|ThorstenStrusch]] 20:56, 5. Nov. 2009 (UTC)

Benutzer:ThorstenStrusch

2009-10-27T09:04:28Z

ThorstenStrusch: /* arbeiten an der console */

Sandkasten für neue Artikel:

* [[ThorstenStrusch/developer:Paketverwaltung]]
* [[ThorstenStrusch/Infrastruktur:Repositorieverwaltung]]

== Kleine Shellkunde ==
=== arbeiten an der console ===

;STRG+k
: löscht vom aktuellen Punkt bis zum Zeilenende
;STRG+a bzw. HOME (manchmal heisst die Taste auch Pos1)
: springt an den Zeilenanfang
;STRG+e bzw Ende-Taste
: springt an das Zeilenende
;STRG+y
: fügt das zuletzt gelöschte an der aktuellen Cursor Position wieder ein

;ESC+d
: löscht das folgende Wort
;ESC+backspace
: löscht wortweise nach links
;ESC+b oder STRG+Pfeil links
: springt Wortweise zurück
; ESC+f oder STRG+Pfeil rechts
: springt wortweise vor
; STRG+h bzw backspace
: löscht einen Buchstaben nach links

;ESC+l
: schreibt das nächste Wort klein (l wie lower)
;ESC+u
: schreibt das nächste Wort gross (u wie upper)

;!! wiederholt den letzten Befehl
: hilfreich, wenn man z.B. als user "service apache2 restart" getippt
: hat aber wegen fehlender Rechte der Dienst nicht starten mag. Dann
: tippe ich in der Eingabeaufforderung "sudo !!" und die Shell führt
: "sudo service apache2 restart" aus

;Ersetzungen
: Ich tippe "grep suchwort /var/log/access.log.2" - aber die Suche ist
: nicht erfolgreich. Also mag ich im nächst älteren Logfile suchen
: und tippe "^2^3" Das führt zu einer Suche in der access.log.3
: oder
: Ich tippe "tar tvzf archiv.tar.gz", um mir den Inhalt anzusehen.
: Wenn ich es entpacken mag, tippe ich direkt danach "^tv^x" und der
: folgende Befehl wird ausgeführt: "tar xzf archiv.tar.gz".
: (Normalerweise müßte ich Pfeil hoch, Home, STRG+Pfeil rechts, entf,
: entf, x tippen.)

;Links
: http://www.debianhelp.de/kommandozeile.html

Benutzer:ThorstenStrusch

2009-10-27T07:54:03Z

ThorstenStrusch: kleine Shellkunde - arbeiten an der Kommandozeile

Sandkasten für neue Artikel:

* [[ThorstenStrusch/developer:Paketverwaltung]]
* [[ThorstenStrusch/Infrastruktur:Repositorieverwaltung]]

== Kleine Shellkunde ==
=== arbeiten an der console ===

;STRG+k
: löscht vom aktuellen Punkt bis zum Zeilenende
;STRG+a bzw. HOME (Pos1
: springt an den Zeilenanfang
;STRG+e bzw Ende-Taste
: springt an das Zeilenende
;STRG+y
: fügt das zuletzt gelöschte an der aktuellen Cursor Position wieder ein

;ESC+d
: löscht das folgende Wort
;ESC+backspace
: löscht wortweise nach links
: ESC+b oder STRG+Pfeil links
: springt Wortweise zurück
; ESC+f oder STRG+Pfeil rechts
: springt wortweise vor

manchmal nützlich:
;ESC+l
: schreibt das nächste Wort klein (l wie lower)
;ESC+u
: schreibt das nächste Wort gross (u wie upper)

;!! wiederholt den letzten Befehl
: hilfreich, wenn man z.B. als user "service apache2 restart" getippt
: hat aber wegen fehlender Rechte der Dienst nicht starten mag. Dann
: tippe ich in der Eingabeaufforderung "sudo !!" und die Shell führt
: "sudo service apache2 restart" aus

;Ersetzungen
: Ich tippe "grep suchwort /var/log/access.log.2" - aber die Suche ist
: nicht erfolgreich. Also mag ich im nächst älteren Logfile suchen
: und tippe "^2^3" Das führt zu einer Suche in der access.log.3
: oder
: Ich tippe "tar tvzf archiv.tar.gz", um mir den Inhalt anzusehen.
: Wenn ich es entpacken mag, tippe ich direkt danach "^tv^x" und der
: folgende Befehl wird ausgeführt: "tar xzf archiv.tar.gz".
: (Normalerweise müßte ich Pfeil hoch, Home, STRG+Pfeil rechts, entf,
: entf, x tippen.)

;Links
: http://www.debianhelp.de/kommandozeile.html

Entwicklungsumgebung/Userverwaltung

2009-10-25T13:02:36Z

ThorstenStrusch: /* Scripte installieren */ v0.4 -> v0.5

__NOTOC__
{{Uberarbeiten}}

== Scripte installieren ==

Laden Sie die aktuelle Version (derzeit v0.5) herunter

cd
wget http://dev.delixs.de/download/delixs-scripts_0.5_all.deb
dpkg -i delixs-scripts_0.5_all.deb

== Scriptbeschreibungen ==

=== Scripte zur Userverwaltung ===

[[Benutzer:Kirmse/delixs-groupadd|Eintragen von Usern in eine Delixs-Gruppe]]

[[Benutzer:Kirmse/delixs-groupdel|Löschen von Usern in eine Delixs-Gruppe]]

[[Benutzer:Kirmse/delixs-grouplist|Auflisten der User einer Delixs-Gruppe]]

[[Benutzer:Kirmse/delixs-pooladd|Eintragen von DHCP-Pools im LDAP]]

[[Benutzer:Kirmse/delixs-pooldel|Löschen von DHCP-Pools im LDAP]]

[[Benutzer:Kirmse/delixs-poollist|Auflisten der DHCP-Pools im LDAP (zu einem Teilnetz)]]

[[Benutzer:Kirmse/delixs-hostadd|Eintragen von DHCP-Hosts im LDAP]]

[[Benutzer:Kirmse/delixs-hostlist|Auflisten von DHCP-Hosts von einem Pool]]

[[Benutzer:Kirmse/delixs-hostdel|Löschen von DHCP-Hosts aus einem Pool]]

[[Benutzer:Kirmse/delixs-machinelist|Auflisten der (Windows-)Rechner im LDAP]]

[[Benutzer:Kirmse/delixs-userlist|Auflisten von Usern (Lehrer, Schülern, Klassen)]]

[[Kirmse/Userliste | Userliste ]]

[[Benutzer:Kirmse/delixs-classmod|Versetzen von Schülern oder Klassen]]

[[Benutzer:Kirmse/delixs-usermod|Aktualisieren der Daten eines Users (GECOS)]]

[[Benutzer:Kirmse/delixs-userdel|Löschen von Usern oder Klassen]]

[[Benutzer:Kirmse/delixs-userpasswd|Ändern des Passwortes von Usern]]

=== Scripte zur Rechner- und Raumverwaltung ===

[[Kirmse/Anmeldekontrolle | smbstatus2html.cgi]]

[[Kirmse/Qotakontrolle | quota.cgi]]

[[Kirmse/Surfkontrolle | proxy.cgi]]

zugang.cgi

== Weblinks ==

* http://dev.delixs.de/download/

----
<div align="right">[[Installation:Entwicklungsumgebung|zurück]] | [[Hauptseite]]</div>

Hans-Dietrich Kirmse 2009

Entwicklerhandbuch/Repositorieverwaltung

2009-10-10T11:37:06Z

ThorstenStrusch: /* Aufbau des Repositories */

'''Auf dieser Seite wird das Setup des dev-servers beschrieben. Möglicherweise gehört diese Seite ins trac!'''
= Funktionsweise =
Der Benutzer '''dupload''' hat über die sshd_config ein chroot unterhalb von ''$REPOSITORYROOT/mini-dinstall/incoming'' und darf nur sftp benutzen. Ein login ist ausschliesslich über einen ssh-key möglich.

incron überwacht das Repository auf eine .changes-Datei und stößt nach einem ''"IN_MODIFY,IN_CREATE"'' das Script mini-dinstall --batch aus.
Die Pakete werden daraufhin einsortiert und die Releases signiert.

= Aufbau des Repositories =
* URL: deb.delixs.de
* aramec für den 1. Wurf
* delixs1 für lenny als Unterbau
* delixs2 für squeezy als Unterbau

= Konfigurationen =
Nachfolgend Vorschläge über die Konfigurationsdateien der beteiligten Dienste
== Apache ==
<source lang="apache">
deb.delixs.de
</source>
== mini-dinstall ==
Pfad wo das Repository auf dem dev-Server liegt: '''/home/deb.delixs.de'''

=> '''Wollen wir mini-dinstall als root oder als seperater User laufen lassen?'''

<source lang="properties">
$ cat /home/$USER/.mini-dinstall.conf
# Adapted Colin's mini-dinstall.conf
# Infos unter /usr/share/doc/dput
# und http://debiananwenderhandbuch.de/mini-dinstall.html
[DEFAULT]
architectures = all, i386
archivedir = /home/deb.delixs.de/delixs/
use_dnotify = 0
verify_sigs = 0
# aktivieren, sobald key erzeugt ist
#extra_keyrings = ~/.gnupg/pubring.gpg
mail_on_success = 1
archive_style = simple-subdir
poll_time = 10
mail_log_level = NONE
generate_release = 1
release_description = delixs Packages
# Releases:
[aramec]
[delixs1]
[delixs1-testing]
</source>

== Benutzer dupload ==
Um nicht allen Entwicklern einen ssh-login auf dem dev-server geben zu müssen, legen wir den Benutzer dupload ''(debian-upload)'' ein, der im incoming Verzeichnis von mini-dinstall eingesperrt ist. Für ihn lassen wir ausschliesslich einen Zugang per ssh-key zu.

Sollte einmal der private-Teil verloren gehen, muss er bei allen Entwicklern ausgetauscht werden.

== sftp-chroot ==
Der Benutzer dupload bekommt keine loginshell, er darf nur sftp zum Hoch/runterladen benutzen:
<source lang="bash">
Subsystem sftp internal-sftp
Match user dupload
ChrootDirectory $REPOSITORYROOT/mini-dinstall/incoming
X11Forwarding no
AllowTcpForwarding no
ForceCommand internal-sftp
</source>

== incron Setup ==
brauchen wir ein seperates incron-setup oder funktioniert auch der dnotify-Support unter lenny?

== gpg-key ==
Zwei Möglichkeiten
# wir hinterlegen das Passwort auf der Platte im Klartext
# wir benutzen den gpg-agent, der es eine Weile im Speicher behält

Nachteil bei Möglichkeit 1: unsicher<br>
Nachteil bei Möglichkeit 2: man muss mind. nach jedem Reboot den agent wieder mit dem PW füttern

Entwicklerhandbuch/Paketverwaltung

2009-10-10T11:33:10Z

ThorstenStrusch: /* Einführung */

Hi Leute,

ich habe mich gestern Abend mit den drei Paketen dput, mini-dinstall
und svn-buildpackage beschäftigt.

= Einführung =
Installiere auf deinem debian/lenny Rechner die entsprechenden Pakete mit den folgenden Befehl:

<source lang="bash">
aptitude install dput mini-dinstall svn-buildpackage devscripts openssh-client
</source>

Arbeitest du unter gnome:
<source lang="bash">
aptitude install ssh-askpass-gnome
</source>
Arbeitest du unter kde:
<source lang="bash">
aptitude install ssh-askpass
</source>

== svn-buildpackage ==
Mit svn-buildpackage hast du die Möglichkeit debian Pakete
(die wir im SVN vohalten) für die entspr. Architekturen zu bauen.
Wir möchten i386 und amd64 unterstützen.
Es werden dabei binäre Debianpakete und source-Pakete erstellt.

Erstere erkennst du an der Dateiendung .deb, letztere bestehen aus
zwei Dateien. Eine endet auf dsc, die andere auf tar.gz.

Die source-Pakete kannst du herunterladen, wenn du in deiner
sources.list eine Zeile mit deb-src am Anfang stehen hast.
Die binären Dateien kannst du herunterladen, wenn du deb als
erstes Argument in der Zeile stehen hast.

svn-buildpackage erstellt ausserdem zu jedem Paket eine
<nowiki>$PAKETNAME_$VERSION-$UNTERVERSION_$ARCHITEKTUR.changes</nowiki> Datei.
(z.B. delixs-firstrun-config_0.1-58_all.deb)
Mit dieser Datei kann dput arbeiten.

'''INFO:'''
Zum Erstellen eines debian-Pakets sollten wir also nicht mehr
<code>fakeroot ./debian/rules binary</code> nutzen. Hierbei wird weder
die changes Datei noch die source-Dateien erstellt. Lasst uns also
wie später unten beschrieben mit dem alias svn-b arbeiten.

== dput ==
Dieses Programm ermöglicht es die binär- und source-Pakete in ein
debian Repository zu laden. Also auf solche 'Server', die du in der
/etc/apt/sources.list als Installationsquellen eintragen kannst.

dput unterstützt dabei mehrere Verfahren zum Hochladen, die wichtigsten
sind ftp,ssh/sftp und lokales Kopieren.

== mini-dinstall ==
dieses Programm erzeugt nun ein Repository mit allen Schickanen:

<source lang="bash">
$\tree
|-- delixs1
| |-- all
| | |-- Packages
| | |-- Packages.bz2
| | |-- Packages.gz
| | `-- Release
| |-- all.db
| |-- amd64
| | |-- Packages
| | |-- Packages.bz2
| | |-- Packages.gz
| | `-- Release
| |-- amd64.db
| |-- i386
| | |-- Packages
| | |-- Packages.bz2
| | |-- Packages.gz
| | `-- Release
| |-- i386.db
| `-- source
| |-- Sources
| |-- Sources.bz2
| `-- Sources.gz
</source>
* unter delixs/all liegen die architekturunabhängigen binären debian-Pakete (debs)
* unter delixs/amd64 liegen die binären amd64 debian-Pakete (debs)
* unter delixs/i386 liegen die binären i386 debian-Pakete (debs)
* unter source liegen alle Versionen dieser Pakete im source-Format. Jeweils eine dsc und eine tar.gz Datei

= Konfiguration =

== alias svn-b ==
Wenn du ein Paket bauen und hochladen möchtest, rufst du dafür i.A. svn-buildpackage auf. Folgenden alias solltest du in deine ~/.bashrc packen:
<source lang="bash">
alias svn-b="svn-buildpackage -us -uc -rfakeroot --svn-ignore"
</source>
Damit reicht ein '''svn-b''' zum Bauen des Pakets. Es wird dann eine Ebene höher im Order '''build-area''' liegen.

== der Benutzer dupload ==

== dput Konfiguration ==
Mit der folgenden Konfiguration kennt dput zwei Ziele für den Paketupload
# local - deinen Rechner
# delixs - unser offizielles delixs-Repository

<source lang="properties">
$ cat ~/.dput.cf
[local]
method = local
hostname = localhost
incoming = ~/public_html/debian/mini-dinstall/incoming
run_dinstall = 0
allow_unsigned_uploads = 1
verify_sigs = 0
post_upload_command = /usr/bin/mini-dinstall --batch

[delixs]
method = sftp
hostname = deb.delixs.de
incoming = ./
run_dinstall = 0
verify_sigs = 0
</source>

== mini-dinstall Konfiguration ==
mini-dinstall soll mir ein Repository unter ~/public_html/delixs/ anlegen. Dafür ist folgende Konfiguration nötig:

<source lang="properties">
$ cat ~/.mini-dinstall.conf
# Adapted Colin's mini-dinstall.conf
# Infos unter /usr/share/doc/dput
# und http://debiananwenderhandbuch.de/mini-dinstall.html
[DEFAULT]
architectures = all, i386, amd64
archivedir = ~/public_html/delixs/
use_dnotify = 0
verify_sigs = 0
#extra_keyrings = ~/.gnupg/pubring.gpg
mail_on_success = 0
archive_style = simple-subdir
poll_time = 10
mail_log_level = NONE
generate_release = 1
release_description = delixs Packages
# Releases:
[aramec]
[delixs1]
[delixs1-testing]
</source>

== ssh Clientkonfiguration ==

Damit dput beim Hochladen auf den dev-server (deb.delixs.de) sich gleich mit den korrekten Einstellugnen wie dem Benutzer verbindet, leg dir die Datei ~/.ssh/config mit folgendem Inhalt an:
<source lang="bash">
host deb.delixs.de
CheckHostIP no
User dupload
Ciphers arcfour
Protocol 2
IdentityFile ~/.ssh/id_dsa.dupload
</source>

'''XXX''' Die Datei id_dsa.dupload bekommst du noch

== gpg-Schlüssel ==

Wenn du Pakete auf den dev-Server lädst, muss die Release Datei mit gpg signiert werden. Ansonsten würde jeder Server, der dieses Repository nutzt, über ein unsicheres Archiv meckern.

Darum musst du dich hier nicht kümmern, das erzeugt das Programm mini-dinstall auf dem Server. Bei dir im lokalen Repository brauchst du den Aufwand nicht treiben, lokal verfügbare Release-Dateien müssen nicht signiert werden.

= Beispiel =

Nachfolgend ein Beispiel, wo ich das (nicht existierende) Paket delixs-firstrun-config
in der Version 0.1-58 in das lokale Repository hochlade. Am Ende wird automatisch mini-dinstall ausgeführt.

<source lang="bash">
$ dput local delixs-firstrun-config_0.1-58_i3864.changes
$ \tree ~/public_html/debian/delixs1/
/home/thorsten/public_html/debian/delixs1/
|-- all
| |-- Packages
| |-- Packages.bz2
| |-- Packages.gz
| |-- Release
| `-- delixs-firstrun-config_0.1-58_all.deb
|-- all.db
|-- amd64
| |-- Packages
| |-- Packages.bz2
| |-- Packages.gz
| `-- Release
|-- amd64.db
|-- i386
| |-- Packages
| |-- Packages.bz2
| |-- Packages.gz
| `-- Release
|-- i386.db
|-- delixs-firstrun-config_0.1-58_i386.changes
`-- source
|-- Sources
|-- Sources.bz2
|-- Sources.gz
|-- delixs-firstrun-config_0.1-58.dsc
`-- delixs-firstrun-config_0.1-58.tar.gz

</source>

'''Erklärung:'''
* Unter all liegt das architekturunabhängige Paket delixs-firstrun-config_0.1-58_all.deb
* direkt im Ordner delixs1 liegt die changes-Datei.
* unter source liegen die beiden Dateien delixs-firstrun-config_0.1-58.{dsc,tar-gz}

Im Ordner, von dem du das Paket hochgeladen hast (wahrscheinlich build-area), wurde die Datei
delixs-firstrun-config_0.1-58_i386.upload angelegt. Der Inhalt:

<source lang="bash">
$ cat delixs-firstrun-config_0.1-58_i386.upload
Successfully uploaded delixs-firstrun-config_0.1-58.dsc to localhost.
Successfully uploaded delixs-firstrun-config_0.1-58.tar.gz to localhost.
Successfully uploaded delixs-firstrun-config_0.1-58_all.deb to localhost.
Successfully uploaded delixs-firstrun-config_0.1-58_i386.changes to localhost.
</source>
Durch dieses logfile weis dput, dass es die Datei nicht nochmal hochladen muss, wenn du es ein zweites Mal probieren solltest.

Entwicklerhandbuch/Paketverwaltung

2009-10-10T11:32:57Z

ThorstenStrusch: /* Einführung */

Hi Leute,

ich habe mich gestern Abend mit den drei Paketen dput, mini-dinstall
und svn-buildpackage beschäftigt.

= Einführung =
Installiere auf deinem debian/lenny Rechner die entsprechenden Pakete mit den folgenden Befehl:

<source lang="bash">
# aptitude install dput mini-dinstall svn-buildpackage devscripts openssh-client
</source>

Arbeitest du unter gnome:
<source lang="bash">
# aptitude install ssh-askpass-gnome
</source>
Arbeitest du unter kde:
<source lang="bash">
# aptitude install ssh-askpass
</source>

== svn-buildpackage ==
Mit svn-buildpackage hast du die Möglichkeit debian Pakete
(die wir im SVN vohalten) für die entspr. Architekturen zu bauen.
Wir möchten i386 und amd64 unterstützen.
Es werden dabei binäre Debianpakete und source-Pakete erstellt.

Erstere erkennst du an der Dateiendung .deb, letztere bestehen aus
zwei Dateien. Eine endet auf dsc, die andere auf tar.gz.

Die source-Pakete kannst du herunterladen, wenn du in deiner
sources.list eine Zeile mit deb-src am Anfang stehen hast.
Die binären Dateien kannst du herunterladen, wenn du deb als
erstes Argument in der Zeile stehen hast.

svn-buildpackage erstellt ausserdem zu jedem Paket eine
<nowiki>$PAKETNAME_$VERSION-$UNTERVERSION_$ARCHITEKTUR.changes</nowiki> Datei.
(z.B. delixs-firstrun-config_0.1-58_all.deb)
Mit dieser Datei kann dput arbeiten.

'''INFO:'''
Zum Erstellen eines debian-Pakets sollten wir also nicht mehr
<code>fakeroot ./debian/rules binary</code> nutzen. Hierbei wird weder
die changes Datei noch die source-Dateien erstellt. Lasst uns also
wie später unten beschrieben mit dem alias svn-b arbeiten.

== dput ==
Dieses Programm ermöglicht es die binär- und source-Pakete in ein
debian Repository zu laden. Also auf solche 'Server', die du in der
/etc/apt/sources.list als Installationsquellen eintragen kannst.

dput unterstützt dabei mehrere Verfahren zum Hochladen, die wichtigsten
sind ftp,ssh/sftp und lokales Kopieren.

== mini-dinstall ==
dieses Programm erzeugt nun ein Repository mit allen Schickanen:

<source lang="bash">
$\tree
|-- delixs1
| |-- all
| | |-- Packages
| | |-- Packages.bz2
| | |-- Packages.gz
| | `-- Release
| |-- all.db
| |-- amd64
| | |-- Packages
| | |-- Packages.bz2
| | |-- Packages.gz
| | `-- Release
| |-- amd64.db
| |-- i386
| | |-- Packages
| | |-- Packages.bz2
| | |-- Packages.gz
| | `-- Release
| |-- i386.db
| `-- source
| |-- Sources
| |-- Sources.bz2
| `-- Sources.gz
</source>
* unter delixs/all liegen die architekturunabhängigen binären debian-Pakete (debs)
* unter delixs/amd64 liegen die binären amd64 debian-Pakete (debs)
* unter delixs/i386 liegen die binären i386 debian-Pakete (debs)
* unter source liegen alle Versionen dieser Pakete im source-Format. Jeweils eine dsc und eine tar.gz Datei

= Konfiguration =

== alias svn-b ==
Wenn du ein Paket bauen und hochladen möchtest, rufst du dafür i.A. svn-buildpackage auf. Folgenden alias solltest du in deine ~/.bashrc packen:
<source lang="bash">
alias svn-b="svn-buildpackage -us -uc -rfakeroot --svn-ignore"
</source>
Damit reicht ein '''svn-b''' zum Bauen des Pakets. Es wird dann eine Ebene höher im Order '''build-area''' liegen.

== der Benutzer dupload ==

== dput Konfiguration ==
Mit der folgenden Konfiguration kennt dput zwei Ziele für den Paketupload
# local - deinen Rechner
# delixs - unser offizielles delixs-Repository

<source lang="properties">
$ cat ~/.dput.cf
[local]
method = local
hostname = localhost
incoming = ~/public_html/debian/mini-dinstall/incoming
run_dinstall = 0
allow_unsigned_uploads = 1
verify_sigs = 0
post_upload_command = /usr/bin/mini-dinstall --batch

[delixs]
method = sftp
hostname = deb.delixs.de
incoming = ./
run_dinstall = 0
verify_sigs = 0
</source>

== mini-dinstall Konfiguration ==
mini-dinstall soll mir ein Repository unter ~/public_html/delixs/ anlegen. Dafür ist folgende Konfiguration nötig:

<source lang="properties">
$ cat ~/.mini-dinstall.conf
# Adapted Colin's mini-dinstall.conf
# Infos unter /usr/share/doc/dput
# und http://debiananwenderhandbuch.de/mini-dinstall.html
[DEFAULT]
architectures = all, i386, amd64
archivedir = ~/public_html/delixs/
use_dnotify = 0
verify_sigs = 0
#extra_keyrings = ~/.gnupg/pubring.gpg
mail_on_success = 0
archive_style = simple-subdir
poll_time = 10
mail_log_level = NONE
generate_release = 1
release_description = delixs Packages
# Releases:
[aramec]
[delixs1]
[delixs1-testing]
</source>

== ssh Clientkonfiguration ==

Damit dput beim Hochladen auf den dev-server (deb.delixs.de) sich gleich mit den korrekten Einstellugnen wie dem Benutzer verbindet, leg dir die Datei ~/.ssh/config mit folgendem Inhalt an:
<source lang="bash">
host deb.delixs.de
CheckHostIP no
User dupload
Ciphers arcfour
Protocol 2
IdentityFile ~/.ssh/id_dsa.dupload
</source>

'''XXX''' Die Datei id_dsa.dupload bekommst du noch

== gpg-Schlüssel ==

Wenn du Pakete auf den dev-Server lädst, muss die Release Datei mit gpg signiert werden. Ansonsten würde jeder Server, der dieses Repository nutzt, über ein unsicheres Archiv meckern.

Darum musst du dich hier nicht kümmern, das erzeugt das Programm mini-dinstall auf dem Server. Bei dir im lokalen Repository brauchst du den Aufwand nicht treiben, lokal verfügbare Release-Dateien müssen nicht signiert werden.

= Beispiel =

Nachfolgend ein Beispiel, wo ich das (nicht existierende) Paket delixs-firstrun-config
in der Version 0.1-58 in das lokale Repository hochlade. Am Ende wird automatisch mini-dinstall ausgeführt.

<source lang="bash">
$ dput local delixs-firstrun-config_0.1-58_i3864.changes
$ \tree ~/public_html/debian/delixs1/
/home/thorsten/public_html/debian/delixs1/
|-- all
| |-- Packages
| |-- Packages.bz2
| |-- Packages.gz
| |-- Release
| `-- delixs-firstrun-config_0.1-58_all.deb
|-- all.db
|-- amd64
| |-- Packages
| |-- Packages.bz2
| |-- Packages.gz
| `-- Release
|-- amd64.db
|-- i386
| |-- Packages
| |-- Packages.bz2
| |-- Packages.gz
| `-- Release
|-- i386.db
|-- delixs-firstrun-config_0.1-58_i386.changes
`-- source
|-- Sources
|-- Sources.bz2
|-- Sources.gz
|-- delixs-firstrun-config_0.1-58.dsc
`-- delixs-firstrun-config_0.1-58.tar.gz

</source>

'''Erklärung:'''
* Unter all liegt das architekturunabhängige Paket delixs-firstrun-config_0.1-58_all.deb
* direkt im Ordner delixs1 liegt die changes-Datei.
* unter source liegen die beiden Dateien delixs-firstrun-config_0.1-58.{dsc,tar-gz}

Im Ordner, von dem du das Paket hochgeladen hast (wahrscheinlich build-area), wurde die Datei
delixs-firstrun-config_0.1-58_i386.upload angelegt. Der Inhalt:

<source lang="bash">
$ cat delixs-firstrun-config_0.1-58_i386.upload
Successfully uploaded delixs-firstrun-config_0.1-58.dsc to localhost.
Successfully uploaded delixs-firstrun-config_0.1-58.tar.gz to localhost.
Successfully uploaded delixs-firstrun-config_0.1-58_all.deb to localhost.
Successfully uploaded delixs-firstrun-config_0.1-58_i386.changes to localhost.
</source>
Durch dieses logfile weis dput, dass es die Datei nicht nochmal hochladen muss, wenn du es ein zweites Mal probieren solltest.

Entwicklerhandbuch/Paketverwaltung

2009-10-10T11:32:34Z

ThorstenStrusch: /* Einführung */

Hi Leute,

ich habe mich gestern Abend mit den drei Paketen dput, mini-dinstall
und svn-buildpackage beschäftigt.

= Einführung =
Installiere auf deinem debian/lenny Rechner die entsprechenden Pakete mit den folgenden Befehl:

<source lang="bash">
aptitude install dput mini-dinstall svn-buildpackage devscripts openssh-client ssh-askpass-gnome
</source>

Arbeitest du unter gnome:
<source lang="bash">
aptitude install ssh-askpass-gnome
</source>
Arbeitest du unter kde:
<source lang="bash">
aptitude install ssh-askpass
</source>

== svn-buildpackage ==
Mit svn-buildpackage hast du die Möglichkeit debian Pakete
(die wir im SVN vohalten) für die entspr. Architekturen zu bauen.
Wir möchten i386 und amd64 unterstützen.
Es werden dabei binäre Debianpakete und source-Pakete erstellt.

Erstere erkennst du an der Dateiendung .deb, letztere bestehen aus
zwei Dateien. Eine endet auf dsc, die andere auf tar.gz.

Die source-Pakete kannst du herunterladen, wenn du in deiner
sources.list eine Zeile mit deb-src am Anfang stehen hast.
Die binären Dateien kannst du herunterladen, wenn du deb als
erstes Argument in der Zeile stehen hast.

svn-buildpackage erstellt ausserdem zu jedem Paket eine
<nowiki>$PAKETNAME_$VERSION-$UNTERVERSION_$ARCHITEKTUR.changes</nowiki> Datei.
(z.B. delixs-firstrun-config_0.1-58_all.deb)
Mit dieser Datei kann dput arbeiten.

'''INFO:'''
Zum Erstellen eines debian-Pakets sollten wir also nicht mehr
<code>fakeroot ./debian/rules binary</code> nutzen. Hierbei wird weder
die changes Datei noch die source-Dateien erstellt. Lasst uns also
wie später unten beschrieben mit dem alias svn-b arbeiten.

== dput ==
Dieses Programm ermöglicht es die binär- und source-Pakete in ein
debian Repository zu laden. Also auf solche 'Server', die du in der
/etc/apt/sources.list als Installationsquellen eintragen kannst.

dput unterstützt dabei mehrere Verfahren zum Hochladen, die wichtigsten
sind ftp,ssh/sftp und lokales Kopieren.

== mini-dinstall ==
dieses Programm erzeugt nun ein Repository mit allen Schickanen:

<source lang="bash">
$\tree
|-- delixs1
| |-- all
| | |-- Packages
| | |-- Packages.bz2
| | |-- Packages.gz
| | `-- Release
| |-- all.db
| |-- amd64
| | |-- Packages
| | |-- Packages.bz2
| | |-- Packages.gz
| | `-- Release
| |-- amd64.db
| |-- i386
| | |-- Packages
| | |-- Packages.bz2
| | |-- Packages.gz
| | `-- Release
| |-- i386.db
| `-- source
| |-- Sources
| |-- Sources.bz2
| `-- Sources.gz
</source>
* unter delixs/all liegen die architekturunabhängigen binären debian-Pakete (debs)
* unter delixs/amd64 liegen die binären amd64 debian-Pakete (debs)
* unter delixs/i386 liegen die binären i386 debian-Pakete (debs)
* unter source liegen alle Versionen dieser Pakete im source-Format. Jeweils eine dsc und eine tar.gz Datei

= Konfiguration =

== alias svn-b ==
Wenn du ein Paket bauen und hochladen möchtest, rufst du dafür i.A. svn-buildpackage auf. Folgenden alias solltest du in deine ~/.bashrc packen:
<source lang="bash">
alias svn-b="svn-buildpackage -us -uc -rfakeroot --svn-ignore"
</source>
Damit reicht ein '''svn-b''' zum Bauen des Pakets. Es wird dann eine Ebene höher im Order '''build-area''' liegen.

== der Benutzer dupload ==

== dput Konfiguration ==
Mit der folgenden Konfiguration kennt dput zwei Ziele für den Paketupload
# local - deinen Rechner
# delixs - unser offizielles delixs-Repository

<source lang="properties">
$ cat ~/.dput.cf
[local]
method = local
hostname = localhost
incoming = ~/public_html/debian/mini-dinstall/incoming
run_dinstall = 0
allow_unsigned_uploads = 1
verify_sigs = 0
post_upload_command = /usr/bin/mini-dinstall --batch

[delixs]
method = sftp
hostname = deb.delixs.de
incoming = ./
run_dinstall = 0
verify_sigs = 0
</source>

== mini-dinstall Konfiguration ==
mini-dinstall soll mir ein Repository unter ~/public_html/delixs/ anlegen. Dafür ist folgende Konfiguration nötig:

<source lang="properties">
$ cat ~/.mini-dinstall.conf
# Adapted Colin's mini-dinstall.conf
# Infos unter /usr/share/doc/dput
# und http://debiananwenderhandbuch.de/mini-dinstall.html
[DEFAULT]
architectures = all, i386, amd64
archivedir = ~/public_html/delixs/
use_dnotify = 0
verify_sigs = 0
#extra_keyrings = ~/.gnupg/pubring.gpg
mail_on_success = 0
archive_style = simple-subdir
poll_time = 10
mail_log_level = NONE
generate_release = 1
release_description = delixs Packages
# Releases:
[aramec]
[delixs1]
[delixs1-testing]
</source>

== ssh Clientkonfiguration ==

Damit dput beim Hochladen auf den dev-server (deb.delixs.de) sich gleich mit den korrekten Einstellugnen wie dem Benutzer verbindet, leg dir die Datei ~/.ssh/config mit folgendem Inhalt an:
<source lang="bash">
host deb.delixs.de
CheckHostIP no
User dupload
Ciphers arcfour
Protocol 2
IdentityFile ~/.ssh/id_dsa.dupload
</source>

'''XXX''' Die Datei id_dsa.dupload bekommst du noch

== gpg-Schlüssel ==

Wenn du Pakete auf den dev-Server lädst, muss die Release Datei mit gpg signiert werden. Ansonsten würde jeder Server, der dieses Repository nutzt, über ein unsicheres Archiv meckern.

Darum musst du dich hier nicht kümmern, das erzeugt das Programm mini-dinstall auf dem Server. Bei dir im lokalen Repository brauchst du den Aufwand nicht treiben, lokal verfügbare Release-Dateien müssen nicht signiert werden.

= Beispiel =

Nachfolgend ein Beispiel, wo ich das (nicht existierende) Paket delixs-firstrun-config
in der Version 0.1-58 in das lokale Repository hochlade. Am Ende wird automatisch mini-dinstall ausgeführt.

<source lang="bash">
$ dput local delixs-firstrun-config_0.1-58_i3864.changes
$ \tree ~/public_html/debian/delixs1/
/home/thorsten/public_html/debian/delixs1/
|-- all
| |-- Packages
| |-- Packages.bz2
| |-- Packages.gz
| |-- Release
| `-- delixs-firstrun-config_0.1-58_all.deb
|-- all.db
|-- amd64
| |-- Packages
| |-- Packages.bz2
| |-- Packages.gz
| `-- Release
|-- amd64.db
|-- i386
| |-- Packages
| |-- Packages.bz2
| |-- Packages.gz
| `-- Release
|-- i386.db
|-- delixs-firstrun-config_0.1-58_i386.changes
`-- source
|-- Sources
|-- Sources.bz2
|-- Sources.gz
|-- delixs-firstrun-config_0.1-58.dsc
`-- delixs-firstrun-config_0.1-58.tar.gz

</source>

'''Erklärung:'''
* Unter all liegt das architekturunabhängige Paket delixs-firstrun-config_0.1-58_all.deb
* direkt im Ordner delixs1 liegt die changes-Datei.
* unter source liegen die beiden Dateien delixs-firstrun-config_0.1-58.{dsc,tar-gz}

Im Ordner, von dem du das Paket hochgeladen hast (wahrscheinlich build-area), wurde die Datei
delixs-firstrun-config_0.1-58_i386.upload angelegt. Der Inhalt:

<source lang="bash">
$ cat delixs-firstrun-config_0.1-58_i386.upload
Successfully uploaded delixs-firstrun-config_0.1-58.dsc to localhost.
Successfully uploaded delixs-firstrun-config_0.1-58.tar.gz to localhost.
Successfully uploaded delixs-firstrun-config_0.1-58_all.deb to localhost.
Successfully uploaded delixs-firstrun-config_0.1-58_i386.changes to localhost.
</source>
Durch dieses logfile weis dput, dass es die Datei nicht nochmal hochladen muss, wenn du es ein zweites Mal probieren solltest.

Entwicklerhandbuch/Paketverwaltung

2009-10-10T11:25:41Z

ThorstenStrusch: /* ssh Clientkonfiguration */

Hi Leute,

ich habe mich gestern Abend mit den drei Paketen dput, mini-dinstall
und svn-buildpackage beschäftigt.

= Einführung =

== svn-buildpackage ==
Mit svn-buildpackage hast du die Möglichkeit debian Pakete
(die wir im SVN vohalten) für die entspr. Architekturen zu bauen.
Wir möchten i386 und amd64 unterstützen.
Es werden dabei binäre Debianpakete und source-Pakete erstellt.

Erstere erkennst du an der Dateiendung .deb, letztere bestehen aus
zwei Dateien. Eine endet auf dsc, die andere auf tar.gz.

Die source-Pakete kannst du herunterladen, wenn du in deiner
sources.list eine Zeile mit deb-src am Anfang stehen hast.
Die binären Dateien kannst du herunterladen, wenn du deb als
erstes Argument in der Zeile stehen hast.

svn-buildpackage erstellt ausserdem zu jedem Paket eine
<nowiki>$PAKETNAME_$VERSION-$UNTERVERSION_$ARCHITEKTUR.changes</nowiki> Datei.
(z.B. delixs-firstrun-config_0.1-58_all.deb)
Mit dieser Datei kann dput arbeiten.

'''INFO:'''
Zum Erstellen eines debian-Pakets sollten wir also nicht mehr
<code>fakeroot ./debian/rules binary</code> nutzen. Hierbei wird weder
die changes Datei noch die source-Dateien erstellt. Lasst uns also
wie später unten beschrieben mit dem alias svn-b arbeiten.

== dput ==
Dieses Programm ermöglicht es die binär- und source-Pakete in ein
debian Repository zu laden. Also auf solche 'Server', die du in der
/etc/apt/sources.list als Installationsquellen eintragen kannst.

dput unterstützt dabei mehrere Verfahren zum Hochladen, die wichtigsten
sind ftp,ssh/sftp und lokales Kopieren.

== mini-dinstall ==
dieses Programm erzeugt nun ein Repository mit allen Schickanen:

<source lang="bash">
$\tree
|-- delixs1
| |-- all
| | |-- Packages
| | |-- Packages.bz2
| | |-- Packages.gz
| | `-- Release
| |-- all.db
| |-- amd64
| | |-- Packages
| | |-- Packages.bz2
| | |-- Packages.gz
| | `-- Release
| |-- amd64.db
| |-- i386
| | |-- Packages
| | |-- Packages.bz2
| | |-- Packages.gz
| | `-- Release
| |-- i386.db
| `-- source
| |-- Sources
| |-- Sources.bz2
| `-- Sources.gz
</source>
* unter delixs/all liegen die architekturunabhängigen binären debian-Pakete (debs)
* unter delixs/amd64 liegen die binären amd64 debian-Pakete (debs)
* unter delixs/i386 liegen die binären i386 debian-Pakete (debs)
* unter source liegen alle Versionen dieser Pakete im source-Format. Jeweils eine dsc und eine tar.gz Datei

= Konfiguration =

== alias svn-b ==
Wenn du ein Paket bauen und hochladen möchtest, rufst du dafür i.A. svn-buildpackage auf. Folgenden alias solltest du in deine ~/.bashrc packen:
<source lang="bash">
alias svn-b="svn-buildpackage -us -uc -rfakeroot --svn-ignore"
</source>
Damit reicht ein '''svn-b''' zum Bauen des Pakets. Es wird dann eine Ebene höher im Order '''build-area''' liegen.

== der Benutzer dupload ==

== dput Konfiguration ==
Mit der folgenden Konfiguration kennt dput zwei Ziele für den Paketupload
# local - deinen Rechner
# delixs - unser offizielles delixs-Repository

<source lang="properties">
$ cat ~/.dput.cf
[local]
method = local
hostname = localhost
incoming = ~/public_html/debian/mini-dinstall/incoming
run_dinstall = 0
allow_unsigned_uploads = 1
verify_sigs = 0
post_upload_command = /usr/bin/mini-dinstall --batch

[delixs]
method = sftp
hostname = deb.delixs.de
incoming = ./
run_dinstall = 0
verify_sigs = 0
</source>

== mini-dinstall Konfiguration ==
mini-dinstall soll mir ein Repository unter ~/public_html/delixs/ anlegen. Dafür ist folgende Konfiguration nötig:

<source lang="properties">
$ cat ~/.mini-dinstall.conf
# Adapted Colin's mini-dinstall.conf
# Infos unter /usr/share/doc/dput
# und http://debiananwenderhandbuch.de/mini-dinstall.html
[DEFAULT]
architectures = all, i386, amd64
archivedir = ~/public_html/delixs/
use_dnotify = 0
verify_sigs = 0
#extra_keyrings = ~/.gnupg/pubring.gpg
mail_on_success = 0
archive_style = simple-subdir
poll_time = 10
mail_log_level = NONE
generate_release = 1
release_description = delixs Packages
# Releases:
[aramec]
[delixs1]
[delixs1-testing]
</source>

== ssh Clientkonfiguration ==

Damit dput beim Hochladen auf den dev-server (deb.delixs.de) sich gleich mit den korrekten Einstellugnen wie dem Benutzer verbindet, leg dir die Datei ~/.ssh/config mit folgendem Inhalt an:
<source lang="bash">
host deb.delixs.de
CheckHostIP no
User dupload
Ciphers arcfour
Protocol 2
IdentityFile ~/.ssh/id_dsa.dupload
</source>

'''XXX''' Die Datei id_dsa.dupload bekommst du noch

== gpg-Schlüssel ==

Wenn du Pakete auf den dev-Server lädst, muss die Release Datei mit gpg signiert werden. Ansonsten würde jeder Server, der dieses Repository nutzt, über ein unsicheres Archiv meckern.

Darum musst du dich hier nicht kümmern, das erzeugt das Programm mini-dinstall auf dem Server. Bei dir im lokalen Repository brauchst du den Aufwand nicht treiben, lokal verfügbare Release-Dateien müssen nicht signiert werden.

= Beispiel =

Nachfolgend ein Beispiel, wo ich das (nicht existierende) Paket delixs-firstrun-config
in der Version 0.1-58 in das lokale Repository hochlade. Am Ende wird automatisch mini-dinstall ausgeführt.

<source lang="bash">
$ dput local delixs-firstrun-config_0.1-58_i3864.changes
$ \tree ~/public_html/debian/delixs1/
/home/thorsten/public_html/debian/delixs1/
|-- all
| |-- Packages
| |-- Packages.bz2
| |-- Packages.gz
| |-- Release
| `-- delixs-firstrun-config_0.1-58_all.deb
|-- all.db
|-- amd64
| |-- Packages
| |-- Packages.bz2
| |-- Packages.gz
| `-- Release
|-- amd64.db
|-- i386
| |-- Packages
| |-- Packages.bz2
| |-- Packages.gz
| `-- Release
|-- i386.db
|-- delixs-firstrun-config_0.1-58_i386.changes
`-- source
|-- Sources
|-- Sources.bz2
|-- Sources.gz
|-- delixs-firstrun-config_0.1-58.dsc
`-- delixs-firstrun-config_0.1-58.tar.gz

</source>

'''Erklärung:'''
* Unter all liegt das architekturunabhängige Paket delixs-firstrun-config_0.1-58_all.deb
* direkt im Ordner delixs1 liegt die changes-Datei.
* unter source liegen die beiden Dateien delixs-firstrun-config_0.1-58.{dsc,tar-gz}

Im Ordner, von dem du das Paket hochgeladen hast (wahrscheinlich build-area), wurde die Datei
delixs-firstrun-config_0.1-58_i386.upload angelegt. Der Inhalt:

<source lang="bash">
$ cat delixs-firstrun-config_0.1-58_i386.upload
Successfully uploaded delixs-firstrun-config_0.1-58.dsc to localhost.
Successfully uploaded delixs-firstrun-config_0.1-58.tar.gz to localhost.
Successfully uploaded delixs-firstrun-config_0.1-58_all.deb to localhost.
Successfully uploaded delixs-firstrun-config_0.1-58_i386.changes to localhost.
</source>
Durch dieses logfile weis dput, dass es die Datei nicht nochmal hochladen muss, wenn du es ein zweites Mal probieren solltest.

Entwicklerhandbuch/Paketverwaltung

2009-10-10T11:25:10Z

ThorstenStrusch: /* ~/.ssh/config */

Hi Leute,

ich habe mich gestern Abend mit den drei Paketen dput, mini-dinstall
und svn-buildpackage beschäftigt.

= Einführung =

== svn-buildpackage ==
Mit svn-buildpackage hast du die Möglichkeit debian Pakete
(die wir im SVN vohalten) für die entspr. Architekturen zu bauen.
Wir möchten i386 und amd64 unterstützen.
Es werden dabei binäre Debianpakete und source-Pakete erstellt.

Erstere erkennst du an der Dateiendung .deb, letztere bestehen aus
zwei Dateien. Eine endet auf dsc, die andere auf tar.gz.

Die source-Pakete kannst du herunterladen, wenn du in deiner
sources.list eine Zeile mit deb-src am Anfang stehen hast.
Die binären Dateien kannst du herunterladen, wenn du deb als
erstes Argument in der Zeile stehen hast.

svn-buildpackage erstellt ausserdem zu jedem Paket eine
<nowiki>$PAKETNAME_$VERSION-$UNTERVERSION_$ARCHITEKTUR.changes</nowiki> Datei.
(z.B. delixs-firstrun-config_0.1-58_all.deb)
Mit dieser Datei kann dput arbeiten.

'''INFO:'''
Zum Erstellen eines debian-Pakets sollten wir also nicht mehr
<code>fakeroot ./debian/rules binary</code> nutzen. Hierbei wird weder
die changes Datei noch die source-Dateien erstellt. Lasst uns also
wie später unten beschrieben mit dem alias svn-b arbeiten.

== dput ==
Dieses Programm ermöglicht es die binär- und source-Pakete in ein
debian Repository zu laden. Also auf solche 'Server', die du in der
/etc/apt/sources.list als Installationsquellen eintragen kannst.

dput unterstützt dabei mehrere Verfahren zum Hochladen, die wichtigsten
sind ftp,ssh/sftp und lokales Kopieren.

== mini-dinstall ==
dieses Programm erzeugt nun ein Repository mit allen Schickanen:

<source lang="bash">
$\tree
|-- delixs1
| |-- all
| | |-- Packages
| | |-- Packages.bz2
| | |-- Packages.gz
| | `-- Release
| |-- all.db
| |-- amd64
| | |-- Packages
| | |-- Packages.bz2
| | |-- Packages.gz
| | `-- Release
| |-- amd64.db
| |-- i386
| | |-- Packages
| | |-- Packages.bz2
| | |-- Packages.gz
| | `-- Release
| |-- i386.db
| `-- source
| |-- Sources
| |-- Sources.bz2
| `-- Sources.gz
</source>
* unter delixs/all liegen die architekturunabhängigen binären debian-Pakete (debs)
* unter delixs/amd64 liegen die binären amd64 debian-Pakete (debs)
* unter delixs/i386 liegen die binären i386 debian-Pakete (debs)
* unter source liegen alle Versionen dieser Pakete im source-Format. Jeweils eine dsc und eine tar.gz Datei

= Konfiguration =

== alias svn-b ==
Wenn du ein Paket bauen und hochladen möchtest, rufst du dafür i.A. svn-buildpackage auf. Folgenden alias solltest du in deine ~/.bashrc packen:
<source lang="bash">
alias svn-b="svn-buildpackage -us -uc -rfakeroot --svn-ignore"
</source>
Damit reicht ein '''svn-b''' zum Bauen des Pakets. Es wird dann eine Ebene höher im Order '''build-area''' liegen.

== der Benutzer dupload ==

== dput Konfiguration ==
Mit der folgenden Konfiguration kennt dput zwei Ziele für den Paketupload
# local - deinen Rechner
# delixs - unser offizielles delixs-Repository

<source lang="properties">
$ cat ~/.dput.cf
[local]
method = local
hostname = localhost
incoming = ~/public_html/debian/mini-dinstall/incoming
run_dinstall = 0
allow_unsigned_uploads = 1
verify_sigs = 0
post_upload_command = /usr/bin/mini-dinstall --batch

[delixs]
method = sftp
hostname = deb.delixs.de
incoming = ./
run_dinstall = 0
verify_sigs = 0
</source>

== mini-dinstall Konfiguration ==
mini-dinstall soll mir ein Repository unter ~/public_html/delixs/ anlegen. Dafür ist folgende Konfiguration nötig:

<source lang="properties">
$ cat ~/.mini-dinstall.conf
# Adapted Colin's mini-dinstall.conf
# Infos unter /usr/share/doc/dput
# und http://debiananwenderhandbuch.de/mini-dinstall.html
[DEFAULT]
architectures = all, i386, amd64
archivedir = ~/public_html/delixs/
use_dnotify = 0
verify_sigs = 0
#extra_keyrings = ~/.gnupg/pubring.gpg
mail_on_success = 0
archive_style = simple-subdir
poll_time = 10
mail_log_level = NONE
generate_release = 1
release_description = delixs Packages
# Releases:
[aramec]
[delixs1]
[delixs1-testing]
</source>

== ssh Clientkonfiguration ==
Damit dput beim Hochladen auf den dev-server (deb.delixs.de) sich gleich mit den korrekten Einstellugnen wie dem Benutzer verbindet, leg dir die Datei ~/.ssh/config mit folgendem Inhalt an:
<source lang="bash">
host deb.delixs.de
CheckHostIP no
User dupload
Ciphers arcfour
Protocol 2
IdentityFile ~/.ssh/id_dsa.dupload
<source>

'''XXX''' Die Datei id_dsa.dupload bekommst du noch

== gpg-Schlüssel ==
Wenn du Pakete auf den dev-Server lädst, muss die Release Datei mit gpg signiert werden. Ansonsten würde jeder Server, der dieses Repository nutzt, über ein unsicheres Archiv meckern.

Darum musst du dich hier nicht kümmern, das erzeugt das Programm mini-dinstall auf dem Server. Bei dir im lokalen Repository brauchst du den Aufwand nicht treiben, lokal verfügbare Release-Dateien müssen nicht signiert werden.

= Beispiel =
Nachfolgend ein Beispiel, wo ich das (nicht existierende) Paket delixs-firstrun-config
in der Version 0.1-58 in das lokale Repository hochlade. Am Ende wird automatisch mini-dinstall ausgeführt.

<source lang="bash">
$ dput local delixs-firstrun-config_0.1-58_i3864.changes
$ \tree ~/public_html/debian/delixs1/
/home/thorsten/public_html/debian/delixs1/
|-- all
| |-- Packages
| |-- Packages.bz2
| |-- Packages.gz
| |-- Release
| `-- delixs-firstrun-config_0.1-58_all.deb
|-- all.db
|-- amd64
| |-- Packages
| |-- Packages.bz2
| |-- Packages.gz
| `-- Release
|-- amd64.db
|-- i386
| |-- Packages
| |-- Packages.bz2
| |-- Packages.gz
| `-- Release
|-- i386.db
|-- delixs-firstrun-config_0.1-58_i386.changes
`-- source
|-- Sources
|-- Sources.bz2
|-- Sources.gz
|-- delixs-firstrun-config_0.1-58.dsc
`-- delixs-firstrun-config_0.1-58.tar.gz

</source>

'''Erklärung:'''
* Unter all liegt das architekturunabhängige Paket delixs-firstrun-config_0.1-58_all.deb
* direkt im Ordner delixs1 liegt die changes-Datei.
* unter source liegen die beiden Dateien delixs-firstrun-config_0.1-58.{dsc,tar-gz}

Im Ordner, von dem du das Paket hochgeladen hast (wahrscheinlich build-area), wurde die Datei
delixs-firstrun-config_0.1-58_i386.upload angelegt. Der Inhalt:

<source lang="bash">
$ cat delixs-firstrun-config_0.1-58_i386.upload
Successfully uploaded delixs-firstrun-config_0.1-58.dsc to localhost.
Successfully uploaded delixs-firstrun-config_0.1-58.tar.gz to localhost.
Successfully uploaded delixs-firstrun-config_0.1-58_all.deb to localhost.
Successfully uploaded delixs-firstrun-config_0.1-58_i386.changes to localhost.
</source>
Durch dieses logfile weis dput, dass es die Datei nicht nochmal hochladen muss, wenn du es ein zweites Mal probieren solltest.

Entwicklerhandbuch/Paketverwaltung

2009-10-10T11:24:29Z

ThorstenStrusch: /* ~/.mini-dinstall.conf */

Hi Leute,

ich habe mich gestern Abend mit den drei Paketen dput, mini-dinstall
und svn-buildpackage beschäftigt.

= Einführung =

== svn-buildpackage ==
Mit svn-buildpackage hast du die Möglichkeit debian Pakete
(die wir im SVN vohalten) für die entspr. Architekturen zu bauen.
Wir möchten i386 und amd64 unterstützen.
Es werden dabei binäre Debianpakete und source-Pakete erstellt.

Erstere erkennst du an der Dateiendung .deb, letztere bestehen aus
zwei Dateien. Eine endet auf dsc, die andere auf tar.gz.

Die source-Pakete kannst du herunterladen, wenn du in deiner
sources.list eine Zeile mit deb-src am Anfang stehen hast.
Die binären Dateien kannst du herunterladen, wenn du deb als
erstes Argument in der Zeile stehen hast.

svn-buildpackage erstellt ausserdem zu jedem Paket eine
<nowiki>$PAKETNAME_$VERSION-$UNTERVERSION_$ARCHITEKTUR.changes</nowiki> Datei.
(z.B. delixs-firstrun-config_0.1-58_all.deb)
Mit dieser Datei kann dput arbeiten.

'''INFO:'''
Zum Erstellen eines debian-Pakets sollten wir also nicht mehr
<code>fakeroot ./debian/rules binary</code> nutzen. Hierbei wird weder
die changes Datei noch die source-Dateien erstellt. Lasst uns also
wie später unten beschrieben mit dem alias svn-b arbeiten.

== dput ==
Dieses Programm ermöglicht es die binär- und source-Pakete in ein
debian Repository zu laden. Also auf solche 'Server', die du in der
/etc/apt/sources.list als Installationsquellen eintragen kannst.

dput unterstützt dabei mehrere Verfahren zum Hochladen, die wichtigsten
sind ftp,ssh/sftp und lokales Kopieren.

== mini-dinstall ==
dieses Programm erzeugt nun ein Repository mit allen Schickanen:

<source lang="bash">
$\tree
|-- delixs1
| |-- all
| | |-- Packages
| | |-- Packages.bz2
| | |-- Packages.gz
| | `-- Release
| |-- all.db
| |-- amd64
| | |-- Packages
| | |-- Packages.bz2
| | |-- Packages.gz
| | `-- Release
| |-- amd64.db
| |-- i386
| | |-- Packages
| | |-- Packages.bz2
| | |-- Packages.gz
| | `-- Release
| |-- i386.db
| `-- source
| |-- Sources
| |-- Sources.bz2
| `-- Sources.gz
</source>
* unter delixs/all liegen die architekturunabhängigen binären debian-Pakete (debs)
* unter delixs/amd64 liegen die binären amd64 debian-Pakete (debs)
* unter delixs/i386 liegen die binären i386 debian-Pakete (debs)
* unter source liegen alle Versionen dieser Pakete im source-Format. Jeweils eine dsc und eine tar.gz Datei

= Konfiguration =

== alias svn-b ==
Wenn du ein Paket bauen und hochladen möchtest, rufst du dafür i.A. svn-buildpackage auf. Folgenden alias solltest du in deine ~/.bashrc packen:
<source lang="bash">
alias svn-b="svn-buildpackage -us -uc -rfakeroot --svn-ignore"
</source>
Damit reicht ein '''svn-b''' zum Bauen des Pakets. Es wird dann eine Ebene höher im Order '''build-area''' liegen.

== der Benutzer dupload ==

== dput Konfiguration ==
Mit der folgenden Konfiguration kennt dput zwei Ziele für den Paketupload
# local - deinen Rechner
# delixs - unser offizielles delixs-Repository

<source lang="properties">
$ cat ~/.dput.cf
[local]
method = local
hostname = localhost
incoming = ~/public_html/debian/mini-dinstall/incoming
run_dinstall = 0
allow_unsigned_uploads = 1
verify_sigs = 0
post_upload_command = /usr/bin/mini-dinstall --batch

[delixs]
method = sftp
hostname = deb.delixs.de
incoming = ./
run_dinstall = 0
verify_sigs = 0
</source>

== mini-dinstall Konfiguration ==
mini-dinstall soll mir ein Repository unter ~/public_html/delixs/ anlegen. Dafür ist folgende Konfiguration nötig:

<source lang="properties">
$ cat ~/.mini-dinstall.conf
# Adapted Colin's mini-dinstall.conf
# Infos unter /usr/share/doc/dput
# und http://debiananwenderhandbuch.de/mini-dinstall.html
[DEFAULT]
architectures = all, i386, amd64
archivedir = ~/public_html/delixs/
use_dnotify = 0
verify_sigs = 0
#extra_keyrings = ~/.gnupg/pubring.gpg
mail_on_success = 0
archive_style = simple-subdir
poll_time = 10
mail_log_level = NONE
generate_release = 1
release_description = delixs Packages
# Releases:
[aramec]
[delixs1]
[delixs1-testing]
</source>

== ~/.ssh/config ==
Damit dput beim Hochladen auf den dev-server (deb.delixs.de) sich gleich mit den korrekten Einstellugnen wie dem Benutzer verbindet, leg dir die Datei ~/.ssh/config mit folgendem Inhalt an:
<source lang="bash">
host deb.delixs.de
CheckHostIP no
User dupload
Ciphers arcfour
Protocol 2
IdentityFile ~/.ssh/id_dsa.dupload
<source>

== gpg-Schlüssel ==
Wenn du Pakete auf den dev-Server lädst, muss die Release Datei mit gpg signiert werden. Ansonsten würde jeder Server, der dieses Repository nutzt, über ein unsicheres Archiv meckern.

Darum musst du dich hier nicht kümmern, das erzeugt das Programm mini-dinstall auf dem Server. Bei dir im lokalen Repository brauchst du den Aufwand nicht treiben, lokal verfügbare Release-Dateien müssen nicht signiert werden.

= Beispiel =
Nachfolgend ein Beispiel, wo ich das (nicht existierende) Paket delixs-firstrun-config
in der Version 0.1-58 in das lokale Repository hochlade. Am Ende wird automatisch mini-dinstall ausgeführt.

<source lang="bash">
$ dput local delixs-firstrun-config_0.1-58_i3864.changes
$ \tree ~/public_html/debian/delixs1/
/home/thorsten/public_html/debian/delixs1/
|-- all
| |-- Packages
| |-- Packages.bz2
| |-- Packages.gz
| |-- Release
| `-- delixs-firstrun-config_0.1-58_all.deb
|-- all.db
|-- amd64
| |-- Packages
| |-- Packages.bz2
| |-- Packages.gz
| `-- Release
|-- amd64.db
|-- i386
| |-- Packages
| |-- Packages.bz2
| |-- Packages.gz
| `-- Release
|-- i386.db
|-- delixs-firstrun-config_0.1-58_i386.changes
`-- source
|-- Sources
|-- Sources.bz2
|-- Sources.gz
|-- delixs-firstrun-config_0.1-58.dsc
`-- delixs-firstrun-config_0.1-58.tar.gz

</source>

'''Erklärung:'''
* Unter all liegt das architekturunabhängige Paket delixs-firstrun-config_0.1-58_all.deb
* direkt im Ordner delixs1 liegt die changes-Datei.
* unter source liegen die beiden Dateien delixs-firstrun-config_0.1-58.{dsc,tar-gz}

Im Ordner, von dem du das Paket hochgeladen hast (wahrscheinlich build-area), wurde die Datei
delixs-firstrun-config_0.1-58_i386.upload angelegt. Der Inhalt:

<source lang="bash">
$ cat delixs-firstrun-config_0.1-58_i386.upload
Successfully uploaded delixs-firstrun-config_0.1-58.dsc to localhost.
Successfully uploaded delixs-firstrun-config_0.1-58.tar.gz to localhost.
Successfully uploaded delixs-firstrun-config_0.1-58_all.deb to localhost.
Successfully uploaded delixs-firstrun-config_0.1-58_i386.changes to localhost.
</source>
Durch dieses logfile weis dput, dass es die Datei nicht nochmal hochladen muss, wenn du es ein zweites Mal probieren solltest.

Entwicklerhandbuch/Paketverwaltung

2009-10-10T11:23:08Z

ThorstenStrusch: /* ~/.dput.cf */

Hi Leute,

ich habe mich gestern Abend mit den drei Paketen dput, mini-dinstall
und svn-buildpackage beschäftigt.

= Einführung =

== svn-buildpackage ==
Mit svn-buildpackage hast du die Möglichkeit debian Pakete
(die wir im SVN vohalten) für die entspr. Architekturen zu bauen.
Wir möchten i386 und amd64 unterstützen.
Es werden dabei binäre Debianpakete und source-Pakete erstellt.

Erstere erkennst du an der Dateiendung .deb, letztere bestehen aus
zwei Dateien. Eine endet auf dsc, die andere auf tar.gz.

Die source-Pakete kannst du herunterladen, wenn du in deiner
sources.list eine Zeile mit deb-src am Anfang stehen hast.
Die binären Dateien kannst du herunterladen, wenn du deb als
erstes Argument in der Zeile stehen hast.

svn-buildpackage erstellt ausserdem zu jedem Paket eine
<nowiki>$PAKETNAME_$VERSION-$UNTERVERSION_$ARCHITEKTUR.changes</nowiki> Datei.
(z.B. delixs-firstrun-config_0.1-58_all.deb)
Mit dieser Datei kann dput arbeiten.

'''INFO:'''
Zum Erstellen eines debian-Pakets sollten wir also nicht mehr
<code>fakeroot ./debian/rules binary</code> nutzen. Hierbei wird weder
die changes Datei noch die source-Dateien erstellt. Lasst uns also
wie später unten beschrieben mit dem alias svn-b arbeiten.

== dput ==
Dieses Programm ermöglicht es die binär- und source-Pakete in ein
debian Repository zu laden. Also auf solche 'Server', die du in der
/etc/apt/sources.list als Installationsquellen eintragen kannst.

dput unterstützt dabei mehrere Verfahren zum Hochladen, die wichtigsten
sind ftp,ssh/sftp und lokales Kopieren.

== mini-dinstall ==
dieses Programm erzeugt nun ein Repository mit allen Schickanen:

<source lang="bash">
$\tree
|-- delixs1
| |-- all
| | |-- Packages
| | |-- Packages.bz2
| | |-- Packages.gz
| | `-- Release
| |-- all.db
| |-- amd64
| | |-- Packages
| | |-- Packages.bz2
| | |-- Packages.gz
| | `-- Release
| |-- amd64.db
| |-- i386
| | |-- Packages
| | |-- Packages.bz2
| | |-- Packages.gz
| | `-- Release
| |-- i386.db
| `-- source
| |-- Sources
| |-- Sources.bz2
| `-- Sources.gz
</source>
* unter delixs/all liegen die architekturunabhängigen binären debian-Pakete (debs)
* unter delixs/amd64 liegen die binären amd64 debian-Pakete (debs)
* unter delixs/i386 liegen die binären i386 debian-Pakete (debs)
* unter source liegen alle Versionen dieser Pakete im source-Format. Jeweils eine dsc und eine tar.gz Datei

= Konfiguration =

== alias svn-b ==
Wenn du ein Paket bauen und hochladen möchtest, rufst du dafür i.A. svn-buildpackage auf. Folgenden alias solltest du in deine ~/.bashrc packen:
<source lang="bash">
alias svn-b="svn-buildpackage -us -uc -rfakeroot --svn-ignore"
</source>
Damit reicht ein '''svn-b''' zum Bauen des Pakets. Es wird dann eine Ebene höher im Order '''build-area''' liegen.

== der Benutzer dupload ==

== dput Konfiguration ==
Mit der folgenden Konfiguration kennt dput zwei Ziele für den Paketupload
# local - deinen Rechner
# delixs - unser offizielles delixs-Repository

<source lang="properties">
$ cat ~/.dput.cf
[local]
method = local
hostname = localhost
incoming = ~/public_html/debian/mini-dinstall/incoming
run_dinstall = 0
allow_unsigned_uploads = 1
verify_sigs = 0
post_upload_command = /usr/bin/mini-dinstall --batch

[delixs]
method = sftp
hostname = deb.delixs.de
incoming = ./
run_dinstall = 0
verify_sigs = 0
</source>

== ~/.mini-dinstall.conf ==
<source lang="properties">
# Adapted Colin's mini-dinstall.conf
# Infos unter /usr/share/doc/dput
# und http://debiananwenderhandbuch.de/mini-dinstall.html
[DEFAULT]
architectures = all, i386, amd64
archivedir = ~/public_html/debian/
use_dnotify = 0
verify_sigs = 0
#extra_keyrings = ~/.gnupg/pubring.gpg
mail_on_success = 0
archive_style = simple-subdir
poll_time = 10
mail_log_level = NONE
generate_release = 1
release_description = delixs Packages
# Releases:
[aramec]
[delixs1]
[delixs1-testing]
</source>
== ~/.ssh/config ==
Damit dput beim Hochladen auf den dev-server (deb.delixs.de) sich gleich mit den korrekten Einstellugnen wie dem Benutzer verbindet, leg dir die Datei ~/.ssh/config mit folgendem Inhalt an:
<source lang="bash">
host deb.delixs.de
CheckHostIP no
User dupload
Ciphers arcfour
Protocol 2
IdentityFile ~/.ssh/id_dsa.dupload
<source>

== gpg-Schlüssel ==
Wenn du Pakete auf den dev-Server lädst, muss die Release Datei mit gpg signiert werden. Ansonsten würde jeder Server, der dieses Repository nutzt, über ein unsicheres Archiv meckern.

Darum musst du dich hier nicht kümmern, das erzeugt das Programm mini-dinstall auf dem Server. Bei dir im lokalen Repository brauchst du den Aufwand nicht treiben, lokal verfügbare Release-Dateien müssen nicht signiert werden.

= Beispiel =
Nachfolgend ein Beispiel, wo ich das (nicht existierende) Paket delixs-firstrun-config
in der Version 0.1-58 in das lokale Repository hochlade. Am Ende wird automatisch mini-dinstall ausgeführt.

<source lang="bash">
$ dput local delixs-firstrun-config_0.1-58_i3864.changes
$ \tree ~/public_html/debian/delixs1/
/home/thorsten/public_html/debian/delixs1/
|-- all
| |-- Packages
| |-- Packages.bz2
| |-- Packages.gz
| |-- Release
| `-- delixs-firstrun-config_0.1-58_all.deb
|-- all.db
|-- amd64
| |-- Packages
| |-- Packages.bz2
| |-- Packages.gz
| `-- Release
|-- amd64.db
|-- i386
| |-- Packages
| |-- Packages.bz2
| |-- Packages.gz
| `-- Release
|-- i386.db
|-- delixs-firstrun-config_0.1-58_i386.changes
`-- source
|-- Sources
|-- Sources.bz2
|-- Sources.gz
|-- delixs-firstrun-config_0.1-58.dsc
`-- delixs-firstrun-config_0.1-58.tar.gz

</source>

'''Erklärung:'''
* Unter all liegt das architekturunabhängige Paket delixs-firstrun-config_0.1-58_all.deb
* direkt im Ordner delixs1 liegt die changes-Datei.
* unter source liegen die beiden Dateien delixs-firstrun-config_0.1-58.{dsc,tar-gz}

Im Ordner, von dem du das Paket hochgeladen hast (wahrscheinlich build-area), wurde die Datei
delixs-firstrun-config_0.1-58_i386.upload angelegt. Der Inhalt:

<source lang="bash">
$ cat delixs-firstrun-config_0.1-58_i386.upload
Successfully uploaded delixs-firstrun-config_0.1-58.dsc to localhost.
Successfully uploaded delixs-firstrun-config_0.1-58.tar.gz to localhost.
Successfully uploaded delixs-firstrun-config_0.1-58_all.deb to localhost.
Successfully uploaded delixs-firstrun-config_0.1-58_i386.changes to localhost.
</source>
Durch dieses logfile weis dput, dass es die Datei nicht nochmal hochladen muss, wenn du es ein zweites Mal probieren solltest.

Entwicklerhandbuch/Paketverwaltung

2009-10-10T11:22:37Z

ThorstenStrusch: /* ~/.dput.cf */

Hi Leute,

ich habe mich gestern Abend mit den drei Paketen dput, mini-dinstall
und svn-buildpackage beschäftigt.

= Einführung =

== svn-buildpackage ==
Mit svn-buildpackage hast du die Möglichkeit debian Pakete
(die wir im SVN vohalten) für die entspr. Architekturen zu bauen.
Wir möchten i386 und amd64 unterstützen.
Es werden dabei binäre Debianpakete und source-Pakete erstellt.

Erstere erkennst du an der Dateiendung .deb, letztere bestehen aus
zwei Dateien. Eine endet auf dsc, die andere auf tar.gz.

Die source-Pakete kannst du herunterladen, wenn du in deiner
sources.list eine Zeile mit deb-src am Anfang stehen hast.
Die binären Dateien kannst du herunterladen, wenn du deb als
erstes Argument in der Zeile stehen hast.

svn-buildpackage erstellt ausserdem zu jedem Paket eine
<nowiki>$PAKETNAME_$VERSION-$UNTERVERSION_$ARCHITEKTUR.changes</nowiki> Datei.
(z.B. delixs-firstrun-config_0.1-58_all.deb)
Mit dieser Datei kann dput arbeiten.

'''INFO:'''
Zum Erstellen eines debian-Pakets sollten wir also nicht mehr
<code>fakeroot ./debian/rules binary</code> nutzen. Hierbei wird weder
die changes Datei noch die source-Dateien erstellt. Lasst uns also
wie später unten beschrieben mit dem alias svn-b arbeiten.

== dput ==
Dieses Programm ermöglicht es die binär- und source-Pakete in ein
debian Repository zu laden. Also auf solche 'Server', die du in der
/etc/apt/sources.list als Installationsquellen eintragen kannst.

dput unterstützt dabei mehrere Verfahren zum Hochladen, die wichtigsten
sind ftp,ssh/sftp und lokales Kopieren.

== mini-dinstall ==
dieses Programm erzeugt nun ein Repository mit allen Schickanen:

<source lang="bash">
$\tree
|-- delixs1
| |-- all
| | |-- Packages
| | |-- Packages.bz2
| | |-- Packages.gz
| | `-- Release
| |-- all.db
| |-- amd64
| | |-- Packages
| | |-- Packages.bz2
| | |-- Packages.gz
| | `-- Release
| |-- amd64.db
| |-- i386
| | |-- Packages
| | |-- Packages.bz2
| | |-- Packages.gz
| | `-- Release
| |-- i386.db
| `-- source
| |-- Sources
| |-- Sources.bz2
| `-- Sources.gz
</source>
* unter delixs/all liegen die architekturunabhängigen binären debian-Pakete (debs)
* unter delixs/amd64 liegen die binären amd64 debian-Pakete (debs)
* unter delixs/i386 liegen die binären i386 debian-Pakete (debs)
* unter source liegen alle Versionen dieser Pakete im source-Format. Jeweils eine dsc und eine tar.gz Datei

= Konfiguration =

== alias svn-b ==
Wenn du ein Paket bauen und hochladen möchtest, rufst du dafür i.A. svn-buildpackage auf. Folgenden alias solltest du in deine ~/.bashrc packen:
<source lang="bash">
alias svn-b="svn-buildpackage -us -uc -rfakeroot --svn-ignore"
</source>
Damit reicht ein '''svn-b''' zum Bauen des Pakets. Es wird dann eine Ebene höher im Order '''build-area''' liegen.

== der Benutzer dupload ==

== ~/.dput.cf ==
Mit der folgenden Konfiguration kennt dput zwei Ziele für den Paketupload
# local - deinen Rechner
# delixs - unser offizielles delixs-Repository

<source lang="properties">
[local]
method = local
hostname = localhost
incoming = ~/public_html/debian/mini-dinstall/incoming
run_dinstall = 0
allow_unsigned_uploads = 1
verify_sigs = 0
post_upload_command = /usr/bin/mini-dinstall --batch

[delixs]
method = sftp
hostname = deb.delixs.de
incoming = ./
run_dinstall = 0
verify_sigs = 0
</source>

== ~/.mini-dinstall.conf ==
<source lang="properties">
# Adapted Colin's mini-dinstall.conf
# Infos unter /usr/share/doc/dput
# und http://debiananwenderhandbuch.de/mini-dinstall.html
[DEFAULT]
architectures = all, i386, amd64
archivedir = ~/public_html/debian/
use_dnotify = 0
verify_sigs = 0
#extra_keyrings = ~/.gnupg/pubring.gpg
mail_on_success = 0
archive_style = simple-subdir
poll_time = 10
mail_log_level = NONE
generate_release = 1
release_description = delixs Packages
# Releases:
[aramec]
[delixs1]
[delixs1-testing]
</source>
== ~/.ssh/config ==
Damit dput beim Hochladen auf den dev-server (deb.delixs.de) sich gleich mit den korrekten Einstellugnen wie dem Benutzer verbindet, leg dir die Datei ~/.ssh/config mit folgendem Inhalt an:
<source lang="bash">
host deb.delixs.de
CheckHostIP no
User dupload
Ciphers arcfour
Protocol 2
IdentityFile ~/.ssh/id_dsa.dupload
<source>

== gpg-Schlüssel ==
Wenn du Pakete auf den dev-Server lädst, muss die Release Datei mit gpg signiert werden. Ansonsten würde jeder Server, der dieses Repository nutzt, über ein unsicheres Archiv meckern.

Darum musst du dich hier nicht kümmern, das erzeugt das Programm mini-dinstall auf dem Server. Bei dir im lokalen Repository brauchst du den Aufwand nicht treiben, lokal verfügbare Release-Dateien müssen nicht signiert werden.

= Beispiel =
Nachfolgend ein Beispiel, wo ich das (nicht existierende) Paket delixs-firstrun-config
in der Version 0.1-58 in das lokale Repository hochlade. Am Ende wird automatisch mini-dinstall ausgeführt.

<source lang="bash">
$ dput local delixs-firstrun-config_0.1-58_i3864.changes
$ \tree ~/public_html/debian/delixs1/
/home/thorsten/public_html/debian/delixs1/
|-- all
| |-- Packages
| |-- Packages.bz2
| |-- Packages.gz
| |-- Release
| `-- delixs-firstrun-config_0.1-58_all.deb
|-- all.db
|-- amd64
| |-- Packages
| |-- Packages.bz2
| |-- Packages.gz
| `-- Release
|-- amd64.db
|-- i386
| |-- Packages
| |-- Packages.bz2
| |-- Packages.gz
| `-- Release
|-- i386.db
|-- delixs-firstrun-config_0.1-58_i386.changes
`-- source
|-- Sources
|-- Sources.bz2
|-- Sources.gz
|-- delixs-firstrun-config_0.1-58.dsc
`-- delixs-firstrun-config_0.1-58.tar.gz

</source>

'''Erklärung:'''
* Unter all liegt das architekturunabhängige Paket delixs-firstrun-config_0.1-58_all.deb
* direkt im Ordner delixs1 liegt die changes-Datei.
* unter source liegen die beiden Dateien delixs-firstrun-config_0.1-58.{dsc,tar-gz}

Im Ordner, von dem du das Paket hochgeladen hast (wahrscheinlich build-area), wurde die Datei
delixs-firstrun-config_0.1-58_i386.upload angelegt. Der Inhalt:

<source lang="bash">
$ cat delixs-firstrun-config_0.1-58_i386.upload
Successfully uploaded delixs-firstrun-config_0.1-58.dsc to localhost.
Successfully uploaded delixs-firstrun-config_0.1-58.tar.gz to localhost.
Successfully uploaded delixs-firstrun-config_0.1-58_all.deb to localhost.
Successfully uploaded delixs-firstrun-config_0.1-58_i386.changes to localhost.
</source>
Durch dieses logfile weis dput, dass es die Datei nicht nochmal hochladen muss, wenn du es ein zweites Mal probieren solltest.

Entwicklerhandbuch/Paketverwaltung

2009-10-10T11:21:40Z

ThorstenStrusch: /* ~/.dput.cf */

Hi Leute,

ich habe mich gestern Abend mit den drei Paketen dput, mini-dinstall
und svn-buildpackage beschäftigt.

= Einführung =

== svn-buildpackage ==
Mit svn-buildpackage hast du die Möglichkeit debian Pakete
(die wir im SVN vohalten) für die entspr. Architekturen zu bauen.
Wir möchten i386 und amd64 unterstützen.
Es werden dabei binäre Debianpakete und source-Pakete erstellt.

Erstere erkennst du an der Dateiendung .deb, letztere bestehen aus
zwei Dateien. Eine endet auf dsc, die andere auf tar.gz.

Die source-Pakete kannst du herunterladen, wenn du in deiner
sources.list eine Zeile mit deb-src am Anfang stehen hast.
Die binären Dateien kannst du herunterladen, wenn du deb als
erstes Argument in der Zeile stehen hast.

svn-buildpackage erstellt ausserdem zu jedem Paket eine
<nowiki>$PAKETNAME_$VERSION-$UNTERVERSION_$ARCHITEKTUR.changes</nowiki> Datei.
(z.B. delixs-firstrun-config_0.1-58_all.deb)
Mit dieser Datei kann dput arbeiten.

'''INFO:'''
Zum Erstellen eines debian-Pakets sollten wir also nicht mehr
<code>fakeroot ./debian/rules binary</code> nutzen. Hierbei wird weder
die changes Datei noch die source-Dateien erstellt. Lasst uns also
wie später unten beschrieben mit dem alias svn-b arbeiten.

== dput ==
Dieses Programm ermöglicht es die binär- und source-Pakete in ein
debian Repository zu laden. Also auf solche 'Server', die du in der
/etc/apt/sources.list als Installationsquellen eintragen kannst.

dput unterstützt dabei mehrere Verfahren zum Hochladen, die wichtigsten
sind ftp,ssh/sftp und lokales Kopieren.

== mini-dinstall ==
dieses Programm erzeugt nun ein Repository mit allen Schickanen:

<source lang="bash">
$\tree
|-- delixs1
| |-- all
| | |-- Packages
| | |-- Packages.bz2
| | |-- Packages.gz
| | `-- Release
| |-- all.db
| |-- amd64
| | |-- Packages
| | |-- Packages.bz2
| | |-- Packages.gz
| | `-- Release
| |-- amd64.db
| |-- i386
| | |-- Packages
| | |-- Packages.bz2
| | |-- Packages.gz
| | `-- Release
| |-- i386.db
| `-- source
| |-- Sources
| |-- Sources.bz2
| `-- Sources.gz
</source>
* unter delixs/all liegen die architekturunabhängigen binären debian-Pakete (debs)
* unter delixs/amd64 liegen die binären amd64 debian-Pakete (debs)
* unter delixs/i386 liegen die binären i386 debian-Pakete (debs)
* unter source liegen alle Versionen dieser Pakete im source-Format. Jeweils eine dsc und eine tar.gz Datei

= Konfiguration =

== alias svn-b ==
Wenn du ein Paket bauen und hochladen möchtest, rufst du dafür i.A. svn-buildpackage auf. Folgenden alias solltest du in deine ~/.bashrc packen:
<source lang="bash">
alias svn-b="svn-buildpackage -us -uc -rfakeroot --svn-ignore"
</source>
Damit reicht ein '''svn-b''' zum Bauen des Pakets. Es wird dann eine Ebene höher im Order '''build-area''' liegen.

== der Benutzer dupload ==

== ~/.dput.cf ==
<source lang="properties">
[local]
method = local
hostname = localhost
incoming = ~/public_html/debian/mini-dinstall/incoming
run_dinstall = 0
allow_unsigned_uploads = 1
verify_sigs = 0
post_upload_command = /usr/bin/mini-dinstall --batch

[delixs]
method = sftp
hostname = deb.delixs.de
incoming = ./
run_dinstall = 0
verify_sigs = 0
</source>

== ~/.mini-dinstall.conf ==
<source lang="properties">
# Adapted Colin's mini-dinstall.conf
# Infos unter /usr/share/doc/dput
# und http://debiananwenderhandbuch.de/mini-dinstall.html
[DEFAULT]
architectures = all, i386, amd64
archivedir = ~/public_html/debian/
use_dnotify = 0
verify_sigs = 0
#extra_keyrings = ~/.gnupg/pubring.gpg
mail_on_success = 0
archive_style = simple-subdir
poll_time = 10
mail_log_level = NONE
generate_release = 1
release_description = delixs Packages
# Releases:
[aramec]
[delixs1]
[delixs1-testing]
</source>
== ~/.ssh/config ==
Damit dput beim Hochladen auf den dev-server (deb.delixs.de) sich gleich mit den korrekten Einstellugnen wie dem Benutzer verbindet, leg dir die Datei ~/.ssh/config mit folgendem Inhalt an:
<source lang="bash">
host deb.delixs.de
CheckHostIP no
User dupload
Ciphers arcfour
Protocol 2
IdentityFile ~/.ssh/id_dsa.dupload
<source>

== gpg-Schlüssel ==
Wenn du Pakete auf den dev-Server lädst, muss die Release Datei mit gpg signiert werden. Ansonsten würde jeder Server, der dieses Repository nutzt, über ein unsicheres Archiv meckern.

Darum musst du dich hier nicht kümmern, das erzeugt das Programm mini-dinstall auf dem Server. Bei dir im lokalen Repository brauchst du den Aufwand nicht treiben, lokal verfügbare Release-Dateien müssen nicht signiert werden.

= Beispiel =
Nachfolgend ein Beispiel, wo ich das (nicht existierende) Paket delixs-firstrun-config
in der Version 0.1-58 in das lokale Repository hochlade. Am Ende wird automatisch mini-dinstall ausgeführt.

<source lang="bash">
$ dput local delixs-firstrun-config_0.1-58_i3864.changes
$ \tree ~/public_html/debian/delixs1/
/home/thorsten/public_html/debian/delixs1/
|-- all
| |-- Packages
| |-- Packages.bz2
| |-- Packages.gz
| |-- Release
| `-- delixs-firstrun-config_0.1-58_all.deb
|-- all.db
|-- amd64
| |-- Packages
| |-- Packages.bz2
| |-- Packages.gz
| `-- Release
|-- amd64.db
|-- i386
| |-- Packages
| |-- Packages.bz2
| |-- Packages.gz
| `-- Release
|-- i386.db
|-- delixs-firstrun-config_0.1-58_i386.changes
`-- source
|-- Sources
|-- Sources.bz2
|-- Sources.gz
|-- delixs-firstrun-config_0.1-58.dsc
`-- delixs-firstrun-config_0.1-58.tar.gz

</source>

'''Erklärung:'''
* Unter all liegt das architekturunabhängige Paket delixs-firstrun-config_0.1-58_all.deb
* direkt im Ordner delixs1 liegt die changes-Datei.
* unter source liegen die beiden Dateien delixs-firstrun-config_0.1-58.{dsc,tar-gz}

Im Ordner, von dem du das Paket hochgeladen hast (wahrscheinlich build-area), wurde die Datei
delixs-firstrun-config_0.1-58_i386.upload angelegt. Der Inhalt:

<source lang="bash">
$ cat delixs-firstrun-config_0.1-58_i386.upload
Successfully uploaded delixs-firstrun-config_0.1-58.dsc to localhost.
Successfully uploaded delixs-firstrun-config_0.1-58.tar.gz to localhost.
Successfully uploaded delixs-firstrun-config_0.1-58_all.deb to localhost.
Successfully uploaded delixs-firstrun-config_0.1-58_i386.changes to localhost.
</source>
Durch dieses logfile weis dput, dass es die Datei nicht nochmal hochladen muss, wenn du es ein zweites Mal probieren solltest.

Entwicklerhandbuch/Paketverwaltung

2009-10-10T11:21:16Z

ThorstenStrusch: /* gpg-Schlüssel */

Hi Leute,

ich habe mich gestern Abend mit den drei Paketen dput, mini-dinstall
und svn-buildpackage beschäftigt.

= Einführung =

== svn-buildpackage ==
Mit svn-buildpackage hast du die Möglichkeit debian Pakete
(die wir im SVN vohalten) für die entspr. Architekturen zu bauen.
Wir möchten i386 und amd64 unterstützen.
Es werden dabei binäre Debianpakete und source-Pakete erstellt.

Erstere erkennst du an der Dateiendung .deb, letztere bestehen aus
zwei Dateien. Eine endet auf dsc, die andere auf tar.gz.

Die source-Pakete kannst du herunterladen, wenn du in deiner
sources.list eine Zeile mit deb-src am Anfang stehen hast.
Die binären Dateien kannst du herunterladen, wenn du deb als
erstes Argument in der Zeile stehen hast.

svn-buildpackage erstellt ausserdem zu jedem Paket eine
<nowiki>$PAKETNAME_$VERSION-$UNTERVERSION_$ARCHITEKTUR.changes</nowiki> Datei.
(z.B. delixs-firstrun-config_0.1-58_all.deb)
Mit dieser Datei kann dput arbeiten.

'''INFO:'''
Zum Erstellen eines debian-Pakets sollten wir also nicht mehr
<code>fakeroot ./debian/rules binary</code> nutzen. Hierbei wird weder
die changes Datei noch die source-Dateien erstellt. Lasst uns also
wie später unten beschrieben mit dem alias svn-b arbeiten.

== dput ==
Dieses Programm ermöglicht es die binär- und source-Pakete in ein
debian Repository zu laden. Also auf solche 'Server', die du in der
/etc/apt/sources.list als Installationsquellen eintragen kannst.

dput unterstützt dabei mehrere Verfahren zum Hochladen, die wichtigsten
sind ftp,ssh/sftp und lokales Kopieren.

== mini-dinstall ==
dieses Programm erzeugt nun ein Repository mit allen Schickanen:

<source lang="bash">
$\tree
|-- delixs1
| |-- all
| | |-- Packages
| | |-- Packages.bz2
| | |-- Packages.gz
| | `-- Release
| |-- all.db
| |-- amd64
| | |-- Packages
| | |-- Packages.bz2
| | |-- Packages.gz
| | `-- Release
| |-- amd64.db
| |-- i386
| | |-- Packages
| | |-- Packages.bz2
| | |-- Packages.gz
| | `-- Release
| |-- i386.db
| `-- source
| |-- Sources
| |-- Sources.bz2
| `-- Sources.gz
</source>
* unter delixs/all liegen die architekturunabhängigen binären debian-Pakete (debs)
* unter delixs/amd64 liegen die binären amd64 debian-Pakete (debs)
* unter delixs/i386 liegen die binären i386 debian-Pakete (debs)
* unter source liegen alle Versionen dieser Pakete im source-Format. Jeweils eine dsc und eine tar.gz Datei

= Konfiguration =

== alias svn-b ==
Wenn du ein Paket bauen und hochladen möchtest, rufst du dafür i.A. svn-buildpackage auf. Folgenden alias solltest du in deine ~/.bashrc packen:
<source lang="bash">
alias svn-b="svn-buildpackage -us -uc -rfakeroot --svn-ignore"
</source>
Damit reicht ein '''svn-b''' zum Bauen des Pakets. Es wird dann eine Ebene höher im Order '''build-area''' liegen.

== der Benutzer dupload ==

== ~/.dput.cf ==
<source lang="properties">
[local]
method = local
hostname = localhost
incoming = ~/public_html/debian/mini-dinstall/incoming
run_dinstall = 0
allow_unsigned_uploads = 1
verify_sigs = 0
post_upload_command = /usr/bin/mini-dinstall --batch

[delixs]
method = sftp
hostname = deb.delixs.de
incoming = ./
run_dinstall = 0
verify_sigs = 0
</properties>

== ~/.mini-dinstall.conf ==
<source lang="properties">
# Adapted Colin's mini-dinstall.conf
# Infos unter /usr/share/doc/dput
# und http://debiananwenderhandbuch.de/mini-dinstall.html
[DEFAULT]
architectures = all, i386, amd64
archivedir = ~/public_html/debian/
use_dnotify = 0
verify_sigs = 0
#extra_keyrings = ~/.gnupg/pubring.gpg
mail_on_success = 0
archive_style = simple-subdir
poll_time = 10
mail_log_level = NONE
generate_release = 1
release_description = delixs Packages
# Releases:
[aramec]
[delixs1]
[delixs1-testing]
</properties>
== ~/.ssh/config ==
Damit dput beim Hochladen auf den dev-server (deb.delixs.de) sich gleich mit den korrekten Einstellugnen wie dem Benutzer verbindet, leg dir die Datei ~/.ssh/config mit folgendem Inhalt an:
<source lang="bash">
host deb.delixs.de
CheckHostIP no
User dupload
Ciphers arcfour
Protocol 2
IdentityFile ~/.ssh/id_dsa.dupload
<source>

== gpg-Schlüssel ==
Wenn du Pakete auf den dev-Server lädst, muss die Release Datei mit gpg signiert werden. Ansonsten würde jeder Server, der dieses Repository nutzt, über ein unsicheres Archiv meckern.

Darum musst du dich hier nicht kümmern, das erzeugt das Programm mini-dinstall auf dem Server. Bei dir im lokalen Repository brauchst du den Aufwand nicht treiben, lokal verfügbare Release-Dateien müssen nicht signiert werden.

= Beispiel =
Nachfolgend ein Beispiel, wo ich das (nicht existierende) Paket delixs-firstrun-config
in der Version 0.1-58 in das lokale Repository hochlade. Am Ende wird automatisch mini-dinstall ausgeführt.

<source lang="bash">
$ dput local delixs-firstrun-config_0.1-58_i3864.changes
$ \tree ~/public_html/debian/delixs1/
/home/thorsten/public_html/debian/delixs1/
|-- all
| |-- Packages
| |-- Packages.bz2
| |-- Packages.gz
| |-- Release
| `-- delixs-firstrun-config_0.1-58_all.deb
|-- all.db
|-- amd64
| |-- Packages
| |-- Packages.bz2
| |-- Packages.gz
| `-- Release
|-- amd64.db
|-- i386
| |-- Packages
| |-- Packages.bz2
| |-- Packages.gz
| `-- Release
|-- i386.db
|-- delixs-firstrun-config_0.1-58_i386.changes
`-- source
|-- Sources
|-- Sources.bz2
|-- Sources.gz
|-- delixs-firstrun-config_0.1-58.dsc
`-- delixs-firstrun-config_0.1-58.tar.gz

</source>

'''Erklärung:'''
* Unter all liegt das architekturunabhängige Paket delixs-firstrun-config_0.1-58_all.deb
* direkt im Ordner delixs1 liegt die changes-Datei.
* unter source liegen die beiden Dateien delixs-firstrun-config_0.1-58.{dsc,tar-gz}

Im Ordner, von dem du das Paket hochgeladen hast (wahrscheinlich build-area), wurde die Datei
delixs-firstrun-config_0.1-58_i386.upload angelegt. Der Inhalt:

<source lang="bash">
$ cat delixs-firstrun-config_0.1-58_i386.upload
Successfully uploaded delixs-firstrun-config_0.1-58.dsc to localhost.
Successfully uploaded delixs-firstrun-config_0.1-58.tar.gz to localhost.
Successfully uploaded delixs-firstrun-config_0.1-58_all.deb to localhost.
Successfully uploaded delixs-firstrun-config_0.1-58_i386.changes to localhost.
</source>
Durch dieses logfile weis dput, dass es die Datei nicht nochmal hochladen muss, wenn du es ein zweites Mal probieren solltest.

Entwicklerhandbuch/Paketverwaltung

2009-10-10T11:15:02Z

ThorstenStrusch: /* Beispiel */

Hi Leute,

ich habe mich gestern Abend mit den drei Paketen dput, mini-dinstall
und svn-buildpackage beschäftigt.

= Einführung =

== svn-buildpackage ==
Mit svn-buildpackage hast du die Möglichkeit debian Pakete
(die wir im SVN vohalten) für die entspr. Architekturen zu bauen.
Wir möchten i386 und amd64 unterstützen.
Es werden dabei binäre Debianpakete und source-Pakete erstellt.

Erstere erkennst du an der Dateiendung .deb, letztere bestehen aus
zwei Dateien. Eine endet auf dsc, die andere auf tar.gz.

Die source-Pakete kannst du herunterladen, wenn du in deiner
sources.list eine Zeile mit deb-src am Anfang stehen hast.
Die binären Dateien kannst du herunterladen, wenn du deb als
erstes Argument in der Zeile stehen hast.

svn-buildpackage erstellt ausserdem zu jedem Paket eine
<nowiki>$PAKETNAME_$VERSION-$UNTERVERSION_$ARCHITEKTUR.changes</nowiki> Datei.
(z.B. delixs-firstrun-config_0.1-58_all.deb)
Mit dieser Datei kann dput arbeiten.

'''INFO:'''
Zum Erstellen eines debian-Pakets sollten wir also nicht mehr
<code>fakeroot ./debian/rules binary</code> nutzen. Hierbei wird weder
die changes Datei noch die source-Dateien erstellt. Lasst uns also
wie später unten beschrieben mit dem alias svn-b arbeiten.

== dput ==
Dieses Programm ermöglicht es die binär- und source-Pakete in ein
debian Repository zu laden. Also auf solche 'Server', die du in der
/etc/apt/sources.list als Installationsquellen eintragen kannst.

dput unterstützt dabei mehrere Verfahren zum Hochladen, die wichtigsten
sind ftp,ssh/sftp und lokales Kopieren.

== mini-dinstall ==
dieses Programm erzeugt nun ein Repository mit allen Schickanen:

<source lang="bash">
$\tree
|-- delixs1
| |-- all
| | |-- Packages
| | |-- Packages.bz2
| | |-- Packages.gz
| | `-- Release
| |-- all.db
| |-- amd64
| | |-- Packages
| | |-- Packages.bz2
| | |-- Packages.gz
| | `-- Release
| |-- amd64.db
| |-- i386
| | |-- Packages
| | |-- Packages.bz2
| | |-- Packages.gz
| | `-- Release
| |-- i386.db
| `-- source
| |-- Sources
| |-- Sources.bz2
| `-- Sources.gz
</source>
* unter delixs/all liegen die architekturunabhängigen binären debian-Pakete (debs)
* unter delixs/amd64 liegen die binären amd64 debian-Pakete (debs)
* unter delixs/i386 liegen die binären i386 debian-Pakete (debs)
* unter source liegen alle Versionen dieser Pakete im source-Format. Jeweils eine dsc und eine tar.gz Datei

= Konfiguration =

== alias svn-b ==
Wenn du ein Paket bauen und hochladen möchtest, rufst du dafür i.A. svn-buildpackage auf. Folgenden alias solltest du in deine ~/.bashrc packen:
<source lang="bash">
alias svn-b="svn-buildpackage -us -uc -rfakeroot --svn-ignore"
</source>
Damit reicht ein '''svn-b''' zum Bauen des Pakets. Es wird dann eine Ebene höher im Order '''build-area''' liegen.

== der Benutzer dupload ==

== gpg-Schlüssel ==
Wenn du Pakete auf den dev-Server lädst, muss die Release Datei mit gpg signiert werden. Ansonsten würde jeder Server, der dieses Repository nutzt, über ein unsicheres Archiv meckern.

Darum musst du dich hier nicht kümmern, das erzeugt das Programm mini-dinstall auf dem Server. Bei dir im lokalen Repository brauchst du den Aufwand nicht treiben, lokal verfügbare Release-Dateien müssen nicht signiert werden.

= Beispiel =
Nachfolgend ein Beispiel, wo ich das (nicht existierende) Paket delixs-firstrun-config
in der Version 0.1-58 in das lokale Repository hochlade. Am Ende wird automatisch mini-dinstall ausgeführt.

<source lang="bash">
$ dput local delixs-firstrun-config_0.1-58_i3864.changes
$ \tree ~/public_html/debian/delixs1/
/home/thorsten/public_html/debian/delixs1/
|-- all
| |-- Packages
| |-- Packages.bz2
| |-- Packages.gz
| |-- Release
| `-- delixs-firstrun-config_0.1-58_all.deb
|-- all.db
|-- amd64
| |-- Packages
| |-- Packages.bz2
| |-- Packages.gz
| `-- Release
|-- amd64.db
|-- i386
| |-- Packages
| |-- Packages.bz2
| |-- Packages.gz
| `-- Release
|-- i386.db
|-- delixs-firstrun-config_0.1-58_i386.changes
`-- source
|-- Sources
|-- Sources.bz2
|-- Sources.gz
|-- delixs-firstrun-config_0.1-58.dsc
`-- delixs-firstrun-config_0.1-58.tar.gz

</source>

'''Erklärung:'''
* Unter all liegt das architekturunabhängige Paket delixs-firstrun-config_0.1-58_all.deb
* direkt im Ordner delixs1 liegt die changes-Datei.
* unter source liegen die beiden Dateien delixs-firstrun-config_0.1-58.{dsc,tar-gz}

Im Ordner, von dem du das Paket hochgeladen hast (wahrscheinlich build-area), wurde die Datei
delixs-firstrun-config_0.1-58_i386.upload angelegt. Der Inhalt:

<source lang="bash">
$ cat delixs-firstrun-config_0.1-58_i386.upload
Successfully uploaded delixs-firstrun-config_0.1-58.dsc to localhost.
Successfully uploaded delixs-firstrun-config_0.1-58.tar.gz to localhost.
Successfully uploaded delixs-firstrun-config_0.1-58_all.deb to localhost.
Successfully uploaded delixs-firstrun-config_0.1-58_i386.changes to localhost.
</source>
Durch dieses logfile weis dput, dass es die Datei nicht nochmal hochladen muss, wenn du es ein zweites Mal probieren solltest.

Entwicklerhandbuch/Paketverwaltung

2009-10-10T11:14:45Z

ThorstenStrusch: /* Beispiel */

Hi Leute,

ich habe mich gestern Abend mit den drei Paketen dput, mini-dinstall
und svn-buildpackage beschäftigt.

= Einführung =

== svn-buildpackage ==
Mit svn-buildpackage hast du die Möglichkeit debian Pakete
(die wir im SVN vohalten) für die entspr. Architekturen zu bauen.
Wir möchten i386 und amd64 unterstützen.
Es werden dabei binäre Debianpakete und source-Pakete erstellt.

Erstere erkennst du an der Dateiendung .deb, letztere bestehen aus
zwei Dateien. Eine endet auf dsc, die andere auf tar.gz.

Die source-Pakete kannst du herunterladen, wenn du in deiner
sources.list eine Zeile mit deb-src am Anfang stehen hast.
Die binären Dateien kannst du herunterladen, wenn du deb als
erstes Argument in der Zeile stehen hast.

svn-buildpackage erstellt ausserdem zu jedem Paket eine
<nowiki>$PAKETNAME_$VERSION-$UNTERVERSION_$ARCHITEKTUR.changes</nowiki> Datei.
(z.B. delixs-firstrun-config_0.1-58_all.deb)
Mit dieser Datei kann dput arbeiten.

'''INFO:'''
Zum Erstellen eines debian-Pakets sollten wir also nicht mehr
<code>fakeroot ./debian/rules binary</code> nutzen. Hierbei wird weder
die changes Datei noch die source-Dateien erstellt. Lasst uns also
wie später unten beschrieben mit dem alias svn-b arbeiten.

== dput ==
Dieses Programm ermöglicht es die binär- und source-Pakete in ein
debian Repository zu laden. Also auf solche 'Server', die du in der
/etc/apt/sources.list als Installationsquellen eintragen kannst.

dput unterstützt dabei mehrere Verfahren zum Hochladen, die wichtigsten
sind ftp,ssh/sftp und lokales Kopieren.

== mini-dinstall ==
dieses Programm erzeugt nun ein Repository mit allen Schickanen:

<source lang="bash">
$\tree
|-- delixs1
| |-- all
| | |-- Packages
| | |-- Packages.bz2
| | |-- Packages.gz
| | `-- Release
| |-- all.db
| |-- amd64
| | |-- Packages
| | |-- Packages.bz2
| | |-- Packages.gz
| | `-- Release
| |-- amd64.db
| |-- i386
| | |-- Packages
| | |-- Packages.bz2
| | |-- Packages.gz
| | `-- Release
| |-- i386.db
| `-- source
| |-- Sources
| |-- Sources.bz2
| `-- Sources.gz
</source>
* unter delixs/all liegen die architekturunabhängigen binären debian-Pakete (debs)
* unter delixs/amd64 liegen die binären amd64 debian-Pakete (debs)
* unter delixs/i386 liegen die binären i386 debian-Pakete (debs)
* unter source liegen alle Versionen dieser Pakete im source-Format. Jeweils eine dsc und eine tar.gz Datei

= Konfiguration =

== alias svn-b ==
Wenn du ein Paket bauen und hochladen möchtest, rufst du dafür i.A. svn-buildpackage auf. Folgenden alias solltest du in deine ~/.bashrc packen:
<source lang="bash">
alias svn-b="svn-buildpackage -us -uc -rfakeroot --svn-ignore"
</source>
Damit reicht ein '''svn-b''' zum Bauen des Pakets. Es wird dann eine Ebene höher im Order '''build-area''' liegen.

== der Benutzer dupload ==

== gpg-Schlüssel ==
Wenn du Pakete auf den dev-Server lädst, muss die Release Datei mit gpg signiert werden. Ansonsten würde jeder Server, der dieses Repository nutzt, über ein unsicheres Archiv meckern.

Darum musst du dich hier nicht kümmern, das erzeugt das Programm mini-dinstall auf dem Server. Bei dir im lokalen Repository brauchst du den Aufwand nicht treiben, lokal verfügbare Release-Dateien müssen nicht signiert werden.

= Beispiel =
Nachfolgend ein Beispiel, wo ich das (nicht existierende) Paket delixs-firstrun-config
in der Version 0.1-58 in das lokale Repository hochlade. Am Ende wird automatisch mini-dinstall ausgeführt.

<source lang="bash">
$ dput local delixs-firstrun-config_0.1-58_i3864.changes
$ \tree ~/public_html/debian/delixs1/
/home/thorsten/public_html/debian/delixs1/
|-- all
| |-- Packages
| |-- Packages.bz2
| |-- Packages.gz
| |-- Release
| `-- delixs-firstrun-config_0.1-58_all.deb
|-- all.db
|-- amd64
| |-- Packages
| |-- Packages.bz2
| |-- Packages.gz
| `-- Release
|-- amd64.db
|-- i386
| |-- Packages
| |-- Packages.bz2
| |-- Packages.gz
| `-- Release
|-- i386.db
|-- ksan-firstrun-config_0.1-58_i386.changes
`-- source
|-- Sources
|-- Sources.bz2
|-- Sources.gz
|-- delixs-firstrun-config_0.1-58.dsc
`-- delixs-firstrun-config_0.1-58.tar.gz

</source>

'''Erklärung:'''
* Unter all liegt das architekturunabhängige Paket delixs-firstrun-config_0.1-58_all.deb
* direkt im Ordner delixs1 liegt die changes-Datei.
* unter source liegen die beiden Dateien delixs-firstrun-config_0.1-58.{dsc,tar-gz}

Im Ordner, von dem du das Paket hochgeladen hast (wahrscheinlich build-area), wurde die Datei
delixs-firstrun-config_0.1-58_i386.upload angelegt. Der Inhalt:

<source lang="bash">
$ cat delixs-firstrun-config_0.1-58_i386.upload
Successfully uploaded delixs-firstrun-config_0.1-58.dsc to localhost.
Successfully uploaded delixs-firstrun-config_0.1-58.tar.gz to localhost.
Successfully uploaded delixs-firstrun-config_0.1-58_all.deb to localhost.
Successfully uploaded delixs-firstrun-config_0.1-58_i386.changes to localhost.
</source>
Durch dieses logfile weis dput, dass es die Datei nicht nochmal hochladen muss, wenn du es ein zweites Mal probieren solltest.

Entwicklerhandbuch/Paketverwaltung

2009-10-10T11:14:26Z

ThorstenStrusch: /* gpg-Schlüssel */

Hi Leute,

ich habe mich gestern Abend mit den drei Paketen dput, mini-dinstall
und svn-buildpackage beschäftigt.

= Einführung =

== svn-buildpackage ==
Mit svn-buildpackage hast du die Möglichkeit debian Pakete
(die wir im SVN vohalten) für die entspr. Architekturen zu bauen.
Wir möchten i386 und amd64 unterstützen.
Es werden dabei binäre Debianpakete und source-Pakete erstellt.

Erstere erkennst du an der Dateiendung .deb, letztere bestehen aus
zwei Dateien. Eine endet auf dsc, die andere auf tar.gz.

Die source-Pakete kannst du herunterladen, wenn du in deiner
sources.list eine Zeile mit deb-src am Anfang stehen hast.
Die binären Dateien kannst du herunterladen, wenn du deb als
erstes Argument in der Zeile stehen hast.

svn-buildpackage erstellt ausserdem zu jedem Paket eine
<nowiki>$PAKETNAME_$VERSION-$UNTERVERSION_$ARCHITEKTUR.changes</nowiki> Datei.
(z.B. delixs-firstrun-config_0.1-58_all.deb)
Mit dieser Datei kann dput arbeiten.

'''INFO:'''
Zum Erstellen eines debian-Pakets sollten wir also nicht mehr
<code>fakeroot ./debian/rules binary</code> nutzen. Hierbei wird weder
die changes Datei noch die source-Dateien erstellt. Lasst uns also
wie später unten beschrieben mit dem alias svn-b arbeiten.

== dput ==
Dieses Programm ermöglicht es die binär- und source-Pakete in ein
debian Repository zu laden. Also auf solche 'Server', die du in der
/etc/apt/sources.list als Installationsquellen eintragen kannst.

dput unterstützt dabei mehrere Verfahren zum Hochladen, die wichtigsten
sind ftp,ssh/sftp und lokales Kopieren.

== mini-dinstall ==
dieses Programm erzeugt nun ein Repository mit allen Schickanen:

<source lang="bash">
$\tree
|-- delixs1
| |-- all
| | |-- Packages
| | |-- Packages.bz2
| | |-- Packages.gz
| | `-- Release
| |-- all.db
| |-- amd64
| | |-- Packages
| | |-- Packages.bz2
| | |-- Packages.gz
| | `-- Release
| |-- amd64.db
| |-- i386
| | |-- Packages
| | |-- Packages.bz2
| | |-- Packages.gz
| | `-- Release
| |-- i386.db
| `-- source
| |-- Sources
| |-- Sources.bz2
| `-- Sources.gz
</source>
* unter delixs/all liegen die architekturunabhängigen binären debian-Pakete (debs)
* unter delixs/amd64 liegen die binären amd64 debian-Pakete (debs)
* unter delixs/i386 liegen die binären i386 debian-Pakete (debs)
* unter source liegen alle Versionen dieser Pakete im source-Format. Jeweils eine dsc und eine tar.gz Datei

= Konfiguration =

== alias svn-b ==
Wenn du ein Paket bauen und hochladen möchtest, rufst du dafür i.A. svn-buildpackage auf. Folgenden alias solltest du in deine ~/.bashrc packen:
<source lang="bash">
alias svn-b="svn-buildpackage -us -uc -rfakeroot --svn-ignore"
</source>
Damit reicht ein '''svn-b''' zum Bauen des Pakets. Es wird dann eine Ebene höher im Order '''build-area''' liegen.

== der Benutzer dupload ==

== gpg-Schlüssel ==
Wenn du Pakete auf den dev-Server lädst, muss die Release Datei mit gpg signiert werden. Ansonsten würde jeder Server, der dieses Repository nutzt, über ein unsicheres Archiv meckern.

Darum musst du dich hier nicht kümmern, das erzeugt das Programm mini-dinstall auf dem Server. Bei dir im lokalen Repository brauchst du den Aufwand nicht treiben, lokal verfügbare Release-Dateien müssen nicht signiert werden.

= Beispiel =
Nachfolgend ein Beispiel, wo ich das (nicht existierende) Paket delixs-firstrun-config
in der Version 0.1-58 in das lokale Repository hochlade. Am Ende wird automatisch mini-dinstall ausgeführt.

<source lang="bash">
$ dput local delixs-firstrun-config_0.1-58_i3864.changes
$ \tree ~/public_html/debian/delixs1/
/home/thorsten/public_html/debian/delixs1/
|-- all
| |-- Packages
| |-- Packages.bz2
| |-- Packages.gz
| |-- Release
| `-- delixs-firstrun-config_0.1-58_all.deb
|-- all.db
|-- amd64
| |-- Packages
| |-- Packages.bz2
| |-- Packages.gz
| `-- Release
|-- amd64.db
|-- i386
| |-- Packages
| |-- Packages.bz2
| |-- Packages.gz
| `-- Release
|-- i386.db
|-- ksan-firstrun-config_0.1-58_i386.changes
`-- source
|-- Sources
|-- Sources.bz2
|-- Sources.gz
|-- delixs-firstrun-config_0.1-58.dsc
`-- delixs-firstrun-config_0.1-58.tar.gz

</source>

'''Erklärung:'''
* Unter all liegt das architekturunabhängige Paket delixs-firstrun-config_0.1-58_all.deb
* direkt im Ordner delixs1 liegt die changes-Datei.
* unter source liegen die beiden Dateien delixs-firstrun-config_0.1-58.{dsc,tar-gz}

Im Ordner, von dem du das Paket hochgeladen hast (wahrscheinlich build-area), wurde die Datei
delixs-firstrun-config_0.1-58_i386.upload angelegt. Der Inhalt:

<source lang="bash">
$ cat ksan-firstrun-config_0.1-58_i386.upload
Successfully uploaded delixs-firstrun-config_0.1-58.dsc to localhost.
Successfully uploaded delixs-firstrun-config_0.1-58.tar.gz to localhost.
Successfully uploaded delixs-firstrun-config_0.1-58_all.deb to localhost.
Successfully uploaded delixs-firstrun-config_0.1-58_i386.changes to localhost.
</source>
Durch dieses logfile weis dput, dass es die Datei nicht nochmal hochladen muss, wenn du es ein zweites Mal probieren solltest.

Entwicklerhandbuch/Paketverwaltung

2009-10-10T11:11:59Z

ThorstenStrusch: /* alias svn-b */

Entwicklerhandbuch/Paketverwaltung

2009-10-10T11:08:38Z

ThorstenStrusch: /* mini-dinstall */

Entwicklerhandbuch/Repositorieverwaltung

2009-10-10T11:04:18Z

ThorstenStrusch: /* Konfigurationen */

'''Auf dieser Seite wird das Setup des dev-servers beschrieben. Möglicherweise gehört diese Seite ins trac!'''
= Funktionsweise =
Der Benutzer '''dupload''' hat über die sshd_config ein chroot unterhalb von ''$REPOSITORYROOT/mini-dinstall/incoming'' und darf nur sftp benutzen. Ein login ist ausschliesslich über einen ssh-key möglich.

incron überwacht das Repository auf eine .changes-Datei und stößt nach einem ''"IN_MODIFY,IN_CREATE"'' das Script mini-dinstall --batch aus.
Die Pakete werden daraufhin einsortiert und die Releases signiert.

= Aufbau des Repositories =
* URL: deb.delixs.de
* delixs1 für lenny als Unterbau
* delixs2 für squeezy als Unterbau

= Konfigurationen =
Nachfolgend Vorschläge über die Konfigurationsdateien der beteiligten Dienste
== Apache ==
<source lang="apache">
deb.delixs.de
</source>
== mini-dinstall ==
Pfad wo das Repository auf dem dev-Server liegt: '''/home/deb.delixs.de'''

=> '''Wollen wir mini-dinstall als root oder als seperater User laufen lassen?'''

<source lang="properties">
$ cat /home/$USER/.mini-dinstall.conf
# Adapted Colin's mini-dinstall.conf
# Infos unter /usr/share/doc/dput
# und http://debiananwenderhandbuch.de/mini-dinstall.html
[DEFAULT]
architectures = all, i386
archivedir = /home/deb.delixs.de/delixs/
use_dnotify = 0
verify_sigs = 0
# aktivieren, sobald key erzeugt ist
#extra_keyrings = ~/.gnupg/pubring.gpg
mail_on_success = 1
archive_style = simple-subdir
poll_time = 10
mail_log_level = NONE
generate_release = 1
release_description = delixs Packages
# Releases:
[aramec]
[delixs1]
[delixs1-testing]
</source>

== Benutzer dupload ==
Um nicht allen Entwicklern einen ssh-login auf dem dev-server geben zu müssen, legen wir den Benutzer dupload ''(debian-upload)'' ein, der im incoming Verzeichnis von mini-dinstall eingesperrt ist. Für ihn lassen wir ausschliesslich einen Zugang per ssh-key zu.

Sollte einmal der private-Teil verloren gehen, muss er bei allen Entwicklern ausgetauscht werden.

== sftp-chroot ==
Der Benutzer dupload bekommt keine loginshell, er darf nur sftp zum Hoch/runterladen benutzen:
<source lang="bash">
Subsystem sftp internal-sftp
Match user dupload
ChrootDirectory $REPOSITORYROOT/mini-dinstall/incoming
X11Forwarding no
AllowTcpForwarding no
ForceCommand internal-sftp
</source>

== incron Setup ==
brauchen wir ein seperates incron-setup oder funktioniert auch der dnotify-Support unter lenny?

== gpg-key ==
Zwei Möglichkeiten
# wir hinterlegen das Passwort auf der Platte im Klartext
# wir benutzen den gpg-agent, der es eine Weile im Speicher behält

Nachteil bei Möglichkeit 1: unsicher<br>
Nachteil bei Möglichkeit 2: man muss mind. nach jedem Reboot den agent wieder mit dem PW füttern

Entwicklerhandbuch/Repositorieverwaltung

2009-10-10T11:02:59Z

ThorstenStrusch: /* incron Setup */

'''Auf dieser Seite wird das Setup des dev-servers beschrieben. Möglicherweise gehört diese Seite ins trac!'''
= Funktionsweise =
Der Benutzer '''dupload''' hat über die sshd_config ein chroot unterhalb von ''$REPOSITORYROOT/mini-dinstall/incoming'' und darf nur sftp benutzen. Ein login ist ausschliesslich über einen ssh-key möglich.

incron überwacht das Repository auf eine .changes-Datei und stößt nach einem ''"IN_MODIFY,IN_CREATE"'' das Script mini-dinstall --batch aus.
Die Pakete werden daraufhin einsortiert und die Releases signiert.

= Aufbau des Repositories =
* URL: deb.delixs.de
* delixs1 für lenny als Unterbau
* delixs2 für squeezy als Unterbau

= Konfigurationen =

== Apache ==

== mini-dinstall ==
Pfad wo das Repository auf dem dev-Server liegt: '''/home/deb.delixs.de'''

=> '''Wollen wir mini-dinstall als root oder als seperater User laufen lassen?'''

<source lang="properties">
$ cat /home/$USER/.mini-dinstall.conf
# Adapted Colin's mini-dinstall.conf
# Infos unter /usr/share/doc/dput
# und http://debiananwenderhandbuch.de/mini-dinstall.html
[DEFAULT]
architectures = all, i386
archivedir = /home/deb.delixs.de/delixs/
use_dnotify = 0
verify_sigs = 0
# aktivieren, sobald key erzeugt ist
#extra_keyrings = ~/.gnupg/pubring.gpg
mail_on_success = 1
archive_style = simple-subdir
poll_time = 10
mail_log_level = NONE
generate_release = 1
release_description = delixs Packages
# Releases:
[aramec]
[delixs1]
[delixs1-testing]
</source>

== Benutzer dupload ==
Um nicht allen Entwicklern einen ssh-login auf dem dev-server geben zu müssen, legen wir den Benutzer dupload ''(debian-upload)'' ein, der im incoming Verzeichnis von mini-dinstall eingesperrt ist. Für ihn lassen wir ausschliesslich einen Zugang per ssh-key zu.

Sollte einmal der private-Teil verloren gehen, muss er bei allen Entwicklern ausgetauscht werden.

== sftp-chroot ==
Der Benutzer dupload bekommt keine loginshell, er darf nur sftp zum Hoch/runterladen benutzen:
<source lang="bash">
Subsystem sftp internal-sftp
Match user dupload
ChrootDirectory $REPOSITORYROOT/mini-dinstall/incoming
X11Forwarding no
AllowTcpForwarding no
ForceCommand internal-sftp
</source>

== incron Setup ==
brauchen wir ein seperates incron-setup oder funktioniert auch der dnotify-Support unter lenny?

== gpg-key ==
Zwei Möglichkeiten
# wir hinterlegen das Passwort auf der Platte im Klartext
# wir benutzen den gpg-agent, der es eine Weile im Speicher behält

Nachteil bei Möglichkeit 1: unsicher<br>
Nachteil bei Möglichkeit 2: man muss mind. nach jedem Reboot den agent wieder mit dem PW füttern

Entwicklerhandbuch/Repositorieverwaltung

2009-10-10T11:02:13Z

ThorstenStrusch: /* mini-dinstall */ Vorschlag zum Aufbau des Repositories

'''Auf dieser Seite wird das Setup des dev-servers beschrieben. Möglicherweise gehört diese Seite ins trac!'''
= Funktionsweise =
Der Benutzer '''dupload''' hat über die sshd_config ein chroot unterhalb von ''$REPOSITORYROOT/mini-dinstall/incoming'' und darf nur sftp benutzen. Ein login ist ausschliesslich über einen ssh-key möglich.

incron überwacht das Repository auf eine .changes-Datei und stößt nach einem ''"IN_MODIFY,IN_CREATE"'' das Script mini-dinstall --batch aus.
Die Pakete werden daraufhin einsortiert und die Releases signiert.

= Aufbau des Repositories =
* URL: deb.delixs.de
* delixs1 für lenny als Unterbau
* delixs2 für squeezy als Unterbau

= Konfigurationen =

== Apache ==

== mini-dinstall ==
Pfad wo das Repository auf dem dev-Server liegt: '''/home/deb.delixs.de'''

=> '''Wollen wir mini-dinstall als root oder als seperater User laufen lassen?'''

<source lang="properties">
$ cat /home/$USER/.mini-dinstall.conf
# Adapted Colin's mini-dinstall.conf
# Infos unter /usr/share/doc/dput
# und http://debiananwenderhandbuch.de/mini-dinstall.html
[DEFAULT]
architectures = all, i386
archivedir = /home/deb.delixs.de/delixs/
use_dnotify = 0
verify_sigs = 0
# aktivieren, sobald key erzeugt ist
#extra_keyrings = ~/.gnupg/pubring.gpg
mail_on_success = 1
archive_style = simple-subdir
poll_time = 10
mail_log_level = NONE
generate_release = 1
release_description = delixs Packages
# Releases:
[aramec]
[delixs1]
[delixs1-testing]
</source>

== Benutzer dupload ==
Um nicht allen Entwicklern einen ssh-login auf dem dev-server geben zu müssen, legen wir den Benutzer dupload ''(debian-upload)'' ein, der im incoming Verzeichnis von mini-dinstall eingesperrt ist. Für ihn lassen wir ausschliesslich einen Zugang per ssh-key zu.

Sollte einmal der private-Teil verloren gehen, muss er bei allen Entwicklern ausgetauscht werden.

== sftp-chroot ==
Der Benutzer dupload bekommt keine loginshell, er darf nur sftp zum Hoch/runterladen benutzen:
<source lang="bash">
Subsystem sftp internal-sftp
Match user dupload
ChrootDirectory $REPOSITORYROOT/mini-dinstall/incoming
X11Forwarding no
AllowTcpForwarding no
ForceCommand internal-sftp
</source>

== incron Setup ==

== gpg-key ==
Zwei Möglichkeiten
# wir hinterlegen das Passwort auf der Platte im Klartext
# wir benutzen den gpg-agent, der es eine Weile im Speicher behält

Nachteil bei Möglichkeit 1: unsicher<br>
Nachteil bei Möglichkeit 2: man muss mind. nach jedem Reboot den agent wieder mit dem PW füttern

Entwicklerhandbuch/Repositorieverwaltung

2009-10-10T10:56:04Z

ThorstenStrusch: /* Benutzer dupload */ Beschreibung über Sinn und Zweck dieses Benutzers

Entwicklerhandbuch/Repositorieverwaltung

2009-10-10T10:53:27Z

ThorstenStrusch: /* sftp-chroot */ sshd_config Vorschlag

Entwicklerhandbuch/Repositorieverwaltung

2009-10-10T10:50:40Z

ThorstenStrusch: /* Aufbau des Repositories */