Leer en inglés

Compartir a través de


Tutorial: Configuración de una caché de recursos vcpkg

Todas las cachés de recursos se configuran a través de la variable de X_VCPKG_ASSET_SOURCES entorno. El valor de sigue una sintaxis de X_VCPKG_ASSET_SOURCES configuración específica.

En este tutorial, aprenderá a:

Requisitos previos

  • Un terminal
  • vcpkg

1- Creación de un directorio de caché de recursos

Puede usar el back-end de Azure Blob Storage "x-azurl" para almacenar recursos. Como alternativa, puede usar directorios del sistema de archivos para almacenar los recursos de descarga, incluidas las ubicaciones de red. Para ello, debe usar el protocolo en la dirección URL de caché file:// de recursos.

En este tutorial, creará una ubicación de caché de recursos local para almacenar artefactos descargados. Si tiene una instancia de Azure DevOps Blob Storage que quiere usar en su lugar, reemplace la dirección URL y proporcione un token de SAS como segundo parámetro de la cadena de configuración.

  1. Cree un directorio para que actúe como una ubicación de caché de recursos (sustituya por las ubicaciones que elija):
mkdir D:\vcpkg\asset-cache
mkdir /home/vcpkg/asset-cache

2 - Configurar X_VCPKG_ASSET_SOURCES

A continuación, establezca el valor de X_VCPKG_ASSET_SOURCES como se indica a continuación:

$env:X_VCPKG_ASSET_SOURCES="clear;x-azurl,file://D:/vcpkg/asset-cache,,readwrite"

Nota

Establecer variables de entorno de esta manera solo afecta a la sesión de terminal actual. Para realizar estos cambios permanentes en todas las sesiones, establézcalos en el panel Variables de entorno del sistema de Windows.

set "X_VCPKG_ASSET_SOURCES=clear;x-azurl,file://D:/vcpkg/asset-cache,,readwrite"

Nota

Establecer variables de entorno de esta manera solo afecta a la sesión de terminal actual. Para realizar estos cambios permanentes en todas las sesiones, establézcalos en el panel Variables de entorno del sistema de Windows.

Esta X_VCPKG_ASSET_SOURCES configuración agrega las siguientes cadenas de origen:

  • clear, deshabilita cualquier caché de recursos configurada anteriormente.
  • x-azurl,file://C:/vcpkg/asset-cache,,readwrite, establece una caché de recursos del sistema de archivos, ubicada en D:\vcpkg\asset-cache, con permisos de lectura y escritura.
export X_VCPKG_ASSET_SOURCES="clear;x-azurl,file:///home/vcpkg/asset-cache,,readwrite"

Nota

Establecer variables de entorno con el export comando solo afecta a la sesión de shell actual. Para que este cambio sea permanente entre sesiones, agregue el export comando al script de perfil del shell (por ejemplo, ~/.bashrc o ~/.zshrc).

Esta X_VCPKG_ASSET_SOURCES configuración agrega las siguientes cadenas de origen:

  • clear, deshabilita cualquier caché de recursos configurada anteriormente.
  • x-azurl,file:///home/vcpkg/asset-cache,,readwrite, establece una caché de recursos del sistema de archivos, ubicada en home/vcpkg/asset-cache, con permisos de lectura y escritura.

Pasos siguientes

Estas son otras tareas que se van a probar a continuación: