Configuratie van assetcaching

Bronnen

De <rw> parameter is optioneel en gebruikelijk voor de meeste bronnen die hieronder worden beschreven. Het beheert de toegangsmachtigingen voor de specifieke bron en accepteert de waarden read, writeof readwrite (standaard).read

Gebruik een backtick (') om tekens in de brontekenreeksen te escapen.

clear

Syntaxis: clear

Verwijdert alle vorige bronnen in de configuratietekenreeks. Handig in combinatie met de --x-asset-sources parameter om alle bronnen voor assetcaching uit te schakelen die afkomstig zijn van de X_VCPKG_ASSET_SOURCES omgevingsvariabele.

Azure Blob Storage (x-azurl)

Syntaxis:

1. x-azurl,<url>[,<sas>[,<rw>]]
2. x-azurl,file://<network-location>[,,<rw>]

<url>: Vereist. De VERBINDINGS-URL van Azure Blob Storage. Het moet het containerpad en een volgpad /bevatten.

<sas>: optioneel. Gebruik deze parameter voor eindpunten die gebruikmaken van Shared Access Signature-validatie om de gegenereerde SAS op te geven.

Niet-Azure-eindpunten kunnen een toegangstoken bieden met behulp van deze parameter. Zolang ze kunnen reageren op GET- en PUT-aanvragen van het formulier <url>/<sha512>?<sas>.

Een bron die als volgt is geconfigureerd, azurl,https://mydomain.com/vcpkg/,token=abc123,readwriteproduceert bijvoorbeeld een aanvraag in het formulier: https://mydomain.com/vcpkg/<sha512>?token=abc123.

U kunt ook een bestandssysteemlocatie als eindpunt gebruiken met behulp van het x-azurl,file://<filesystem-location>[,,<rw>] patroon.

Configureert bijvoorbeeld x-azurl,file://Z:/vcpkg/assetcache/,,readwrite een cache in de Z:/ netwerkmap.

De werkstroom van deze assetbron is:

1. Poging om te lezen vanuit de spiegel
2. (Als stap 1 is mislukt) Lezen uit de oorspronkelijke URL
3. (Als stap 2 is geslaagd) Terugschrijven naar de spiegel

U kunt stap 1 en 3 in- of uitschakelen via de <rw> aanduiding en u kunt stap 2 hieronder x-block-origin uitschakelen.

Zie ook de documentatie voor binaire caching voor Azure Blob Storage voor meer informatie over het instellen van een x-azurl bron.

x-block-origin

Syntaxis: x-block-origin

Schakelt terug naar de oorspronkelijke download-URL wanneer een asset niet wordt gevonden in een van de geconfigureerde bronnen.

x-script

Syntaxis: x-script,<template>

Verzendt naar een extern hulpprogramma om de asset op te halen.

<template>: Vereist. Een opdrachtsjabloon die vcpkg uitvoert om een asset te verkrijgen. Bijvoorbeeld: x-script,curl -L {url} --output {dst} configureert vcpkg voor het uitvoeren curl en opgeven van de {url} en {dst} parameters.

De logica voor het herstellen en uploaden van assets en het maken van verbinding met het eindpunt voor cacheopslag is de verantwoordelijkheid van de opdracht in de sjabloon.

vcpkg vervangt deze argumenten bij het uitvoeren van de opdracht:

• {url}: de oorspronkelijke download-URL voor de asset.
• {sha512}: de verwachte SHA512 van de gedownloade asset.
• {dst}: de locatie waar de gedownloade asset wordt verwacht.

De sjabloonopdracht wordt uitgevoerd in de build-omgeving van vcpkg; dit betekent dat sommige omgevingsvariabelen, zoals PATH deze kunnen worden gewijzigd door de triplet.

Volgende stap