[RFR] webwml://mirror/ftpmirror.wml [maj]
Bonsoir,
Voici une mise à jour de la page concernant la mise en place d'un miroir
Debian.
Merci pour vos relectures.
--
Simon Paillard
Index: ftpmirror.wml
===================================================================
RCS file: /cvs/webwml/webwml/french/mirror/ftpmirror.wml,v
retrieving revision 1.42
diff -u -r1.42 ftpmirror.wml
--- ftpmirror.wml 21 Dec 2007 23:22:50 -0000 1.42
+++ ftpmirror.wml 27 Mar 2008 23:27:10 -0000
@@ -2,7 +2,7 @@
#use wml::debian::toc
#include "$(ENGLISHDIR)/releases/sid/archive.data"
-#use wml::debian::translation-check translation="1.58" maintainer="Simon Paillard"
+#use wml::debian::translation-check translation="1.64" maintainer="Simon Paillard"
<toc-display />
@@ -114,15 +114,16 @@
<toc-add-entry name="how">Comment faire un miroir</toc-add-entry>
<p>La m�ode recommand�pour faire tourner un miroir est d'utiliser
-le script d�mm�a href="anonftpsync">anonftpsync</a> via
-<a href="http://packages.debian.org/stable/net/rsync";>rsync</a>
-anonyme.</p>
-
-<p>Note : bien que <kbd>wget</kbd> et d'autres outils FTP
-semblent fonctionner correctement, il y a des probl�s avec ceux-ci.
-Nous recommandons fortement l'utilisation de rsync.</p>
+le script d�mm�a href="anonftpsync">anonftpsync</a>.</p>
-<h3>rsync anonyme</h3>
+<p>Le protocole recommand�st <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��: ils
+ne d�ctent pas liens r�s 'hard', il est difficile d'effectuer des r�iques
+partielles de l'archive, etc.</p>
+
+<h3>Configuration de rsync</h3>
<p>Nous recommandons l'utilisation de <a href="anonftpsync">ce
script</a> pour faire un miroir de l'archive. Suivez les indications
@@ -136,6 +137,18 @@
<li>Lancez rsync avec au moins les options suivantes :
<kbd>--recursive --times --links --hard-links --delete</kbd>.</li>
+ <li>�itez de synchroniser les fichiers index (les fichiers Packages,
+ Sources, etc) avant que les nouveaux fichiers de donn� (.deb,
+ .orig.tar.gz, etc) ne soient mis en place.
+ Utilisez deux �pes de rsync — commencez par transf�r les
+ fichiers de donn� en excluant les fichiers index, puis transf�z tout
+ le reste.
+ <br/>
+ Cela peut �e effectu�n utilisant <kbd>--exclude</kbd> afin d'�ter
+ les fichiers Packages*, Sources* et Release*, ou en synchronisant
+ uniquement le r�rtoire pool/ lors de la premi� �pe.
+ R�rez-vous �a href="anonftpsync">notre fichier</a> comme exemple.</li>
+
<li>M� si vous avez de la place disque suppl�ntaire, utilisez
l'option <kbd>--delete-after</kbd> pour �ter des probl�s de mise
�our temporaire.</li>
@@ -143,15 +156,10 @@
<li>Si vous n'avez pas assez d'espace disque pour faire un miroir de
toute l'archive, utilisez l'option <kbd>--exclude</kbd> pour exclure
certaines parties de l'archive. En g�ral on enl� certaines
- architectures qu'on ne veut pas ; par exemple, ce qui suit
- supprimerait <em>toutes</em> les architectures :
- <br />
-<:
-print "<code>--exclude binary-$_/ --exclude *_$_.deb</code><br>\n"
- foreach (sort keys %arches);
-:>
- Voyez aussi la <a href="#partial">section concernant les miroirs
- partiels</a>.</li>
+ architectures qu'on ne veut pas, parce qu'elles occupent beaucoup d'espace
+ disque.
+ Veuillez consulter la <a href="#partial">section sur les miroirs
+ partiels</a>.</li>
<li>Une fois que rsync a fini de mettre �our le miroir, ajoutez
un fichier � timestamp � au sous-r�rtoire
@@ -166,36 +174,14 @@
En particulier <tt>project/trace</tt> aide beaucoup en cas de
probl� de miroir.</li>
-</ul>
+ <li>G�ralement les miroirs rsync amont autorisent les acc�anonymes. Dans
+ le cas o� identification serait requise, configurez le nom d'utilisateur
+ et le mot de passe dans votre script, soit en utilisant la variable
+ d'environnement RSYNC_PASSWORD, soit en utilisant l'option
+ <kbd>--password-file</kbd>.
+ </li>
-<h3>rsync avec authentification, �artir d'un miroir <q>Push</q></h3>
-
-<p>Les miroirs <q>Push</q>� sont une forme de miroir, utilisant rsync, que nous
-avons d�lopp�afin de minimiser le temps que mettent les changements de
-l'archive pour atteindre les miroirs. Les miroirs <q>Push</q> utilisent un
-script d�encheur ssh pour indiquer au miroir client qu'il doit se mettre
-�our.</p>
-
-<p>Les miroirs <q>Push</q> sont n�ssaires 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�
-niveau. Pour les miroirs <q>normaux</q>, cette m�ode demande beaucoup
-d'effort de mise en place ce qui n'est en fait pas tr�rentable
-compar� une t�e cron bien pr�r�</p>
-
-<p>La m�ode est assez s�ar ssh est configur�our lancer une unique
-commande. Ainsi le miroir se fait toujours par <q>Pull</q>, il n'est donc
-<strong>pas</strong> possible de corrompre le contenu de l'archive
-<i>via</i> un miroir push infiltr�-Quelques administrateurs de miroirs ont montr�ne certaine h�tation �-utiliser cette m�ode de miroirs par crainte qu'elle n'ouvre leur machine �-une invasion. Ce n'est absolument <strong>pas</strong> le cas.</p>
-
-<p>Pour une description plus d�ill�de la mani� dont cette m�ode
-fonctionne, des raisons pour lesquelles elle est s�t de la fa� de
-la mettre en place, voyez <a href="push_mirroring">les explications
-compl�s</a>.</p>
+</ul>
<toc-add-entry name="partial">Miroir partiel</toc-add-entry>
@@ -205,9 +191,7 @@
exclure une partie, vous devriez exclure les architectures.</p>
<p>Avec <a href="anonftpsync">anonftpsync</a>, cela peut se faire en
-modifiant la variable ARCH_EXCLUDE.
-Il existe aussi d'autres scripts �its sp�alement.
-Cependant, ils ne sont pas adapt�aux miroirs officiels.</p>
+modifiant la variable ARCH_EXCLUDE.</p>
<p>Nous d�nseillons vivement d'exclure les sous-r�rtoires
<tt>project/</tt>, <tt>doc/</tt> et autres. Ils sont g�ralement
@@ -215,6 +199,16 @@
En particulier <tt>project/trace</tt> aide beaucoup en cas de
probl� de miroir.</p>
+<p>Il est possible d'utiliser d'autres scripts sp�alement �its, mais ils ne sont g�ralement pas utils, et d�nsill�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�ir les miroirs ?</toc-add-entry>
<p>L'archive principale est mise �our deux fois par jour.</p>
@@ -243,6 +237,33 @@
sa mise �our, alors vous n'avez �ous soucier d'aucun de ces
probl�s.</p>
+
+<h3>rsync avec authentification, �artir d'un miroir <q>Push</q></h3>
+
+<p>Les miroirs <q>Push</q> sont une forme de miroir, utilisant rsync, que nous
+avons d�lopp�afin de minimiser le temps que mettent les changements de
+l'archive pour atteindre les miroirs.
+Un miroir amont utilise un script d�encheur SSH pour indiquer au miroir
+client qu'il doit se mettre �our.
+Le m�nisme de <q>Push</q> est g�ralement limit� un script d�encheur
+unique sans variable, de sorte que le miroir se fait toujours par <q>Pull</q>,
+comme une t�e cron.
+</p>
+
+<p>Les miroirs <q>Push</q> sont n�ssaires 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�
+niveau. Pour les miroirs <q>normaux</q>, cette m�ode demande beaucoup
+d'effort de mise en place ce qui n'est en fait pas tr�rentable
+compar� une t�e cron bien pr�r�</p>
+
+<p>Pour une description plus d�ill�de la mani� dont cette m�ode
+fonctionne, des raisons pour lesquelles elle est s�t de la fa� de
+la mettre en place, voyez <a href="push_mirroring">les explications
+compl�s</a>.</p>
+
+
<toc-add-entry name="settings">Configuration suppl�ntaire recommand�/toc-add-entry>
<p>Si vous voulez rendre le miroir Debian disponible par HTTP, merci
#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.64" maintainer="Simon Paillard"
<toc-display />
<toc-add-entry name="whether">Dans quel cas faire un miroir�?</toc-add-entry>
<p>M� si nous appr�ons tout nouveau miroir, chaque potentiel responsable de
miroir doit s'assurer qu'il peut r�ndre �es questions avant de commencer �ettre en place son propre miroir�:</p>
<ul>
<li>Un miroir est-il n�ssaire dans ma r�on�? Il existe peut-�e d�
d'autres miroirs �roximit�/li>
<li>Ai-je les ressources n�ssaires pour h�rger un miroir�? Les miroirs
occupent une quantit�mportante d'espace disque et de bande passante, dont
il faut s'engager �upporter le co�li>
<li>Un miroir est-il le bon choix�? Parfois, certaines personnes d�rrent
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�au, pour construire des CD (avec jigdo), ou pour mettre �our des syst�s d� install�</li>
<li>
debian-cd/ est une archive qui n'est pas identique sur tous les diff�nts
serveurs miroirs. Sur certains sites, elle contient des mod�s pour jigdo
(utilis�avec les fichiers dans debian/) �artir desquels il est possible de
construire des images de CD, sur certains des images de CD d� construites, et
sur d'autres les deux.
<br />
De plus amples informations sont disponibles sur la page d���a <a
href="$(HOME)/CD/mirroring/">cr�ion d'un miroir pour les images de CD de
Debian</a></li>
<li>
debian-archive/ contient la vraie <em>archive</em>, les anciennes versions
obsol�s de Debian. Elle n'est en g�ral int�ssante 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�ses sur les tailles des miroirs.</p>
<p>L'archive debian-security/ contient les mises �our de s�rit�dit� par
l'�ipe de s�rit�e Debian. Elle semble int�ssante pour tout le monde,
mais comme les mises �our de s�rit�ont sporadiques, il faudrait
synchroniser le miroir tr�souvent pour �e �our (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�e security.debian.org.</p>
<p>N.B. : l'archive debian-non-US est obsol� depuis la sortie
de Debian 3.1 (<em>Sarge</em>) en juin 2006.</p>
<toc-add-entry name="wherefrom">�partir d'o�re 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 �our �artir d'un serveur Debian interne. Cette adresse pointe actuellement vers un
unique serveur h�rg�ux �ats-Unis, et existe encore principalement pour des
raisons de compatibilit�scendante.</p>
<p>Les <a href="official">miroirs officiels</a> sont cens��e de bonnes
sources. Tout serveur parmi ceux qui se trouvent dans la <a
href="list-full">liste compl� 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��au.</p>
<p>Il n'y a pas de diff�nces significatives entre diff�nts 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�aux �ats-Unis devraient mettre �our
leur miroir depuis ftp.us.debian.org (le miroir officiel pour les �ats-Unis,
qui est un miroir <q>Push-Primary</q>). Or comme cette adresse est un alias
pour plusieurs serveurs, il est recommand�e d�rminer lequel vous convient
le mieux et de mettre �our le miroir depuis l'un d'entre eux.
<br />
<small>Cela a pour avantage d'�ter les ennuis lors du rsync en deux �pes
(puisque les diff�ntes �pes risquent d'�e effectu� sur des serveurs
diff�nts, et tomber �es instants o� donn� sont diff�ntes,
provoquant une probl� de concurrence).</small></p>
<toc-add-entry name="how">Comment faire un miroir</toc-add-entry>
<p>La m�ode recommand�pour faire tourner un miroir est d'utiliser
le script d�mm�a href="anonftpsync">anonftpsync</a>.</p>
<p>Le protocole recommand�st <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��: ils
ne d�ctent pas liens r�s 'hard', il est difficile d'effectuer des r�iques
partielles de l'archive, etc.</p>
<h3>Configuration de rsync</h3>
<p>Nous recommandons l'utilisation de <a href="anonftpsync">ce
script</a> pour faire un miroir de l'archive. Suivez les indications
se trouvant dans le script pour mettre en place le miroir.</p>
<p>Voici des conseils pour ceux qui pr�rent d'autres fa�s de faire
un miroir.</p>
<ul>
<li>Lancez rsync avec au moins les options suivantes :
<kbd>--recursive --times --links --hard-links --delete</kbd>.</li>
<li>�itez de synchroniser les fichiers index (les fichiers Packages,
Sources, etc) avant que les nouveaux fichiers de donn� (.deb,
.orig.tar.gz, etc) ne soient mis en place.
Utilisez deux �pes de rsync — commencez par transf�r les
fichiers de donn� en excluant les fichiers index, puis transf�z tout
le reste.
<br/>
Cela peut �e effectu�n utilisant <kbd>--exclude</kbd> afin d'�ter
les fichiers Packages*, Sources* et Release*, ou en synchronisant
uniquement le r�rtoire pool/ lors de la premi� �pe.
R�rez-vous �a href="anonftpsync">notre fichier</a> comme exemple.</li>
<li>M� si vous avez de la place disque suppl�ntaire, utilisez
l'option <kbd>--delete-after</kbd> pour �ter des probl�s de mise
�our temporaire.</li>
<li>Si vous n'avez pas assez d'espace disque pour faire un miroir de
toute l'archive, utilisez l'option <kbd>--exclude</kbd> pour exclure
certaines parties de l'archive. En g�ral on enl� certaines
architectures qu'on ne veut pas, parce qu'elles occupent beaucoup d'espace
disque.
Veuillez consulter la <a href="#partial">section sur les miroirs
partiels</a>.</li>
<li>Une fois que rsync a fini de mettre �our le miroir, ajoutez
un fichier � timestamp � au sous-r�rtoire
<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�nseillons vivement d'exclure les sous-r�rtoires
<tt>project/</tt>, <tt>doc/</tt> et autres. Ils sont g�ralement
n�igeables en terme de taille et cependant utiles aux utilisateurs.
En particulier <tt>project/trace</tt> aide beaucoup en cas de
probl� de miroir.</li>
<li>G�ralement les miroirs rsync amont autorisent les acc�anonymes. Dans
le cas o� identification serait requise, configurez le nom d'utilisateur
et le mot de passe dans votre script, soit en utilisant la variable
d'environnement RSYNC_PASSWORD, soit en utilisant l'option
<kbd>--password-file</kbd>.
</li>
</ul>
<toc-add-entry name="partial">Miroir partiel</toc-add-entry>
<p>Consid�nt la <a href="size">taille d� importante de l'archive
Debian</a>, certaines personnes pr�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 <a href="anonftpsync">anonftpsync</a>, cela peut se faire en
modifiant la variable ARCH_EXCLUDE.</p>
<p>Nous d�nseillons vivement d'exclure les sous-r�rtoires
<tt>project/</tt>, <tt>doc/</tt> et autres. Ils sont g�ralement
n�igeables en terme de taille et cependant utiles aux utilisateurs.
En particulier <tt>project/trace</tt> aide beaucoup en cas de
probl� de miroir.</p>
<p>Il est possible d'utiliser d'autres scripts sp�alement �its, mais ils ne sont g�ralement pas utils, et d�nsill�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�ir les miroirs ?</toc-add-entry>
<p>L'archive principale est mise �our deux fois par jour.</p>
<p>En g�ral les miroirs commencent �e mettre �our �artir de
09:00 et 21:00 (UTC), mais ce ne sont pas des horaires fixes et vous ne devriez
pas r�er votre op�tion de miroir �es horaires.</p>
<p>Nous recommandons de mettre �our votre miroir une fois chaque jour. Mettre
�our plus souvent que deux fois par jour est inutile et conduira sans doute
votre serveur �tre banni — ne faites jamais cela.</p>
<p>Votre miroir devrait �e mis �our quelques heures apr�l'une des mises �our de l'archive principale.
Vous devriez regarder si le site �artir duquel vous
faites votre miroir laisse un fichier <q>time stamp</q> dans son
sous-r�rtoire <kbd>project/trace/</kbd>. Ce fichier aura le m� nom
que le site, et il contiendra l'heure de la fin de la derni� mise �our du site. Ajoutez-y quelques heures (pour plus de s�rit�et
vous obtiendrez le moment auquel lancer votre processus miroir.</p>
<p>La meilleure fa� de faire tourner le miroir automatiquement tous les
jours est d'utiliser cron. Voyez <kbd>man crontab</kbd> pour plus de d�ils.</p>
<p>Notez que si votre site utilise un m�nisme <q>Push</q> pour lancer
sa mise �our, alors vous n'avez �ous soucier d'aucun de ces
probl�s.</p>
<h3>rsync avec authentification, �artir d'un miroir <q>Push</q></h3>
<p>Les miroirs <q>Push</q> sont une forme de miroir, utilisant rsync, que nous
avons d�lopp�afin de minimiser le temps que mettent les changements de
l'archive pour atteindre les miroirs.
Un miroir amont utilise un script d�encheur SSH pour indiquer au miroir
client qu'il doit se mettre �our.
Le m�nisme de <q>Push</q> est g�ralement limit� un script d�encheur
unique sans variable, de sorte que le miroir se fait toujours par <q>Pull</q>,
comme une t�e cron.
</p>
<p>Les miroirs <q>Push</q> sont n�ssaires 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�
niveau. Pour les miroirs <q>normaux</q>, cette m�ode demande beaucoup
d'effort de mise en place ce qui n'est en fait pas tr�rentable
compar� une t�e cron bien pr�r�</p>
<p>Pour une description plus d�ill�de la mani� dont cette m�ode
fonctionne, des raisons pour lesquelles elle est s�t de la fa� de
la mettre en place, voyez <a href="push_mirroring">les explications
compl�s</a>.</p>
<toc-add-entry name="settings">Configuration suppl�ntaire recommand�/toc-add-entry>
<p>Si vous voulez rendre le miroir Debian disponible par HTTP, merci
de rajouter les options suivantes �otre configuration d'Apache (en
supposant bien s�e vous utilisez Apache) dans le paragraphe
<code><Directory <var>/chemin/vers/votre/miroir/debian</var>></code>, o�r>/chemin/vers/votre/miroir/debian/</var> doit �e remplac�ar le
nom du r�rtoire dans lequel vous gardez le miroir :</p>
<pre>
Options +Indexes +SymlinksIfOwnerMatch
IndexOptions NameWidth=* +SuppressDescription
</pre>
<p>Ceci met en place les index de r�rtoires et assure que les liens
symboliques fonctionnent. Les noms de fichier dans les index de
r�rtoires ne seront pas tronqu�et les descriptions (qui le plus
souvent n'existent pas) n'appara�ont pas.</p>
<p>Dans le cas d'Apache 1.3.x, l'option suivante peut �lement �e ajout�nbsp;:</p>
<pre>
DirectoryIndex .
</pre>
<p>N'ajoutez pas cette option �pache 2.x.</p>
<toc-add-entry name="submit">Comment ajouter un miroir �a liste des miroirs ?</toc-add-entry>
<p>Une fois qu'un miroir est mis en place, il doit �e <a
href="submit">enregistr�ar Debian</a> de fa� �tre inclus dans la <a
href="list">liste des miroirs</a>. Les inscriptions peuvent �e faites en
utilisant notre <a href="submit">simple formulaire web</a>.</p>
<p>Probl�s et questions peuvent �e envoy��email mirrors@debian.org>.</p>
Reply to: