Konfigurace ukládání prostředků do mezipaměti
Parametr <rw>
je volitelný a společný pro většinu níže popsaných zdrojů. Řídí přístupová oprávnění pro konkrétní zdroj a přijímá hodnoty read
, write
nebo readwrite
(výchozí nastavení read
).
Pomocí zpětného znaménu (') uvozujte znaky uvnitř zdrojových řetězců.
Syntaxe: clear
Odebere všechny předchozí zdroje v konfiguračním řetězci. Užitečné v kombinaci s parametrem --x-asset-sources
k zakázání všech zdrojů ukládání do mezipaměti prostředků pocházejících z X_VCPKG_ASSET_SOURCES
proměnné prostředí.
Syntaxe:
x-azurl,<url>[,<sas>[,<rw>]]
x-azurl,file://<network-location>[,,<rw>]
<url>
:Požadovaný. Adresa URL připojení ke službě Azure Blob Storage Musí obsahovat cestu kontejneru a koncovou /
cestu .
<sas>
:Volitelný. U koncových bodů používajících ověřování sdíleného přístupového podpisu použijte tento parametr k poskytnutí vygenerovaného sdíleného přístupového podpisu.
Koncové body mimo Azure můžou poskytnout přístupový token pomocí tohoto parametru. Pokud mohou reagovat na požadavky GET a PUT formuláře <url>/<sha512>?<sas>
.
Například zdroj nakonfigurovaný takto: azurl,https://mydomain.com/vcpkg/,token=abc123,readwrite
, vytvoří požadavek ve formuláři: https://mydomain.com/vcpkg/<sha512>?token=abc123
.
Alternativně můžete jako koncový bod použít umístění systému souborů pomocí x-azurl,file://<filesystem-location>[,,<rw>]
vzoru.
Například x-azurl,file:///Z:/vcpkg/assetcache/,,readwrite
nakonfiguruje mezipaměť v Z:/
síťové složce.
Pracovní postup tohoto zdroje prostředků je:
- Pokus o čtení ze zrcadla
- (Pokud krok 1 selhal) Čtení z původní adresy URL
- (Pokud krok 2 proběhl úspěšně) Zpětný zápis do zrcadla
Kroky 1 a 3 můžete povolit nebo zakázat prostřednictvím specifikátoru <rw>
a krok 2 můžete zakázat pomocí x-block-origin
následujícího postupu.
Další informace o nastavení x-azurl
zdroje najdete také v dokumentaci k binárnímu ukládání do mezipaměti pro Azure Blob Storage.
Syntaxe: x-block-origin
Zakáže vrácení zpět na původní adresu URL stahování, pokud se prostředek nenajde v žádném z nakonfigurovaných zdrojů.
Syntaxe: x-script,<template>
Odešle do externího nástroje pro načtení prostředku.
<template>
:Požadovaný. Šablona příkazu, která vcpkg provede, aby získala prostředek. Příklad: x-script,curl -L {url} --output {dst}
Nakonfiguruje vcpkg ke spuštění curl
a zadání {url}
parametrů.{dst}
Logika pro obnovení a nahrání prostředků a připojení ke koncovému bodu úložiště mezipaměti odpovídá za příkaz poskytnutý v rámci šablony.
Vcpkg při provádění příkazu nahradí tyto argumenty:
{url}
: původní adresa URL pro stažení prostředku.{sha512}
: očekávaný sha512 staženého prostředku.{dst}
: umístění, kde se očekává stažený prostředek.
Příkaz šablony se spustí v prostředí sestavení vcpkg; to znamená, že některé proměnné prostředí, jako PATH
jsou, mohou být upraveny triplet.
Zpětná vazba k produktu vcpkg
vcpkg je open source projekt. Vyberte odkaz pro poskytnutí zpětné vazby: