Cette page explique comment mettre en place et maintenir un miroir Debian/Ubuntu

Pourquoi avoir un miroir local ?

• Installer un miroir Ubuntu sur son réseau local rend plus rapide l'installation et la mise à jour de paquets sur ses machines.
• Un miroir Debian permet d'installer et maintenir facilement son parc de serveur
• En effectuant les mises à jour des miroirs la nuit, cette méthode permet de libérer la bande passante le jour.

Contraintes

Il faut avoir une connection Internet correcte (256kbps minimum), stable, du courant la nuit et un GROS disque dur :

• 50Go pour Debian Etch+Lenny i386+amd64 (sans doute la moitié pour une seule architecture)

• 10Go pour Debian "security" Etch+Lenny i386+amd64 (mesuré le 4 mai 2009)

• 70Go pour Ubuntu Hardy+Intrepid+Jaunty i386

Attention : sur une bande passante moyenne, commencer un miroir à partir de rien n'est absolument pas raisonnable. Il faut commencer avec une archive de base qui sera soit un miroir assez récent obtenu chez un collègue (sur un disque dur USB2 par exemple), soit un ensemble de cédéroms ou dévédéroms (opération assez complexe, voir en bas de la page).

Principe général

1. Ecrire un script de mise à jour du miroir (par exemple dans /usr/local/bin/miroirs-debian.sn), voir des exemples ci-dessous

2. Créer un utilisateur miroir dédié à cet usage, lui donner les droits rwx dans les répertoires où seront téléchargés les miroirs (et nulle part ailleurs)

3. Tester le script en le lançant à la main, depuis cet utilisateur miroir

4. Si tout va bien, placer le script dans un cron. Par exemple :

   # extrait du fichier /etc/cron.d/miroirs
   
   # Lancement du miroir Debian tous les soirs à 20h, par l'utilisateur "miroir" créée spécifiquement :
   0 20 * * * miroir /usr/local/bin/miroirs-debian.sh
   # 4 heures plus tard, on lance le miroir d'Ubuntu :
   0 0 * * * miroir /usr/local/bin/miroirs-ubuntu.sh

Solution 1 (recommandée) : scripts utilisant debmirror

Installer d'abord le logiciel debmirror. Lisez la documentation (man debmirror et debmirror --help) : elle est très bien faite.

Ces scripts permettent de créer puis de mettre à jour un miroir :

• pour Debian : miroir-debian.sh

• pour Ubuntu : miroir-ubuntu.sh (voir aussi le patch sur debmirror ici)

Solution 2 (à valider) : apt-mirror

Solution actuellement utilisée pour les miroirs à Montréal. à confirmer

Solution actuellement utilisée pour les miroirs à Cotonou. En production depuis 17 mois.

• le paquet Debian

• c'est une solution qui semble mieux "maintenue" (debmirror, c'est quand même un gros hack)

• apt-mirror permet apparement de faire des mirroirs installables en réseau sans trop se fatiguer (c'est prévu, quoi, sans bidouiller)

• à tester : http://ubuntu-tutorials.com/2008/06/10/how-to-create-an-ubuntu-repository-mirror-on-ubuntu-804/

• Il faut créer un cron journalier (dans '/etc/cron.d/apt-mirror' par exemple) et y ajouter les lignes suivantes :

  # chez moi, c'est tous les jours à 20h qu'il se lance
  0 20    * * *   mirror_user    /usr/bin/apt-mirror  /Path_to_mirror_list/mirror.list > /Path_to_mirror_list/var/cron.log

• Et ensuite dans /Path_to_mirror_list/mirror.list

  # apt-mirror configuration file
  
  set base_path      /Path_to_mirror_directory
  # Les répertoires suivants doivent exister et être modifiable par mirror_user
  set mirror_path  $base_path/mirror
  set skel_path      $base_path/skel
  set var_path     $base_path/var
  #
  set defaultarch  i386,amd64
  set nthreads     20
  #
  set _tilde 0
  
  # Mirroirs à copier : ETCH
  deb http://ftp2.fr.debian.org/debian etch main contrib non-free
  deb http://ftp2.fr.debian.org/debian etch main/debian-installer
  
  deb http://ftp2.fr.debian.org/debian lenny main contrib non-free
  deb http://ftp2.fr.debian.org/debian lenny main/debian-installer
  
  # Mirroirs à copier : UBUNTU HARDY
  deb http://archive.ubuntu.com/ubuntu/ hardy main restricted universe multiverse
  deb http://archive.ubuntu.com/ubuntu/ hardy-updates main restricted universe multiverse
  deb http://archive.ubuntu.com/ubuntu/ hardy-backports main restricted universe multiverse
  
  deb http://archive.ubuntu.com/ubuntu/ hardy main/debian-installer restricted/debian-installer universe/debian-installer multiverse/debian-installer
  deb http://archive.ubuntu.com/ubuntu/ hardy-updates main/debian-installer restricted/debian-installer universe/debian-installer
  deb http://archive.ubuntu.com/ubuntu/ hardy-backports main/debian-installer
  
  # Mirroirs à copier : UBUNTU INTREPID
  deb http://archive.ubuntu.com/ubuntu intrepid main restricted universe multiverse
  deb http://archive.ubuntu.com/ubuntu intrepid-updates main restricted universe multiverse
  deb http://archive.ubuntu.com/ubuntu intrepid-backports main restricted universe multiverse
  
  deb http://archive.ubuntu.com/ubuntu intrepid main/debian-installer restricted/debian-installer universe/debian-installer multiverse/debian-installer
  deb http://archive.ubuntu.com/ubuntu intrepid-updates main/debian-installer
  deb http://archive.ubuntu.com/ubuntu intrepid-backports main/debian-installer
  
  # Cleaning section
  clean http://ftp2.fr.debian.org/
  
  skip-clean http://ftp2.fr.debian.org/doc/
  skip-clean http://ftp2.fr.debian.org/tools/
  skip-clean http://ftp2.fr.debian.org/debian-cd/
  skip-clean http://ftp2.fr.debian.org/debian-minicd/
  skip-clean http://ftp2.fr.debian.org/debian/dists/lenny/main/installer-i386/
  skip-clean http://ftp2.fr.debian.org/debian/dists/etch/main/installer-i386/
  skip-clean http://ftp2.fr.debian.org/debian/doc/
  skip-clean http://ftp2.fr.debian.org/debian/tools/
  skip-clean http://ftp2.fr.debian.org/debian/project/
  skip-clean http://ftp2.fr.debian.org/debian-non-US/project/
  clean http://archive.ubuntu.com/ubuntu

Solution 3 (à tester) : reprepro

Nous ne l'avons encore jamais mis en place, mais elle semble intéressante. Voir ici : http://lostwebsite.wordpress.com/2008/10/21/partial-debian-mirrors/

Faire le miroir d'un (ou plusieurs) PPA, avec debmirror

PPA (Personal Package Archives) est un système qui permet à tout le monde de faire héberger ses paquets sur Launchpad, le système de Canonical/Ubuntu. Voici un script debmirror-ppa.sh qui appelle debmirror avec les bons paramètres pour faire le miroir d'un PPA donné.

Annexes

Un problème avec le debmirror de Etch pour les miroirs Ubuntu

Le problème indiqué ci-dessous se pose avec la version debmirror de Etch. La version de debmirror fournie avec Lenny est plus intelligente (à bon entendeur...).

Les sites d'Ubuntu ont un problème : ils ne possèdent pas de section "restricted/debian-installer" au niveau de *-security", *-updates ou *-backports... Ca fait planter les miroirs quand on veut y intégrer le système d'installation par réseau. C'est très génant.

Une façon de contourner ce problème est d'installer la version de debmirror fournie par Lenny. Pour cela, téléchargez uniquement le fichier .deb du paquet, et installez-le avec dpkg.

Une autre façon de contourner ce problème est de modifier debmirror, afin qu'il ne copie pas la section dans certains cas. Pour cela, il faut ajouter une ligne dans /usr/bin/debmirror (la ligne 727 ci-dessous) :

• (... extrait de /usr/bin/debmirror avec ajout de la ligne 727 ...)
   718 foreach my $dist (@dists) {
   719   foreach my $section (@sections) {
   720     # no d-i in woody
   721     next if ($section =~ /debian-installer/ && $dist eq "woody");
   722     next if ($section =~ /debian-installer/ && $dist eq "experimental");
   723     next if ($section =~ /debian-installer/ && $dist =~ /.*-proposed-updates/);
   724     next if ($section =~ /debian-installer/ && $dist =~ /.*breezy-updates/ );
   725     next if ($section =~ /debian-installer/ && $dist eq "breezy-security" );
   726     # FIXME AUF (LIGNE A AJOUTER) : il n'y a pas de restricted/debian-installer dans les Ubuntu security & updates & backports
   727     next if ($section =~ /restricted\/debian-installer/ && $dist =~ /(dapper|hardy|intrepid|jaunty|karmic)-(security|updates|backports)/ );
   728 
   729     foreach my $arch (@arches) {
   730       get_index("dists/$dist/$section/binary-$arch", "Packages");
   731     }
   732     get_index("dists/$dist/$section/source", "Sources") if ($do_source);
   733   }
   734 }
  (...)

Débuter un miroir à partir des cédéroms

Les DVD de Debian et Ubuntu alternate (etch, gutsy et hardy sont les distributions pour lesquels j'ai testé cette méthode) comporte une arborescence classique comprenant les répertoires pool et dists à la racine de chaque dvd. Pool contient les différents paquets de la distribution, et dists contient pour chaque distributions (en supposant qu'on dispose de dvd de plusieurs distributions de ubuntu par exemple) la liste des paquets et les versions correspondantes. Les paquets décrits dans les listes contenues dans les répertoires dists sont en principe dans le répertoire pool.

Pour copier le contenu de ces répertoires vers la racine de notre miroir, l'utilisation de rsync par exemple peut être envisagé de la façon suivante pour chaque DVD :

# mount /media/cdrom
$ rsync -av /media/cdrom/pool /srv/www/miroirs/ubuntu/pool
$ rsync -av /media/cdrom/dists /srv/www/miroirs/ubuntu/dists
# umount -l /media/cdrom

Une fois tous les dvd copiés, il suffit de mettre en marche les différents scripts présentés ci-dessus pour terminer la mise à jour du miroir et le téléchargement des dernières versions des fichiers Release, Packages et Contents.

Vérifier la place occupée par distribution/section/architecture

Voici un petit script permettant de calculer la place utilisée globalement ou par distribution, section ou architecture dans le miroir : taille-miroir.sh

Attention : vu que tout est mis en vrac dans un pool, il se base sur les informations déclarées dans les fichiers Packages, ce qui suppose donc un miroir en bon état faute de quoi les calculs ne refléteraient pas la réalité.