Guide pratique des référentiels Debian

Référentiels Debian HOWTO, Copyright (c) 2002-2003 Aaron Isotton. Permission est donnée de copier, distribuer ou modifier ce document selon les termes de la GNU Free Documentation License, version 1.1 ou suivante, publié par la Free Software Foundation ; sans Sections Invariables, sans Texte de Première de Couverture, et sans Texte de Quatrième de Couverture.

Les réactions sur ce document sont les bienvenues. Envoyez en anglais vos ajouts, vos commentaires et critiques à l'adresse suivante : <[email protected]>.

Toutes les remarques concernant cette traduction peuvent être envoyées à l'adresse suivante <[email protected]> ou à la liste de diffusion <[email protected]>

La structure des répertoires d'un référentiel automatique pour les architectures et les composants standards de Debian doit ressemblé à ça :

(racine du référentiel) 
| 
+-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
	 

Les paquets libres sont placés dans la section main ; les paquets non libres dans la section non-free et les paquets libres dépendant de paquets non-free sont placés dans la section contrib. Debian s'installe actuellement sur onze architectures différentes ; la plupart d'entre elles ont été omises dans l'exemple pour rester concis.

Chaque répertoire binary-* contient un fichier Packages.gz et un fichier Release optionnel. Chaque répertoire source contient un fichier Sources.gz et un fichier Release optionnel. Notez que les paquets n'ont pas besoin d'être dans le même répertoire que les catalogues ; car le chemin de chaque paquet est contenu dans les catalogues. De ce fait, les paquets peuvent être mis n'importe ou dans le référentiel. Ce qui rend possible la création de «  pools ».

Vous êtes libre de créer autant de distributions et de composants et de les nommer comme vous le souhaitez. Ceux pris dans les exemple sont ceux utilisés par Debian. Il est possible par exemple de créer les distributions courante et bêta (au lieu de stable, testing et unstable), et les composants foo, bar, baz et qux (à la place de main, contrib et non-free).

Bien que vous soyez libre de nommer les composants comme vous le souhaitez, Il est préférable d'utiliser les noms standards, car c'est ce qu'attendent les utilisateurs de Debian.

Un référentiel trivial est composé d'un répertoire racine et de plusieurs sous-répertoires. Comme l'utilisateur doit spécifier le chemin de la racine du référentiel ainsi que le chemin relatif entre la racine et le répertoire contenant les catalogues, vous êtes libre de faire ce que vous désirez (même mettre tout à la racine du référentiel. Dans ce cas, le chemin relatif sera très simple : « / »).

(racine du référentiel)
|
|-binary
+-source
    
	

La commande dpkg-scanpackages permet de générer le fichier Packages et la commande dpkg-scansources le fichier Sources.

Le résultat des deux commandes est affiché sur la sortie standard ; ainsi pour générer un fichier compressé, vous pouvez utiliser une commande comme : dpkg-scanpackages arguments | gzip -9c > Packages.gz.

Les deux commandes fonctionnent de la même manière ; elles prennent deux arguments (en réalité il y en a plus, reportez-vous aux pages de manuel pour en savoir plus). Le premier est le répertoire où sont les paquets, et le second est un fichier override. Pour un simple référentiel le fichier override n'est pas nécessaire, mais l'argument est obligatoire, utilisez simplement /dev/null.

La commande dpkg-scanpackages recherche les paquets avec l'extension .deb et dpkg-scansources les fichiers avec l' extension .dsc. Il est nécessaire de mettre les fichiers .orig.gz, .diff.gz et .dsc ensemble. Le fichier .changes n'est pas utilisé.

Ainsi, si vous avez un référentiel trivial comme celui de Exemple 2, «  Un référentiel trivial avec deux sous-répertoires », vous pouvez créer les catalogues de la façon suivante :

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

Si votre référentiel est plus complexe comme celui de Exemple 1, « Un référentiel Debian standard », vous devriez écrire des scripts pour automatiser le processus.

Vous pouvez aussi utiliser l'argument pathprefix avec les deux commandes pour simplifier la syntaxe ; ceci est laissé comme exercice pour le lecteur (reportez-vous aux pages de manuel).

Si vous souhaitez que les utilisateurs puissent utiliser l'étiquetage « Pinning » avec votre référentiel, vous devez inclure un fichier Release dans chaque répertoire contenant les catalogues. (Vous pouvez consulter le APT HOWTO pour plus d'information sur l'étiquetage).

Le fichier Release est un simple fichier texte de la forme suivante :

    Archive: archive
    Component: composant
    Origin: votre Compagnie
    Label: YourCompany Debian repository
    Architecture: architecture
	

Il est important d'avoir des valeurs correctes pour les champs Archive et Architecture, car ce sont les plus utilisés pour l'étiquetage. Les autres champs sont moins importants.

Avec les référentiels automatiques, distribuer les paquets dans des répertoires différents peut devenir rapidement difficile à administrer. Il y a aussi de l'espace disque ainsi que de la bande passante gâché, car il y a beaucoup de paquets (par exemple les paquets de documentation) identiques dans toutes les architectures.

Dans ce cas, une solution possible est un pool. Un pool est un répertoire supplémentaire à la racine du référentiel qui regroupe tous les paquets (les binaires pour toutes les architectures, toutes les distributions et tous les composants ainsi que toutes les sources). Au travers d'une combinaison adéquate des fichiers override. Un bon exemple de référentiel incluant un pool est le référentiel Debian.

Les pools sont seulement utiles pour des référentiels importants. Je n'ai jamais fait de référentiel semblable et je ne pense pas en avoir besoin prochainement, c'est pourquoi je n'expliquerai pas comment faire. Si vous pensez qu'une section doit être ajoutée, vous êtes libre de l'écrire. Contactez-moi alors pour que je la rajoute.

Il existe différents outils pour automatiser et faciliter la création des archives Debian ; j'ai listé les plus importants.

apt-ftparchive est utilisé pour déplacer un ensemble de paquets Debian dans une arborescence du type de celle utilisée dans les archives officielles de Debian. Cette commande fait partie du paquet apt-utils.

apt-move est utilisé pour déplacer un ensemble de paquets Debian dans une arborescence du type de celle utilisée dans les archives officielles de Debian.