APT-TRANSPORT-MIRR(1) APT APT-TRANSPORT-MIRR(1) NOM apt-transport-mirror - Transport d'APT pour une selection plus automatique du miroir DESCRIPTION Ce transport d'APT ne met pas en oeuvre un protocole pour acceder tout seul a des depots locaux ou distants, mais obtenir une liste de miroirs et redirige toutes les requetes vers le(s) miroir(s) choisi(s) dans cette liste, en y accedant grace a d'autres transports tels que apt- transport-http(1). La fonctionnalite de base est disponible depuis apt 0.7.24, mais n'a ete documentee qu'a partir d'apt 1.6 qui fournit une version totalement retravaillee du transport et des fonctionnalites prises en charge. Veuillez noter qu'un transport n'est jamais appele directement par l'utilisateur, mais utilise par les outils d'APT s'appuyant sur la configuration de l'utilisateur. Si la recuperation d'un fichier a partir d'un miroir echoue, la methode assure qu'un autre miroir possible de la liste est automatiquement essaye jusqu'a ce que le fichier soit recupere ou qu'il ne reste plus de miroir sur la liste, gerant de facon transparente les indisponibilites de serveur ou d'autres problemes similaires. Les implications de securite du transport dependent des considerations de securite, associees au transport, qui ont preside a l'acquisition de la liste de miroirs et des transports impliques dans l'accession au(x) miroir(s) choisi(s) par le transport. OPTIONS Ce transport ne possede pas d'option de configuration pour le moment. La selection du miroir est basee uniquement sur les miroirs offerts dans la liste de miroirs et des fichiers qu'APT doit se procurer. Format de la liste de miroirs Une liste de miroirs contient une ou plusieurs lignes qui specifient chacune l'URI d'un miroir. Les lignes vides et celles commencant par un caractere diese (#) sont ignorees. Un URI debute toujours par un scheme d'URI qui definit le transport utilise pour ce miroir. Si, par exemple, l'URI debute par http:, le transport responsable est apt-transport- http(1) qui pourrait avoir des exigences particulieres pour le format du reste de l'URI. Les metadonnees d'un miroir peuvent etre placees sur la meme ligne, separees de l'URI par une tabulation. De multiples elements de metadonnees peuvent etre eux-memes separes par des tabulations ou des espaces. (C'est une fonctionnalite avancee seulement disponible avec apt >= 1.6. Les versions d'APT anterieures echoueront a analyser les listes de miroirs utilisant cette fonctionnalite.) Depuis apt 1.6, l'utilisation de listes de miroirs compressees est aussi geree. Veuillez noter que le nom de fichier de la liste de miroirs doit specifier l'algorithme de compression utilise ; il n'y a pas d'auto-detection basee sur le contenu du fichier. Selection du miroir par les metadonnees Comme cela est specifie dans le format, un miroir peut avoir des metadonnees supplementaires attachees pour eviter qu'il soit selectionne pour la recuperation d'un fichier qui ne correspond pas a ces metadonnees. De cette facon, la liste de miroirs peut contenir par exemple des miroirs partiels fournissant seulement certaines architectures et APT choisira automatiquement un autre miroir pour les fichiers requerant une architecture non listee. Sont prises en charge les limites liees a l'architecture (arch), au nom de code de la version (codename), aux composants du depot ou se trouve le fichier (component), a la langue a laquelle le fichier s'applique (lang), au nom de la suite de la version suite) et au type du fichier (type). Ordre de repli pour les miroirs Si aucune priorite n'est donnee a un miroir par la clef de metadonnee priority, l'ordre de contact des miroirs est aleatoire. Si un ensemble particulier de miroirs doit etre essaye avant que n'importe lequel des autres ensembles ne le soit, une priorite peut etre specifiee explicitement. Les miroirs avec les numeros les plus bas sont essayes en premier. Les miroirs qui n'ont pas de priorite explicite portent par defaut le numero le plus eleve possible, et donc, sont essayes en dernier. Le choix entre les miroirs de meme priorite est aussi aleatoire. Files are by default spread over multiple mirrors of the set with the lowest priority number: At least three mirrors are used if the set contains enough mirrors, beyond that their number scales with the square root of the number of files fetched (e.g. 4 mirrors for 16 files, 10 mirrors for 100 files) and each file is assigned to the currently least used of these mirrors. This fan-out can be controlled via the apt.conf(5) options Acquire::Mirror::Fanout (sqrt (the default) or none to pick a random mirror for each file independently) and Acquire::Mirror::Fanout-Limit (an upper bound on the number of actively used mirrors, 0 for no limit). Mirrors of another set are only tried on failure as described above. Transports permis dans une liste de miroir La disponibilite et le choix des transports dans une liste de miroirs sont limites par la maniere dont le client APT accede a la liste des miroirs. Si un transport local comme file ou copy est utilise, la liste de miroirs peut aussi inclure des sources locales, alors qu'une liste de miroirs atteinte par http ne le peut pas. Par ailleurs, une liste de miroirs ne peut pas contenir une liste de miroirs ou d'autres transports enveloppants (comme apt-transport-tor). Voir la documentation sur ces transports pour connaitre la maniere de les utiliser avec la methode miroir. Veuillez noter que les versions d'APT anterieures a 1.6 ne prennent pas en charge d'autres transports que http. EXEMPLES Exemple basique Voici un exemple basique de liste de miroirs prise en charge par toutes les versions d'APT avec une methode de miroir (>= 0.7.24) dans lequel le client choisira n'importe lequel des trois miroirs : http://ftp.de.debian.org/debian/ http://ftp.us.debian.org/debian/ http://deb.debian.org/debian/ Si un fichier avec ce contenu est stocke sur la machine sous le nom de /etc/apt/mirrorlist.txt, il peut etre utilise comme cela dans sources.list(5) (a partir d'apt 1.6) : deb mirror+file:/etc/apt/mirrorlist.txt trixie main Toutes les versions de la methode miroir prennent en charge une liste de miroirs accessibles par HTTP, aussi, dans la mesure ou elle est disponible a l'adresse http://apt.example.org/mirror.lst, l'entree de sources.list ci-dessus peut etre ecrite plutot ainsi : deb mirror://apt.example.org/mirror.lst trixie main Veuillez noter que depuis apt 1.6, l'utilisation de mirror+http est preferable a mirror pour uniformiser. La fonctionnalite est la meme. Exemple de selection du miroir avec des metadonnees ameliorees Comme cela est explique dans la definition de format, les versions d'APT anterieures a 1.6 ne prennent pas cela en charge et echoueront a analyser la liste de miroirs. L'exemple de liste de miroirs est complexe intentionnellement pour montrer certains aspects de la selection. La configuration suivante est supposee : le premier miroir est un miroir local accessible par la methode << file >>, mais possiblement incomplet ; le second miroir possede une excellente connexion, c'est un miroir partiel dans la mesure ou il ne contient que des fichiers lies aux architectures amd64 et all. Les miroirs restants sont des miroirs ordinaires qui devraient etre contactes seulement si les precedents ne fonctionnent pas. file:/srv/local/debian/mirror/ priority:1 type:index http://partial.example.org/mirror/ priority:2 arch:amd64 arch:all type:deb http://ftp.us.debian.org/debian/ type:deb http://ftp.de.debian.org/debian/ type:deb https://deb.debian.org/debian/ Dans une configuration avec cette liste de miroirs, le premier miroir sera utilise pour telecharger tous les fichiers d'index en supposant que la liste de miroirs elle-meme est atteinte par un transport local comme file. Si ce n'est pas le cas, si le miroir est inaccessible ou s'il ne contient pas le fichier requis, un autre miroir sera utilise pour recuperer le fichier, choisi selon le type du fichier : un fichier d'index sera servi par le dernier miroir de la liste, tandis qu'un paquet de l'architecture amd64 est servi par le second et ceux, par exemple, de l'architecture i386 par un des trois derniers. BOGUES Page des bogues d'APT[1]. Si vous souhaitez signaler un bogue a propos d'APT, veuillez lire /usr/share/doc/debian/bug-reporting.txt ou utiliser la commande reportbug(1). TRADUCTEURS Jerome Marant, Philippe Batailler, Christian Perrier (2000, 2005, 2009, 2010), bubu et Jean-Pierre Giraud (2004, 2017-2024) et l'equipe de traduction francophone de Debian Veuillez noter que cette traduction peut contenir des parties non traduites. Cela est volontaire, pour eviter de perdre du contenu quand la traduction est legerement en retard sur le contenu d'origine. AUTEUR Equipe de developpement d'APT NOTES 1. Page des bogues d'APT https://bugs.debian.org/src:apt APT 3.3.3 20 juillet 2026 APT-TRANSPORT-MIRR(1)