[LCFC] webwml://mirror/{ftpmirror,official}.wml [maj]
On Wed, Feb 25, 2009 at 07:45:39AM +0100, Jean-Michel OLTRA wrote:
> Le mardi 24 février 2009, Simon Paillard a écrit...
> > Après la mise à jour de la version anglaise, voici la mise à jour de la
> > version française.
>
> 2 diff's
Merci Jean-Michel.
J'ai tout intégré, excepté un parapgraphe que tu sembles avoir supprimé
par erreur (?).
Dernière chance pour les relectures.
--
Simon Paillard
#use wml::debian::template title="Mettre en place un miroir de l'archive Debian"
#use wml::debian::toc
#include "$(ENGLISHDIR)/releases/sid/archive.data"
#use wml::debian::translation-check translation="1.66" maintainer="Simon Paillard"
<toc-display />
<toc-add-entry name="whether">Dans quel cas faire un miroir ?</toc-add-entry>
<p>Même si nous apprécions tout nouveau miroir, chaque responsable potentiel de
miroir doit s'assurer qu'il peut répondre aux questions suivantes avant de commencer
à mettre en place son propre miroir :</p>
<ul>
<li>Un miroir est-il nécessaire dans ma région ? Il existe peut-être déjà
d'autres miroirs à proximité.</li>
<li>Ai-je les ressources nécessaires pour héberger un miroir ? Les miroirs
occupent une quantité importante d'espace disque et de bande passante, dont
il faut s'engager à supporter le coût.</li>
<li>Un miroir est-il le bon choix ? Parfois, certaines personnes démarrent
un miroir par erreur, alors qu'en fait elles veulent un serveur cache
mandataire (<q>proxy cache</q>).</li>
# such as <a href="http://packages.debian.org/apt-proxy";>apt-proxy</a>
# not sure if we want to plug just apt-proxy as soon as this -joy, 2007-11-08
</ul>
<toc-add-entry name="what">De quoi faire un miroir ?</toc-add-entry>
<p>La <a href="./">page principale des miroirs</a> liste les archives qu'il est
possible de dupliquer.
</p>
<ul>
<li>
Les utilisateurs cherchent l'archive dans debian/ pour installer Debian
par le réseau, pour construire des CD (avec jigdo), ou pour mettre à
jour des systèmes déjà installés.</li>
<li>
debian-cd/ est une archive qui n'est pas identique sur tous les différents
serveurs miroirs. Sur certains sites, elle contient des modèles pour jigdo
(utilisés avec les fichiers dans debian/) à partir desquels il est possible de
construire des images de CD, sur certains des images de CD déjà construites, et
sur d'autres les deux.
<br />
De plus amples informations sont disponibles sur la page dédiée à la <a
href="$(HOME)/CD/mirroring/">création d'un miroir pour les images de CD de
Debian</a></li>
<li>
debian-archive/ contient la véritable <em>archive</em>, les anciennes versions
obsolètes de Debian. Elle n'est en général intéressante que pour une petite
partie des utilisateurs.
</li>
</ul>
<p>Veuillez voir la page des <a href="size">tailles des miroirs</a>
pour des informations plus précises sur les tailles des miroirs.</p>
<p>L'archive debian-security/ contient les mises à jour de sécurité éditées par
l'équipe de sécurité de Debian. Elle semble intéressante pour tout le monde,
mais comme les mises à jour de sécurité sont sporadiques, il faudrait
synchroniser le miroir très souvent pour être à jour (ou utiliser <a
href="push_mirroring">un miroir <i>push</i></a>) aussi nous ne recommandons pas
de la dupliquer. Au lieu de cela, Debian fait tous les efforts possibles pour
conserver la haute disponibilité de security.debian.org.</p>
<p>N.B. : l'archive debian-non-US est obsolète depuis la sortie
de Debian 3.1 (<em>Sarge</em>) en juin 2006.</p>
<toc-add-entry name="wherefrom">À partir d'où faire un miroir ?</toc-add-entry>
<p>Beaucoup de gens pensent que <code>ftp.debian.org</code> est
l'emplacement canonique des paquets Debian et que faire un miroir de
ce site est ce qu'il y a de mieux. <strong>Ce n'est pas vrai</strong>.</p>
<p><code>ftp.debian.org</code> est seulement l'un des serveurs mis à jour à
partir d'un serveur Debian interne. Cette adresse pointe actuellement vers un
unique serveur hébergé aux États-Unis, et existe encore principalement pour des
raisons de compatibilité ascendante.</p>
<p>Les <a href="official">miroirs officiels</a> sont censés être de bonnes
sources. Tout serveur parmi ceux qui se trouvent dans la <a
href="list-full">liste complète des miroirs</a> portant la marque
<q><kbd>Type: Push-Primary</kbd></q> ou <q><kbd>Type:
Push-Secondary</kbd></q> est un bon candidat pour la source d'un miroir.
Merci d'utiliser un miroir qui soit proche de vous, au sens de la
proximité réseau.</p>
<p>Il n'y a pas de différences significatives entre différents miroirs
serveurs <em>Push-Primary</em> comme origine du miroir. De plus, si
beaucoup de gens utilisent <code>ftp.debian.org</code> (et
malheureusement c'est le cas), cela gaspille inutilement la bande
passante que l'on nous donne.</p>
<p>Les administrateurs de miroirs situés aux États-Unis devraient mettre à jour
leur miroir depuis ftp.us.debian.org (le miroir officiel pour les États-Unis,
qui est un miroir <q>Push-Primary</q>). Or comme cette adresse est un alias
pour plusieurs serveurs, il est recommandé de déterminer lequel vous convient
le mieux et de mettre à jour le miroir depuis l'un d'entre eux.
<br />
<small>Cela a pour avantage d'éviter les ennuis lors du rsync en deux étapes
(puisque les différentes étapes risquent d'être effectuées sur des serveurs
différents, et tomber à des instants où les données sont différentes,
provoquant une problème de concurrence).</small></p>
<toc-add-entry name="how">Comment faire un miroir</toc-add-entry>
<p>La méthode recommandée pour faire tourner un miroir est d'utiliser
le script ftpsync, disponible de deux manières :</p>
<ul>
<li>sous la forme d'une archive à l'adresse <url "http://ftp-master.debian.org/ftpsync.tar.gz";></li>
<li>via le dépôt git : <kbd>git clone https://ftp-master.debian.org/git/archvsync.git</kbd></li>
</ul>
<p>Le protocole recommandé est <a href="http://packages.debian.org/stable/net/rsync";>rsync</a>.</p>
<p>Merci de ne pas utiliser <kbd>wget</kbd> ou d'autres outils FTP.
Ils semblent fonctionner correctement, mais posent beaucoup de problèmes : ils
ne détectent pas les liens réels « hard », il est difficile d'effectuer des répliques
partielles de l'archive, etc.</p>
<h3>Configuration de rsync</h3>
<p>Nous recommandons l'utilisation de <a href="http://ftp-master.debian.org/ftpsync.tar.gz";>ftpsync</a> pour faire un miroir de l'archive. Suivez les indications
se trouvant dans le fichier README pour mettre en place le miroir.</p>
<p>Si vous devez utiliser vos propres scripts, ceux-ci doivent intégrer les
fonctionnalités indispensables ci-dessous :</p>
<ul>
<li><p>la synchronisation DOIT se faire en deux étapes</p>
<p>La mise à jour de l'archive doit être effectuée en deux étapes.
Lors du premier passage de rsync, les fichiers d'index doivent être ignorés,
en utilisant la liste d'exclusion suivante :</p>
<kbd>--exclude Packages* --exclude Sources* --exclude Release* --exclude ls-lR*</kbd>
<p>La première étape ne doit pas supprimer un seul fichier.</p>
<p>La seconde étape doit ensuite effectuer le transfert des fichiers exclus
ci-dessus et supprimer les fichiers qui n'appartiennent plus à l'archive.</p>
<p>Explication : lorsque la mise à jour de l'archive est faite en une seule étape,
les fichiers d'index référencent des fichiers qui n'ont pas encore été récupérés.</p>
</li>
<li><p>un script en cours ne DOIT pas ignorer les signaux de déclenchement
(dans le cas de <a href="push_mirroring">miroir par repoussage</a>).</p>
<p>Si un signal est reçu alors qu'une mise à jour du miroir est en cours,
celui-ci ne DOIT PAS être ignoré. La mise à jour complète du miroir doit alors
être effectuée à nouveau.</p>
<p>Explication : si un second signal est reçu alors qu'une première mise à
jour est en cours, la plupart des scripts pour miroirs Debian laissent le
miroir dans un état incohérent.
Dans un futur proche, la fréquence de mise à jour de l'archive augmentera
probablement.</p>
</li>
<li>Lancez rsync avec au moins les options suivantes :
<kbd>--recursive --times --links --hard-links --delete</kbd>.</li>
<li>Même si vous avez de la place disque supplémentaire, utilisez
l'option <kbd>--delete-after</kbd> pour éviter des problèmes de mise
à jour temporaire.</li>
<li>Une fois que rsync a fini de mettre à jour le miroir, ajoutez
un fichier « timestamp » au sous-répertoire
<code>project/trace/</code> du miroir Debian ayant le nom de votre
serveur. Cela signifie lancer <kbd>date -u >
.../debian/project/trace/<var>votre.serveur</var></kbd>
une fois que votre rsync journalier est terminé.</li>
<li>Nous déconseillons vivement d'exclure les sous-répertoires
<tt>project/</tt>, <tt>doc/</tt> et autres. Ils sont généralement
négligeables en terme de taille et cependant utiles aux utilisateurs.
En particulier <tt>project/trace</tt> aide beaucoup en cas de
problème de miroir.</li>
</ul>
<toc-add-entry name="partial">Miroir partiel</toc-add-entry>
<p>Considérant la <a href="size">taille déjà importante de l'archive
Debian</a>, certaines personnes préfèrent ne faire un miroir que des
quelques parties dont ils ont besoin. Si vous voulez en
exclure une partie, vous devriez exclure les architectures.</p>
<p>Avec le script recommandé <a href="http://ftp-master.debian.org/ftpsync.tar.gz";>ftpsync</a>,
cela peut se faire en modifiant la variable ARCH_EXCLUDE.</p>
<p>Nous déconseillons vivement d'exclure les sous-répertoires
<tt>project/</tt>, <tt>doc/</tt> et autres. Ils sont généralement
négligeables en terme de taille et cependant utiles aux utilisateurs.
En particulier <tt>project/trace</tt> aide beaucoup en cas de
problème de miroir.</p>
<p>Il est possible d'utiliser d'autres scripts spécialement écrits, mais ils
sont généralement inutiles et déconseillés pour les miroirs officiels.
Par exemple, cet ensemble d'options rsync excluerait <em>toutes</em> les
architectures :
<br />
<:
print "<code>--exclude binary-$_/ --exclude *_$_.deb --exclude *_$_.udeb --exclude installer-$_/ --exclude Contents-$_*</code><br>\n"
foreach (sort keys %arches);
:>
<toc-add-entry name="when">Quand rafraîchir les miroirs ?</toc-add-entry>
<p>L'archive principale est mise à jour quatre fois par jour.</p>
<p>En général les miroirs commencent à se mettre à jour à partir de
03:00, 09:00, 15:00 et 21:00 (UTC), mais ce ne sont pas des horaires fixes et vous ne devriez
pas régler votre opération de miroir à ces horaires.</p>
<p>Votre miroir devrait être mis à jour quelques heures après l'une des mises à
jour de l'archive principale.
Vous devriez regarder si le site à partir duquel vous
faites votre miroir laisse un fichier <q>timestamp</q> dans son
sous-répertoire <kbd>project/trace/</kbd>. Ce fichier aura le même nom
que le site, et il contiendra l'heure de la fin de la dernière mise à
jour du site. Ajoutez-y quelques heures (pour plus de sécurité) et
vous obtiendrez le moment auquel lancer votre processus miroir.</p>
<p>La meilleure façon de faire tourner le miroir automatiquement tous les
jours est d'utiliser cron. Voyez <kbd>man crontab</kbd> pour plus de détails.</p>
<p>Notez que si votre site utilise un mécanisme <q>Push</q> pour lancer
sa mise à jour, alors vous n'avez à vous soucier d'aucun de ces
problèmes.</p>
<h3>rsync avec authentification, à partir d'un miroir <q>Push</q></h3>
<p>Nous avons développé les miroirs de type <q>Push</q>, qui utilisent rsync
et visent à minimiser le temps que mettent les changements de
l'archive pour atteindre les miroirs.
Un miroir amont utilise un script déclencheur SSH pour indiquer au miroir
client qu'il doit se mettre à jour.
Le mécanisme de <q>Push</q> est généralement limité à un script déclencheur
unique sans variable, de sorte que le miroir se fait toujours par <q>Pull</q>,
comme une tâche cron.
</p>
<p>Les miroirs <q>Push</q> sont nécessaires pour garder synchrones un
ensemble de serveurs (comme les serveurs dans des alias DNS en
<i>round-robin</i>, par exemple <tt>ftp.us.debian.org</tt>), et nous
les utilisons couramment pour nos miroirs de premier et deuxième
niveau. Pour les miroirs <q>normaux</q>, cette méthode demande beaucoup
d'effort de mise en place ce qui n'est en fait pas très rentable
comparé à une tâche cron bien préparée.</p>
<p>Pour une description plus détaillée de la manière dont cette méthode
fonctionne, des raisons pour lesquelles elle est sûre et de la façon de
la mettre en place, voyez <a href="push_mirroring">les explications
complètes</a>.</p>
<toc-add-entry name="settings">Configuration supplémentaire recommandée</toc-add-entry>
<p>Si vous voulez rendre le miroir Debian disponible par HTTP, merci
de rajouter les options suivantes à votre configuration d'Apache (en
supposant bien sûr que vous utilisez Apache) dans le paragraphe
<code><Directory <var>/chemin/vers/votre/miroir/debian</var>></code>, où
<var>/chemin/vers/votre/miroir/debian/</var> doit être remplacé par le
nom du répertoire dans lequel vous gardez le miroir :</p>
<pre>
Options +Indexes +SymlinksIfOwnerMatch
IndexOptions NameWidth=* +SuppressDescription
</pre>
<p>Ceci met en place les index de répertoires et assure que les liens
symboliques fonctionnent. Les noms de fichier dans les index de
répertoires ne seront pas tronqués et les descriptions (qui le plus
souvent n'existent pas) n'apparaîtront pas.</p>
<p>Dans le cas d'Apache 1.3.x, l'option suivante peut également être ajoutée :</p>
<pre>
DirectoryIndex .
</pre>
<p>N'ajoutez pas cette option à Apache 2.x.</p>
<toc-add-entry name="submit">Comment ajouter un miroir à la liste des miroirs ?</toc-add-entry>
<p>Une fois qu'un miroir est mis en place, il doit être <a
href="submit">enregistré par Debian</a> de façon à être inclus dans la <a
href="list">liste des miroirs</a>. Les inscriptions peuvent être faites en
utilisant notre <a href="submit">simple formulaire web</a>.</p>
<p>Problèmes et questions peuvent être envoyés à <email mirrors@debian.org>.</p>
#use wml::debian::template title="Miroirs Debian officiels" BARETITLE=true
#include "$(ENGLISHDIR)/mirror/official.data"
#use wml::debian::toc
#use wml::debian::translation-check translation="1.20" maintainer="Simon Paillard"
<p>Les miroirs officiels de l'archive Debian obtiennent une adresse de
la forme ftp.<var><pays></var>.debian.org. Ce sont les sites les
mieux indiqués et les plus utilisés ; le visage de Debian
pour la plupart des gens.</p>
<toc-display />
<p>Voici la liste actuelle des miroirs officiels de l'archive :</p>
<officialarchivemirrors>
<toc-add-entry name="sponsors">Sponsors</toc-add-entry>
<p>Les sponsors de miroirs officiels sont <a
href="official_sponsors">remerciés sur nos pages web</a>.
<toc-add-entry name="process">Processus</toc-add-entry>
<p>Les miroirs officiels sont hébergés par des groupes ou des personnes
choisis, qui offrent ce service à la communauté des
utilisateurs Debian de leur pays.</p>
<p>Debian dépend des informations fournies par les utilisateurs et les
administrateurs de miroirs afin de décider de la hiérarchie des miroirs. Toute
remarque constructive à propos des miroirs officiels existants ou concernant
l'absence de miroir officiel est la bienvenue sur <email mirrors@debian.org> ou sur la
<a href="http://lists.debian.org/debian-mirrors/";>liste de diffusion
debian-mirrors</a>.</p>
<p>S'il n'y a pas déjà de ftp.<var><pays></var>.debian.org pour votre
pays, tout administrateur de miroir peut proposer son site comme miroir
officiel, à condition qu'il remplisse les critères définis ci-dessous.</p>
<p>Dans les pays où il existe déjà un miroir officiel, il est encore possible
d'ajouter d'autres miroirs officiels, mais seulement si cela s'avère
nécessaire. Dans les pays étendus comme les États-Unis, et dans les pays où
existent plusieurs dorsales majeures sans connectivité correcte (comme en Australie)
c'est même une bonne idée.</p>
<p>Généralement, le premier site se verra attribuer les alias
ftp.<country>.debian.org et ftp1.<country>.debian.org. Les sites
suivants se verront attribuer un alias du second type avec le chiffre
incrémenté.</p>
<toc-add-entry name="criteria">Critères</toc-add-entry>
<p>Pour devenir un miroir officiel, un site doit satisfaire aux critères
suivants :</p>
<ul>
<li>Le miroir doit avoir déjà été enregistré (en utilisant notre <a
href="submit">formulaire de proposition de miroir</a>).</li>
<li>Le site doit être fiable et fonctionner 24 heures sur 24. La
machine ne doit pas être fortement chargée.</li>
<li>Il doit avoir une connectivité décente (relativement au
pays dans lequel il se trouve).
Une bande passante équivalente à une connexion T1 ou mieux est
privilégiée ; notez que pour les pays développés ce minimum
est plus élevé.</li>
<li>Les routeurs en amont du serveur ne devraient poser
aucune restriction d'accès global ni aucune limitation majeure
de bande passante.</li>
<li>Le serveur doit pouvoir supporter le trafic, c'est-à-dire
avoir des limites raisonnables sur les démons HTTP, FTP et
rsync, y compris un ajustement du nombre maximum de connexions
en général et du nombre maximum de connexions à partir d'une
même adresse IP.</li>
<li>Concernant l'espace disque alloué (avec de l'espace pour
la croissance de l'archive) — consultez la <a href="size">page
sur la taille des miroirs</a>.</li>
<li>L'archive Debian complète doit être présente.</li>
<li>L'arborescence du miroir de l'archive doit être disponible
dans <kbd>/debian</kbd>.
Raison : pour l'homogénéité entre les sites — vous
pouvez simplement utiliser un lien symbolique si vous voulez
garder le miroir ailleurs, ou mettre en place un hôte virtuel.</li>
<li>Le miroir doit être disponible au moins à travers les
protocoles suivants :
<ul>
<li>HTTP (http://<var>votre.serveur</var>/debian/)
<br>
HTTP est utilisé car avec HTTP/1.1 les transferts web
peuvent potentiellement être plus efficaces qu'avec
FTP.
</li>
<li>FTP (ftp://<var>votre.serveur</var>/debian/)
<br>
Bien que FTP devienne de plus en plus obsolète,
il est encore très largement utilisé.
</li>
<li>rsync (rsync://<var>votre.serveur</var>::debian/)
<br>
Rsync est le moyen privilégié pour faire des miroirs,
et l'une des fonctions principales d'un miroir
officiel est de faciliter la prolifération de miroirs
secondaires.
</li>
</ul></li>
<li>Le miroir devrait être mis à jour avec <a href="http://ftp-master.debian.org/ftpsync.tar.gz";>ftpsync</a>
, un script remplissant <a href="$(HOME)/mirrors/ftpmirror">toutes les fonctions requises</a>.
<ul>
<li>Il utilise rsync et préserve les indicateurs temporels des
fichiers copiés, afin que la date des fichiers soit la même que sur
l'ensemble du réseau de miroirs.</li>
<li>Un fichier du nom du miroir et contenant un indicateur temporel
doit exister dans le répertoire <kbd>project/trace/</kbd>.
<br />
Cela implique d'exécuter la commande <kbd>date -u >.../debian/project/trace/<var>votre.serveur</var></kbd> une fois votre rsync quotidien terminé.
<br />
C'est trivial à mettre en place, ne gaspille que peu de
ressources, et est utile pour maintenir une trace du
miroir.</li>
<li>Les arborescences <kbd>/doc</kbd> et <kbd>/project</kbd>
doivent être incluses dans le miroir.</li>
</ul></li>
<li>Il faut mettre en place un <a href="push_mirroring">miroir
« Push »</a> ; n'hésitez pas à nous contacter
pour vous mettre en relation avec le responsable d'un autre
miroir.</li>
</ul>
<p>S'il vous plaît, notez que ce sont simplement des directives générales, mais
nous accepterons plus volontiers votre site comme miroir officiel si les
conditions ci-dessus sont satisfaites.
Il est également souhaitable que le site ait un historique de fonctionnement
similaire à celui décrit ci-dessus.</p>
<p>Toute proposition de miroir officiel doit être envoyée à <email
mirrors@debian.org> avec les précisions concernant la consommation de bande passante et
toute limite qui serait appliquée.</p>
Reply to: