Debian-Depot-HOWTO

Copyright 2002–2003 Aaron Isotton Kopieren, Verbreiten und/oder Modifizieren ist unter den Bedingungen der GNU Free Documentation License, Version 1.1 oder einer späteren Version, veröffentlicht von der Free Software Foundation, erlaubt. Es gibt keine unveränderlichen Abschnitte, keinen vorderen Umschlagtext und keinen hinteren Umschlagtext.

Rückmeldungen zu diesem Dokument sind sehr willkommen. Bitte senden Sie Ihre Ergänzungen, Kommentare und Kritiken an folgende E-Mail-Adresse: <[email protected]> (auf Englisch).

Feedback zur Übersetzung schicken Sie bitte an <[email protected]>.

Die Verzeichnisstruktur von einem automatischen Depot mit den Standard-Debian-Architekturen und Komponenten sieht wie folgt aus:

(Ihr Depot-Verzeichnisbaum)
|
+-dists
  |
  |-stable
  | |-main
  | | |-binary-alpha
  | | |-binary-arm
  | | |-binary-...
  | | +-source
  | |-contrib
  | | |-binary-alpha
  | | |-binary-arm
  | | |-binary-...
  | | +-source
  | +-non-free
  |   |-binary-alpha
  |   |-binary-arm
  |   |-binary-...
  |   +-source
  |
  |-testing
  | |-main
  | | |-binary-alpha
  | | |-binary-arm
  | | |-binary-...
  | | +-source
  | |-contrib
  | | |-binary-alpha
  | | |-binary-arm
  | | |-binary-...
  | | +-source
  | +-non-free
  |   |-binary-alpha
  |   |-binary-arm
  |   |-binary-...
  |   +-source
  |
  +-unstable
    |-main
    | |-binary-alpha
    | |-binary-arm
    | |-binary-...
    | +-source
    |-contrib
    | |-binary-alpha
    | |-binary-arm
    | |-binary-...
    | +-source
    +-non-free
      |-binary-alpha
      |-binary-arm
      |-binary-...
      +-source

Die freien Pakete kommen in main; die nicht-freien in non-free und die freien, die von einem nicht-freien Paket abhängen, kommen in contrib. Debian unterstützt momentan 11 Architekturen; ich habe die meisten davon aufgrund der Länge ausgespart.

Jedes binary-*-Verzeichnis enthält eine Packages.gz und eine optionale Release-Datei. Jedes source-Verzeichnis enthält eine Sources.gz und eine optionale Release-Datei. Beachten Sie, dass die Pakete nicht im selben Verzeichnis wie die Index-Dateien liegen dürfen, weil die Index-Dateien die Pfade zu den verschiedenen Paketen enthalten; in Wirklichkeit können sie überall sonst im Depot liegen. Dies macht es möglich, Pools zu erstellen.

Sie können so viele Distributionen und Gruppen anlegen und benennen, wie Sie wollen. Die von mir im Beispiel benutzten sind lediglich die, die von Debian verwendet werden. Sie können zum Beispiel die Distribution current und beta (anstelle von stable, testing und unstable) und die Gruppen foo, bar, baz und qux (anstelle von main, contrib und non-free) verwenden.

Obwohl Sie die Möglichkeit haben die Gruppen zu benennen wie Sie wollen, ist es erstmal eine gute Idee, die Standard-Distributionen von Debian zu benutzen, weil diese den Debian-Benutzern bekannt sind.

Triviale Depots bestehen aus einem Hauptverzeichnis und so vielen Unterverzeichnissen wie Sie wollen. Da der Benutzer den Pfad zum Hauptverzeichnis des Depots und den relativen Pfad vom Hauptverzeichnis zum Verzeichnis mit den Index-Dateien angeben muss, können Sie machen was Sie wollen (sogar alles in das Hauptverzeichnis des Depots packen. In dem Fall ist der relative Pfad sehr leicht „/“).

(Ihr Depot-Verzeichnisbaum)
|
|-binary
+-source

dpkg-scanpackages generiert die Packages-Datei und dpkg-scansources die Sources-Datei.

Beide schicken ihre Ausgabe an stdout. Dadurch können Sie, zum Erstellen einer komprimierten Datei, ein Kommando wie dieses verwenden: dpkg-scanpackages Argumente | gzip -9c > Packages.gz.

Die zwei Werkzeuge arbeiten auf die selbe Weise; beide erhalten zwei Argumente (in Wirklichkeit sind es mehr, aber ich möchte hier nicht näher darauf eingehen; Sie können gerne die Handbuchseiten lesen, wenn Sie mehr wissen wollen). Als erstes das Verzeichnis in dem die Pakete liegen und das zweite ist die Überschreibdatei (override). Für einfache Depots brauchen wir keine Überscheibdateien, aber da es ein benötigtes Argument ist, geben wir einfach /dev/null an.

dpkg-scanpackages durchsucht die .deb-Pakete; dpkg-scansources durchsucht die .dsc-Dateien. Folglich ist es nötig die .orig.gz-, .diff.gz- und .dsc-Dateien an die selbe Stelle zu legen. Die .changes-Dateien werden nicht gebraucht.

Falls Sie ein »triviales Depot« wie das aus Beispiel 2, „Ein triviales Depot mit zwei Unterverzeichnisen“ haben, können Sie die zwei Index-Dateien wie folgt generieren:

$ cd mein-Depot
$ dpkg-scanpackages binary /dev/null | gzip -9c > binary/Packages.gz
$ dpkg-scansources source /dev/null | gzip -9c > source/Sources.gz

Wenn Sie ein komplexes Depot wie bei Beispiel 1, „Ein Standard-Debian-Depot“ haben, müssen Sie ein paar Skripte schreiben, um diesen Prozess zu automatisieren.

Sie können auch das Verzeichnispräfix-Argument der zwei Werkzeuge benutzen, um die Syntax ein wenig zu vereinfachen. Ich überlasse dies als Übung dem Leser. (Es ist in den Handbuchseiten dokumentiert).

Wenn Sie dem Benutzer Ihres Depots erlauben wollen Pinning (Anheften) mit Ihrem Depot zu nutzen, müssen Sie eine Release-Datei in jedem Verzeichnis mit Index-Dateien hinzufügen. (Sie können mehr über Anheften im APT-HOWTO) erfahren.

Die Release-Dateien sind einfache und kurze Textdateien der folgenden Form:

Archive: Archiv
Component: Gruppe
Origin: Ihre Firma
Label: Debian-Depot Ihrer Firma
Architecture: Architektur

Es ist wichtig Archive und Architecture korrekt anzugeben, da sie am meisten zum Anheften verwendet werden. Die anderen sind dagegen weniger wichtig.

Bei automatischen Depots wird das Veröffentlichen der Pakete in den verschiedenen Verzeichnissen schnell zu einer unmöglichen Aufgabe. Es ist außerdem eine große Verschwendung von Platz und Bandbreite, da es Pakete gibt (zum Beispiel Dokumentationspakete), welche für jede Architektur gleich sind.

In diesem Fall ist ein Pool eine mögliche Lösung. Ein Pool ist ein zusätzliches Verzeichnis im Hauptverzeichnis eines Depots, welches alle Pakete (die binären für alle Architekturen, Distributionen und Gruppen und alle Quellen) enthält. Durch eine Kombination von Überschreibdateien (welche nicht in diesem Dokument behandelt werden) und Skripten können viele Probleme vermieden werden. Ein schönes Beispiel für ein Pool-Depot ist das Debian-Depot selbst.

Pools sind nur für große Depots sinnvoll. Ich habe nie welche erstellt und werde wohl auch in naher Zukunft keine erstellen müssen, deshalb werde ich hier nicht beschreiben, wie Sie diese erstellen können. Wenn Sie meinen, dass ein Kapitel dazu ergänzt werden sollte, fühlen Sie sich frei eines zu verfassen und mich zu kontaktieren.

Es gibt verschiedene Werkzeuge, um die Erstellung eines Debian-Archivs zu automatisieren und vereinfachen. Ich habe die bekanntesten Werkzeuge hier aufgezählt.

apt-ftparchive wird benutzt, um eine Kollektion von Debian-Paketdateien in eine geeignete Archivhierarchie, wie die vom offiziellen Debian-Archiv, einzugliedern. Es ist ein Teil des apt-utils-Paketes.

apt-move wird benutzt um eine Kollektion von Debian-Paketdateien in eine geeignete Archivhierarchie, wie sie vom offiziellen Debian-Archiv verwendet wird, zu verschieben.