[RFR] wml://mirror/ftpmirror.wml
Bonjour,
Voici une mise à jour de cette page du site (révision complète).
Les fichiers sont ici :
https://salsa.debian.org/webmaster-team/webwml/-/raw/master/english/mirror/ftpmirror.wml
https://salsa.debian.org/webmaster-team/webwml/-/raw/master/french/mirror/ftpmirror.wml
Merci d’avance pour vos relectures et commentaires.
Amicalement.
--
Jean-Paul
--- ftpmirror.wml.orig 2023-02-25 10:36:48.974169483 +0100
+++ ftpmirror.wml 2023-02-25 11:39:25.115557539 +0100
@@ -3,7 +3,7 @@
#include "$(ENGLISHDIR)/releases/sid/archive.data"
#include "$(ENGLISHDIR)/releases/arches.data"
-#use wml::debian::translation-check translation="e466bedb14f9f661d1f4a77514cbe26596877486" maintainer="Jean-Paul Guillonneau"
+#use wml::debian::translation-check translation="37505fd3e8d15e728afdde60b6ad9cc4362d075c" maintainer="Jean-Paul Guillonneau"
#traducteurs : voir journal
<toc-display />
@@ -16,7 +16,7 @@
<ul>
<li>Un miroir est-il nécessaire dans ma région ? Il existe peut-être
- déjà d'autres miroirs à proximité.</li>
+ 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'<a href="size">espace disque</a> et de bande passante, dont
@@ -83,23 +83,24 @@
<p>Vous devez éviter de faire un miroir à partir de n’importe quel nom de service
conduisant à plus d’une adresse (tel que <code>ftp.us.debian.org</code>) car
-cela pourrait mener à une synchronisation entre différents états de copies de
-miroirs amont qui pourraient être non synchronisés.
+cela pourrait mener à une synchronisation à partir de copies différentes
+si les miroirs amont ne sont pas non synchronisés.
#
Remarquez aussi que HTTP est le seul service dont la présence est garantie sur
<code>ftp.CC.debian.org</code>. Si vous voulez créer votre miroir en utilisant
rsync (l’utilisation de ftpsync est recommandée), nous vous suggérons de choisir
le nom approprié du site de la machine fournissant <code>ftp.CC.debian.org</code>.
(Consulter le répertoire <code>/debian/project/trace</code> de ce serveur
-pour le connaître).</p>
+pour le connaître.)</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>
+le script ftpsync, disponible des façons suivantes :</p>
<ul>
- <li>sous la forme d'une archive à l'adresse <url "https://ftp-master.debian.org/ftpsync.tar.gz";></li>
- <li>en utilisant le dépôt git : <kbd>git clone https://salsa.debian.org/mirror-team/archvsync.git</kbd> (voir <url "https://salsa.debian.org/mirror-team/archvsync/";>)</li>
+ <li>sous la forme d'une archive à l'adresse <url "https://ftp-master.debian.org/ftpsync.tar.gz";> ;</li>
+ <li>en utilisant le dépôt git : <kbd>git clone https://salsa.debian.org/mirror-team/archvsync.git</kbd> (voir <url "https://salsa.debian.org/mirror-team/archvsync/";>) ;</li>
+<li>sous la forme d’un paquet de Debian : <a href="https://packages.debian.org/stable/ftpsync";>ftpsync</a>.</li>
</ul>
<p>N’utilisez pas vos propres scripts, et n’utilisez pas des exécutions uniques
@@ -121,28 +122,19 @@
proposées. Le fichier de configuration de ftpsync possède les réglages
ARCH_EXCLUDE et ARCH_INCLUDE pour cela.</p>
-
-<p>Avec le script recommandé <a href="https://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 quant à leur taille et cependant utiles aux utilisateurs.
-En particulier <tt>project/trace</tt> aide beaucoup en cas de
-problème de miroir.</p>
-
<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>
+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 en fonction de 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
+faites votre miroir fournit 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
@@ -169,10 +161,10 @@
<p>La copie de miroir de type <q>Push</q> est une manière que nous avons
développée pour 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.
+indiquer au miroir client qu'il doit de lui-même se mettre à jour.
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
+la mettre en place, veuillez consulter <a href="push_mirroring">les explications
complètes</a>.</p>
@@ -182,14 +174,7 @@
à <code>/debian</code>.</p>
<p>De plus, assurez-vous que les listes de répertoires soient disponibles (avec
-leurs noms de fichier complets et le suivi des liens symboliques).<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>
+leurs noms de fichier complets) ainsi que le suivi des liens symboliques.<p>
Si vous utilisez Apache, quelque chose comme ceci devrait fonctionner :
<pre>
#use wml::debian::template title="Mettre en place un miroir de l'archive Debian"
#use wml::debian::toc
#include "$(ENGLISHDIR)/releases/sid/archive.data"
#include "$(ENGLISHDIR)/releases/arches.data"
#use wml::debian::translation-check translation="37505fd3e8d15e728afdde60b6ad9cc4362d075c" maintainer="Jean-Paul Guillonneau"
#traducteurs : voir journal
<toc-display />
<toc-add-entry name="whether">Dans quel cas faire un miroir ?</toc-add-entry>
<p>Même si nous apprécions les nouveaux miroirs, 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'<a href="size">espace disque</a> et de bande passante, dont
il faut s'engager à supporter le coût.</li>
<li>Un miroir est-il le bon choix ? Si principalement vous voulez aider les
utilisateurs par vos possibilités de FAI, alors peut-être qu’un serveur cache
mandataire (<q>proxy cache</q>) tel apt-cacher-ng, squid ou varnish serait un
meilleur choix.</li>
</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. <em>Nous préconisons de faire un miroir de ce
dépôt.</em></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. (Sans bonne raison, vous ne devriez pas en créer un
miroir.)</li>
</ul>
<p>Veuillez consulter 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. Bien qu’elle semble intéressante pour tout le
monde, nous ne recommandons pas l’utilisation de miroirs pour obtenir les mises
à jour de sécurité, et demandons à la place de les télécharger directement depuis
notre service distribué, security.debian.org. <em>Nous préconisons de ne
<strong>pas</strong> faire un miroir de debian-security</em>.</p>
<toc-add-entry name="wherefrom">À partir d'où faire un miroir ?</toc-add-entry>
<p>Notez que <code>ftp.debian.org</code> n’est pas un emplacement canonique des
paquets Debian, c’est plutôt simplement l’emplacement d’un serveur parmi d’autres
mis à jour à partir d’un serveur interne de Debian.
Il existe de nombreux <a href="list-full">miroirs publics</a> qui prennent en
charge rsync et qui forment de bons miroirs. Merci d'utiliser un miroir
qui soit proche de vous, au sens de la proximité réseau.</p>
<p>Vous devez éviter de faire un miroir à partir de n’importe quel nom de service
conduisant à plus d’une adresse (tel que <code>ftp.us.debian.org</code>) car
cela pourrait mener à une synchronisation à partir de copies différentes
si les miroirs amont ne sont pas non synchronisés.
#
Remarquez aussi que HTTP est le seul service dont la présence est garantie sur
<code>ftp.CC.debian.org</code>. Si vous voulez créer votre miroir en utilisant
rsync (l’utilisation de ftpsync est recommandée), nous vous suggérons de choisir
le nom approprié du site de la machine fournissant <code>ftp.CC.debian.org</code>.
(Consulter le répertoire <code>/debian/project/trace</code> de ce serveur
pour le connaître.)</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 des façons suivantes :</p>
<ul>
<li>sous la forme d'une archive à l'adresse <url "https://ftp-master.debian.org/ftpsync.tar.gz";> ;</li>
<li>en utilisant le dépôt git : <kbd>git clone https://salsa.debian.org/mirror-team/archvsync.git</kbd> (voir <url "https://salsa.debian.org/mirror-team/archvsync/";>) ;</li>
<li>sous la forme d’un paquet de Debian : <a href="https://packages.debian.org/stable/ftpsync";>ftpsync</a>.</li>
</ul>
<p>N’utilisez pas vos propres scripts, et n’utilisez pas des exécutions uniques
de rsync. L’utilisation de ftpsync garantit que les mises à jour seront faites
d’une manière qu’apt ne soit pas désorienté. En particulier, ftpsync traite les
traductions, les contenus et autres métadonnées de telle façon qu’apt ne sera pas
amené à des erreurs de validation si un utilisateur met à jour la liste des
paquets tandis que le miroir met sa copie à jour. De plus, cela produit des
fichiers de trace contenant plus d’informations que nécessaires pour connaître si
un miroir est en fonction, quelles architectures il fournit et à partir de quoi
il se synchronise.</p>
<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>, il serait peut-être préférable de ne faire un miroir que de quelques
parties de l’archive. Les miroirs publics devrait fournir toutes les publications
(testing, unstable, etc.), mais ils peuvent restreindre le nombre d’architectures
proposées. Le fichier de configuration de ftpsync possède les réglages
ARCH_EXCLUDE et ARCH_INCLUDE pour cela.</p>
<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 en fonction de 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 fournit 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><b>Il est essentiel que votre miroir soit synchronisé avec l’archive
principale</b>. Un minimum de 4 mises à jour par 24 heures garantit que votre
miroir est une copie conforme de l’archive. Vous comprendrez que les miroirs
non synchronisés ne soient pas dans la liste des miroirs officiels.</p>
<p>La meilleure façon de faire tourner le miroir automatiquement tous les
jours est d'utiliser cron.
Consultez <kbd>man crontab</kbd> pour de plus amples précisions.
</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>Copie de miroir déclenchée par <q>Push</q></h3>
<p>La copie de miroir de type <q>Push</q> est une manière que nous avons
développée pour 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 de lui-même se mettre à jour.
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, veuillez consulter <a href="push_mirroring">les explications
complètes</a>.</p>
<toc-add-entry name="settings">Configuration supplémentaire recommandée</toc-add-entry>
<p>Les miroirs publics devraient rendre l’archive Debian accessible par HTTP
à <code>/debian</code>.</p>
<p>De plus, assurez-vous que les listes de répertoires soient disponibles (avec
leurs noms de fichier complets) ainsi que le suivi des liens symboliques.<p>
Si vous utilisez Apache, quelque chose comme ceci devrait fonctionner :
<pre>
<Directory <var>/chemin/vers/votre/miroir/debian</var>>
Options +Indexes +SymlinksIfOwnerMatch
IndexOptions NameWidth=* +SuppressDescription
</Directory>
</pre>
<toc-add-entry name="submit">Comment ajouter un miroir à la liste des miroirs ?</toc-add-entry>
<p>
Si vous désirez que votre miroir soit inscrit dans la liste officielle,
veuillez :
</p>
<ul>
<li>vérifier que votre miroir se synchronise quatre fois par 24 heures avec
l’archive ;</li>
<li>vérifier que votre miroir inclut les fichiers source pour les
architectures fournies.</li>
</ul>
<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 officielle 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>
<toc-add-entry name="mailinglists">Listes de diffusion</toc-add-entry>
<p>Il existe deux <a href="../MailingLists/">listes de diffusion</a> publiques
à propos des miroirs de Debian,
<a href="https://lists.debian.org/debian-mirrors-announce/";>debian-mirrors-announce</a>
et
<a href="https://lists.debian.org/debian-mirrors/";>debian-mirrors</a>.
Nous encourageons tous les responsables de miroir à s’inscrire à la liste des
annonces car elle est utilisée pour toute annonce importante. Cette liste est
filtrée et ne reçoit qu’un faible trafic. La deuxième liste est destinée aux
discussions générales et est ouverte à tous.</p>
<p>Si vous avez une question sans réponse dans ces pages web, vous pouvez nous
contacter à <email mirrors@debian.org> ou en utilisant IRC, #debian-mirrors sur
<tt>irc.debian.org</tt>.</p>
<toc-add-entry name="private-mirror">Remarques pour les miroirs privés (partiels)</toc-add-entry>
<p>
Si vous voulez mettre en œuvre un miroir pour votre propre site seulement, et que
vous n’avez besoin qu’une partie des publications (comme stable),
<a href="https://packages.debian.org/stable/debmirror";>debmirror</a> pourrait
vous convenir parfaitement.
</p>
Reply to: