Конфигурация кэширования активов
Этот <rw>
параметр является необязательным и общим для большинства источников, описанных ниже. Он управляет разрешениями доступа для конкретного источника и принимает значения read
или write
readwrite
(по умолчаниюread
).
Используйте обратную черту ('), чтобы экранировать символы внутри исходных строк.
Синтаксис: clear
Удаляет все предыдущие источники в строке конфигурации. Полезно в сочетании с параметром --x-asset-sources
, чтобы отключить все источники кэширования ресурсов, поступающие из переменной X_VCPKG_ASSET_SOURCES
среды.
Синтаксис
x-azurl,<url>[,<sas>[,<rw>]]
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 завершился ошибкой) Чтение из исходного URL-адреса
- (Если шаг 2 выполнен успешно) Обратная запись в зеркало
Вы можете включить или отключить шаги 1 и 3 с помощью <rw>
описателя, и вы можете отключить шаг 2, выполнив x-block-origin
указанный ниже шаг.
Дополнительные сведения о настройке источника см. в документации по двоичному x-azurl
кэшированию для Хранилище BLOB-объектов Azure.
Синтаксис: x-block-origin
Отключает возврат к исходному URL-адресу загрузки, если ресурс не найден ни в одном из настроенных источников.
Синтаксис: x-script,<template>
Отправляется во внешнее средство для получения ресурса.
<template>
: обязательный. Шаблон команды, который выполняется vcpkg для получения ресурса. Например, x-script,curl -L {url} --output {dst}
настраивает vcpkg для выполнения curl
и предоставления {url}
{dst}
параметров.
Логика для восстановления и отправки ресурсов и подключения к конечной точке хранилища кэша отвечает за команду, предоставленную в шаблоне.
vcpkg заменит эти аргументы при выполнении команды:
{url}
: исходный URL-адрес скачивания для ресурса.{sha512}
: ожидаемый SHA512 скачанный ресурс.{dst}
: расположение, в котором ожидается скачанный ресурс.
Команда шаблона выполняется в среде сборки vcpkg; это означает, что некоторые переменные среды, например PATH
, могут быть изменены тройникой.
Отзыв о vcpkg
vcpkg — это проект с открытым исходным кодом. Выберите ссылку, чтобы оставить отзыв: