Configuración del almacenamiento en caché de recursos
El <rw>
parámetro es opcional y común a la mayoría de los orígenes que se describen a continuación. Controla los permisos de acceso para el origen específico y acepta los valores read
, write
o readwrite
(el valor predeterminado es read
).
Use un verso (') para escapar caracteres dentro de las cadenas de origen.
Sintaxis: clear
Quita todos los orígenes anteriores de la cadena de configuración. Resulta útil en combinación con el --x-asset-sources
parámetro para deshabilitar todos los orígenes de almacenamiento en caché de recursos procedentes de la X_VCPKG_ASSET_SOURCES
variable de entorno.
Sintaxis:
x-azurl,<url>[,<sas>[,<rw>]]
x-azurl,file://<network-location>[,,<rw>]
<url>
: obligatorio. Dirección URL de conexión de Azure Blob Storage. Debe incluir la ruta de acceso del contenedor y una ruta de acceso final /
.
<sas>
: opcional. Para los puntos de conexión que usan la validación de firma de acceso compartido, use este parámetro para proporcionar la SAS generada.
Los puntos de conexión que no son de Azure pueden proporcionar un token de acceso mediante este parámetro. Siempre que puedan responder a las solicitudes GET y PUT del formulario <url>/<sha512>?<sas>
.
Por ejemplo, un origen configurado de la siguiente manera: azurl,https://mydomain.com/vcpkg/,token=abc123,readwrite
, genera una solicitud con el formato : https://mydomain.com/vcpkg/<sha512>?token=abc123
.
Como alternativa, puede usar una ubicación del sistema de archivos como punto de conexión mediante el x-azurl,file://<filesystem-location>[,,<rw>]
patrón .
Por ejemplo, x-azurl,file:///Z:/vcpkg/assetcache/,,readwrite
configura una caché en la Z:/
carpeta de red.
El flujo de trabajo de este origen de recursos es:
- Intento de leer desde el reflejo
- (Si se produjo un error en el paso 1) Lectura de la dirección URL original
- (Si el paso 2 se realizó correctamente) Reescritura en el reflejo
Puede habilitar o deshabilitar los pasos 1 y 3 a través del especificador, y puede deshabilitar el <rw>
paso 2 a continuación x-block-origin
.
Consulte también la documentación sobre el almacenamiento en caché binario para Azure Blob Storage para más información sobre cómo configurar un x-azurl
origen.
Sintaxis: x-block-origin
Deshabilita la revierte a la dirección URL de descarga original cuando no se encuentra un recurso en ninguno de los orígenes configurados.
Sintaxis: x-script,<template>
Envía a una herramienta externa para capturar el recurso.
<template>
: obligatorio. Plantilla de comandos que vcpkg ejecuta para adquirir un recurso. Por ejemplo: x-script,curl -L {url} --output {dst}
configura vcpkg para ejecutar curl
y proporcionar los {url}
parámetros y {dst}
.
La lógica para restaurar y cargar recursos y para conectarse al punto de conexión de almacenamiento de caché es responsabilidad del comando proporcionado dentro de la plantilla.
vcpkg reemplazará estos argumentos al ejecutar el comando:
{url}
: la dirección URL de descarga original del recurso.{sha512}
: el SHA512 esperado del recurso descargado.{dst}
: la ubicación donde se espera el recurso descargado.
El comando de plantilla se ejecuta en el entorno de compilación de vcpkg; esto significa que el triple puede modificar algunas variables de entorno como PATH
.
Comentarios de vcpkg
vcpkg es un proyecto de código abierto. Seleccione un vínculo para proporcionar comentarios: