Compartir a través de

Referencia de almacenamiento en caché de recursos

  • Artículo

Orígenes

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, writeo readwrite (el valor predeterminado es read).

Use un verso (') para escapar caracteres dentro de las cadenas de origen.

clear

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.

Azure Blob Storage (x-azurl)

Sintaxis:

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

  1. Intento de leer desde el reflejo
  2. (Si se produjo un error en el paso 1) Lectura de la dirección URL original
  3. (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.

x-block-origin

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.

x-script

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 .

Paso siguiente

Uso de un script personalizado como origen de almacenamiento en caché de recursos para NuGet