Ubuntu Manpage: apt-transport-mirror - Transportmethode van APT voor een meer geautomatiseerde siegelserverselectie

NAME

       apt-transport-mirror - Transportmethode van APT voor een meer geautomatiseerde siegelserverselectie

OMSCHRIJVING

       Deze transportmethode van APT past zelf geen protocol toe om lokale of externe pakketbronnen te
       benaderen, maar haalt een spiegelserverlijst op en leidt alle verzoeken om naar de spiegelserver(s) die
       uit de lijst uitgekozen wordt/worden. Deze wordt/worden benaderd via overige transportmethodes, zoals
       apt-transport-http(1). De basale functionaliteit hiervan was reeds beschikbaar vanaf apt 0.7.24, maar
       bleef ongedocumenteerd tot apt 1.6, waarin een volledige herwerking van de transportmethode en de erdoor
       ondersteunde functies plaats vond. Merk op dat een transportmethode nooit rechtstreeks door een gebruiker
       aangesproken wordt, maar door APT-gereedschap gebruikt wordt op basis van de gebruikersconfiguratie.

       Indien het verkrijgen van een bestand via een spiegelserver mislukt, zorgt de methode ervoor dat
       automatisch een andere mogelijke spiegelserver uit de lijst geprobeerd wordt, totdat ofwel het bestand
       opgehaald is of er in de lijst geen spiegelservers meer overblijven. Op die manier wordt op een
       transparante manier omgegaan met storingen bij servers en vergelijkbare problemen.

       De implicaties van de methode voor de beveiliging zijn afhankelijk van de gemaakte keuzes inzake
       beveiliging voor de transportmethode die gebruikt wordt om de lijst met spiegelservers op te halen en de
       transportmethodes die betrokken zijn bij het benaderen van de gekozen spiegelserver(s) door de
       transportmethode.

OPTIES

Voor deze transportmethode bestaan momenteel geen configuratieopties. De selectie van de spiegelserver
hangt volledig af van de spiegelservers die in de spiegelserverlijst aangeboden worden en de bestanden
die APT moet verkrijgen.

Indeling van de spiegelserverlijst
Een spiegelserverlijst bestaat uit één of meer regels met een URI van een spiegelserver. Lege regels en
regels die beginnen met een hekje (#) worden genegeerd. Een URI begint steeds meet een URI-methode die de
transportmethode vaststelt die voor die spiegelserver gebruikt wordt. Indien de URI bijvoorbeeld met
http: begint, is de bevoegde transportmethode apt-transport-http(1), welke specifieke eisen kan stellen
aan de indeling van het resterende deel van de URI.

Metadata over een spiegelserver kunnen op dezelfde regel opgegeven worden, gescheiden van de URI met een
tab. Verschillende metadata-elementen kunnen onderling gescheiden worden door tabs of spaties. (Dit is
een gespecialiseerde functionaliteit die enkel beschikbaar is in apt >= 1.6. Eerdere versies van apt
zullen er niet in slagen spiegelserverlijsten met deze functionaliteit te ontleden.)

Vanaf apt 1.6 wordt ook het gebruik van gecomprimeerde spiegelserverlijsten ondersteund. Merk op dat de
bestandsnaam van de spiegelserverlijst moet aangeven welk compressiealgoritme gebruikt wordt. Er gebeurt
geen autodetectie op basis van de inhoud van het bestand.

Spiegelserverselectie op basis van metadata
Zoals aangegeven bij de indeling, kunnen metadata toegevoegd worden aan een spiegelserver om te voorkomen
dat een spiegelserver geselecteerd zou worden voor het bekomen van een bestand dat niet overeenkomt met
deze metadata. Daardoor kan de spiegelserverlijst bijvoorbeeld partiële spiegelservers bevatten die enkel
bepaalde architecturen bedienen en zal APT automatisch een andere spiegelserver kiezen voor bestanden die
voor een niet vermelde architectuur bedoeld zijn. Worden ondersteund: beperkingen op het gebied van
architectuur (arch), de codenaam van de release (codename), de component van de pakketbron waarin het
bestand zich bevindt (component), de taal waarvoor het bestand moet dienen (lang), de suitenaam van de
release (suite) en het bestandstype (type).

Volgorde waarin het teruggevallen op spiegelservers gebeurt
Indien voor een spiegelserver geen volgorde opgegeven is via de metadatasleutel priority, is de volgorde
waarin spiegelservers gecontacteerd worden toevallig. Indien een bepaalde groep spiegelservers eerst
uitgeprobeerd moet worden vooraleer eventuele andere groepen aangesproken worden, kan expliciet een
prioriteit ingesteld worden. De spiegelservers met het laagste getal worden eerst uitgeprobeerd.
Spiegelservers waarvoor geen uitdrukkelijke prioriteit ingesteld werd, hebben standaard het hoogst
mogelijke getal en worden daardoor laatst uitgeprobeerd. De keuze tussen spiegelservers met dezelfde
prioriteit gebeurt opnieuw op basis van toeval.

Toegestane transportmethodes in een spiegelserverlijst
De beschikbaarheid en de keuzemogelijkheden van transportmethodes in een spiegelserverlijst wordt beperkt
door hoe de APT-cliënt de spiegelserverlijst benadert. Indien een lokale transportmethode, zoals file of
copy gebruikt wordt, kan de spiegelserverlijst ook lokale bronnen bevatten, terwijl een
spiegelserverlijst die benaderd wordt via http dat niet kan. Bovendien kan een spiegelserverlijst niet
zelf een spiegelserverlijst bevatten of geen andere transportmethodewikkels (zoals apt-transport-tor).
Zie de documentatie bij deze transportmethodes over hoe u ze met de spiegelservermethode kunt gebruiken.

Merk op dat versies van apt voorafgaand aan 1.6 geen enkele andere transportmethode dan http
ondersteunen.

VOORBEELDEN

   Basaal voorbeeld
       Een basaal voorbeeld van een spiegelserverlijst die door alle versies van apt met een
       spiegelservermethode (>= 0.7.24) ondersteund wordt, waarbij de cliënt om het even welke van de drie
       spiegelservers zal kiezen:

           http://ftp.de.debian.org/debian/
           http://ftp.us.debian.org/debian/
           http://deb.debian.org/debian/

       In de veronderstelling dat een bestand met deze inhoud op uw computer opgeslagen werd als
       /etc/apt/mirrorlist.txt, kan het op de volgende manier gebruikt worden in sources.list(5) (sinds apt
       1.6):

           deb mirror+file:/etc/apt/mirrorlist.txt trixie main

       Alle versies van de spiegelservermethode ondersteunen een spiegelserverlijst die via HTTP benaderd kan
       worden. In de veronderstelling dat het beschikbaar is op http://apt.example.org/mirror.lst, kan het
       element uit de bovenstaande sources.list ook als volgt geschreven worden:

           deb mirror://apt.example.org/mirror.lst trixie main

       Merk op dat met het oog op uniformiteit vanaf apt 1.6 het gebruik van mirror+http de voorkeur zou moeten
       genieten boven mirror. De functionaliteit blijft dezelfde.

   Voorbeeld van een met metadata verrijkte spiegelserverselectie
       Zoals bij de definiëring van de indeling uitgelegd werd, ondersteunen versies van apt voorafgaand aan 1.6
       dit niet. Ze zullen dus de spiegelserverlijst niet kunnen ontleden. De voorbeeldspiegelserverlijst is met
       opzet gecompliceerd gemaakt om een aantal aspecten van het selectieproces te illustreren. Er wordt
       uitgegaan van de volgende opstelling: de eerste spiegelserver is een lokale spiegelserver die via de
       methode file kan benaderd worden, maar mogelijk is deze onvolledig. De tweede spiegelserver heeft een
       zeer goede verbinding, maar het is een gedeeltelijke spiegelserver in die zin dat hij enkel bestanden
       bevat bedoeld voor de architecturen amd64 en all. De overige spiegelservers zijn doorsneespiegelservers
       die enkel gecontacteerd moeten worden als de voorgaande niet werken.

           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/

       In deze opstelling met deze spiegelserverlijst, zal de eerste spiegelserver gebruikt worden om alle
       indexbestanden te downloaden, in de veronderstelling dat de spiegelserverlijst zelf benaderd wordt via
       een lokale transportmethode zoals file. Indien dit niet het geval is, of indien de spiegelserver om een
       andere reden niet bereikbaar is, of indien hij het gevraagde bestand niet ter beschikking heeft, zal een
       andere spiegelserver gebruikt worden om het bestand te bekomen, en die zal gekozen worden op basis van
       het type bestand: een indexbestand zal door de laatste server uit de lijst aangeleverd worden, terwijl
       een pakket voor de architectuur amd64 aangeleverd wordt door de tweede en die voor bijv. de architectuur
       i386 door een van de drie laatste.

BUGS

       APT bugpagina[1]. Indien u een bug in APT wilt rapporteren, raadpleeg dan
       /usr/share/doc/debian/bug-reporting.txt of het reportbug(1) commando.

VERTALING

       De Nederlandse vertaling werd in 2015 gemaakt door Frans Spiesschaert <Frans.Spiesschaert@yucom.be>, in
       samenwerking met het Debian Dutch l10n Team <debian-l10n-dutch@lists.debian.org>.

       Merk op dat de vertaling van dit document nog onvertaalde delen kan bevatten. Dit is intentioneel om te
       vermijden dat inhoud verloren zou gaan door een vertaling die achterop loopt op het origineel.

AUTEUR

       APT-team

OPMERKINGEN

        1. APT bugpagina
           https://bugs.debian.org/src:apt

APT 3.1.3                                       09 december 2017                           APT-TRANSPORT-MIRR(1)