Konfiguration av cachelagring av tillgångar

Källor

Parametern <rw> är valfri och gemensam för de flesta källor som beskrivs nedan. Den styr åtkomstbehörigheter för den specifika källan och accepterar värdena read, writeeller readwrite (standardvärdet read).

Använd en backtick (') för att undkomma tecken i källsträngarna.

clear

Syntax: clear

Tar bort alla tidigare källor i konfigurationssträngen. Användbart i kombination med parametern --x-asset-sources för att inaktivera alla cachelagringskällor för tillgångar som kommer från X_VCPKG_ASSET_SOURCES miljövariabeln.

Azure Blob Storage (x-azurl)

Syntax:

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

<url>:Krävs. Url:en för Azure Blob Storage-anslutningen. Den måste innehålla containersökvägen och en avslutande /.

<sas>: Valfritt. För slutpunkter som använder validering av signatur för delad åtkomst använder du den här parametern för att ange den genererade SAS:en.

Icke-Azure-slutpunkter kan tillhandahålla en åtkomsttoken med den här parametern. Så länge de kan svara på GET- och PUT-begäranden i formuläret <url>/<sha512>?<sas>.

Till exempel skapar en källa som konfigurerats på följande sätt: azurl,https://mydomain.com/vcpkg/,token=abc123,readwrite, en begäran i formuläret: https://mydomain.com/vcpkg/<sha512>?token=abc123.

Du kan också använda en filsystemplats som slutpunkt med hjälp x-azurl,file://<filesystem-location>[,,<rw>] av mönstret.

Konfigurerar till exempel x-azurl,file://Z:/vcpkg/assetcache/,,readwrite en cache i nätverksmappen Z:/ .

Arbetsflödet för den här tillgångskällan är:

1. Försök att läsa från spegeln
2. (Om steg 1 misslyckades) Läs från den ursprungliga URL:en
3. (Om steg 2 lyckades) Skriv tillbaka till speglingen

Du kan aktivera/inaktivera steg 1 och 3 via <rw> specificeraren och du kan inaktivera steg 2 via x-block-origin nedan.

Mer information om hur du konfigurerar en källa finns i x-azurl.

x-block-origin

Syntax: x-block-origin

Inaktiverar återställning till den ursprungliga nedladdnings-URL:en när en tillgång inte hittas i någon av de konfigurerade källorna.

x-script

Syntax: x-script,<template>

Skickar till ett externt verktyg för att hämta tillgången.

<template>:Krävs. En kommandomall som vcpkg kör för att hämta en tillgång. Till exempel: x-script,curl -L {url} --output {dst} konfigurerar vcpkg för att köra curl och ange parametrarna {url} och {dst} .

Logiken för att återställa och ladda upp tillgångar och ansluta till cachelagringsslutpunkten är ansvaret för kommandot som tillhandahålls i mallen.

vcpkg ersätter dessa argument när kommandot körs:

• {url}: den ursprungliga nedladdnings-URL:en för tillgången.
• {sha512}: den förväntade SHA512 för den nedladdade tillgången.
• {dst}: den plats där den nedladdade tillgången förväntas.

Mallkommandot körs i vcpkgs byggmiljö. Det innebär att vissa miljövariabler som PATH kan ändras av trillingen.

Nästa steg

Använda ett anpassat skript som cachelagringskälla för en tillgång för NuGet