Share via

Справочник по кэшированию активов

  • Статья

Источники

Этот <rw> параметр является необязательным и общим для большинства источников, описанных ниже. Он управляет разрешениями доступа для конкретного источника и принимает значения readили writereadwrite (по умолчаниюread).

Используйте обратную черту ('), чтобы экранировать символы внутри исходных строк.

clear

Синтаксис: clear

Удаляет все предыдущие источники в строке конфигурации. Полезно в сочетании с параметром --x-asset-sources , чтобы отключить все источники кэширования ресурсов, поступающие из переменной X_VCPKG_ASSET_SOURCES среды.

Хранилище BLOB-объектов Azure (x-azurl)

Синтаксис

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

<url>: обязательный. URL-адрес подключения Хранилище BLOB-объектов Azure. Он должен включать путь к контейнеру и конечный /путь.

<sas>: необязательный параметр. Для конечных точек, использующих проверку подписанного URL-адреса, используйте этот параметр для предоставления созданного SAS.

Конечные точки, отличные от Azure, могут предоставлять маркер доступа с помощью этого параметра. Если они могут отвечать на запросы GET и PUT формы <url>/<sha512>?<sas>.

Например, источник, настроенный следующим образом: azurl,https://mydomain.com/vcpkg/,token=abc123,readwriteсоздает запрос в форме: https://mydomain.com/vcpkg/<sha512>?token=abc123

Кроме того, можно использовать расположение файловой системы в качестве конечной точки с помощью x-azurl,file://<filesystem-location>[,,<rw>] шаблона.

Например, x-azurl,file:///Z:/vcpkg/assetcache/,,readwrite настраивает кэш в сетевой папке Z:/ .

Рабочий процесс этого источника ресурса:

  1. Попытка считывания из зеркало
  2. (Если шаг 1 завершился ошибкой) Чтение из исходного URL-адреса
  3. (Если шаг 2 выполнен успешно) Обратная запись в зеркало

Вы можете включить или отключить шаги 1 и 3 с помощью <rw> описателя, и вы можете отключить шаг 2, выполнив x-block-origin указанный ниже шаг.

Дополнительные сведения о настройке источника см. в документации по двоичному x-azurl кэшированию для Хранилище BLOB-объектов Azure.

x-block-origin

Синтаксис: x-block-origin

Отключает возврат к исходному URL-адресу загрузки, если ресурс не найден ни в одном из настроенных источников.

x-script

Синтаксис: x-script,<template>

Отправляется во внешнее средство для получения ресурса.

<template>: обязательный. Шаблон команды, который выполняется vcpkg для получения ресурса. Например, x-script,curl -L {url} --output {dst} настраивает vcpkg для выполнения curl и предоставления {url}{dst} параметров.

Логика для восстановления и отправки ресурсов и подключения к конечной точке хранилища кэша отвечает за команду, предоставленную в шаблоне.

vcpkg заменит эти аргументы при выполнении команды:

  • {url}: исходный URL-адрес скачивания для ресурса.
  • {sha512}: ожидаемый SHA512 скачанный ресурс.
  • {dst}: расположение, в котором ожидается скачанный ресурс.

Команда шаблона выполняется в среде сборки vcpkg; это означает, что некоторые переменные среды, например PATH , могут быть изменены тройникой.

Следующий шаг

Использование пользовательского скрипта в качестве источника кэширования ресурсов для NuGet