Share via

Referenční informace k ukládání prostředků do mezipaměti

  • Článek

Zdroje

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, writenebo readwrite (výchozí nastavení read).

Pomocí zpětného znaménu (') uvozujte znaky uvnitř zdrojových řetězců.

clear

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í.

Azure Blob Storage (x-azurl)

Syntaxe:

  1. x-azurl,<url>[,<sas>[,<rw>]]
  2. 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:

  1. Pokus o čtení ze zrcadla
  2. (Pokud krok 1 selhal) Čtení z původní adresy URL
  3. (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.

x-block-origin

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ů.

x-script

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.

Další krok

Použití vlastního skriptu jako zdroje ukládání prostředků do mezipaměti pro NuGet