APT-TRANSPORT-MIRR(1)

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 bookworm 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 bookworm 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
    http://bugs.debian.org/src:apt