Partage via

Informations de référence sur la mise en cache des ressources

  • Article

Sources

Le <rw> paramètre est facultatif et commun à la plupart des sources décrites ci-dessous. Il contrôle les autorisations d’accès pour la source spécifique et accepte les valeurs read, writeou readwrite (valeur par défaut read).

Utilisez un backtick (') pour échapper des caractères à l’intérieur des chaînes sources.

clear

Syntaxe : clear

Supprime toutes les sources précédentes dans la chaîne de configuration. Utile en combinaison avec le --x-asset-sources paramètre pour désactiver toutes les sources de mise en cache des ressources provenant de la variable d’environnement X_VCPKG_ASSET_SOURCES .

Stockage Blob Azure (x-azurl)

Syntaxe :

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

<url>: requis. URL de connexion Stockage Blob Azure. Il doit inclure le chemin d’accès du conteneur et un chemin de /fin.

<sas> : Facultatif. Pour les points de terminaison utilisant la validation de signature d’accès partagé, utilisez ce paramètre pour fournir la SAP générée.

Les points de terminaison non-Azure peuvent fournir un jeton d’accès à l’aide de ce paramètre. Tant qu’ils peuvent répondre aux demandes GET et PUT du formulaire <url>/<sha512>?<sas>.

Par exemple, une source configurée comme suit : azurl,https://mydomain.com/vcpkg/,token=abc123,readwrite, produit une requête au format : https://mydomain.com/vcpkg/<sha512>?token=abc123.

Vous pouvez également utiliser un emplacement de système de fichiers comme point de terminaison à l’aide du x-azurl,file://<filesystem-location>[,,<rw>] modèle.

Par exemple, x-azurl,file:///Z:/vcpkg/assetcache/,,readwrite configure un cache dans le Z:/ dossier réseau.

Le flux de travail de cette source de ressources est :

  1. Tentative de lecture à partir du miroir
  2. (Échec de l’étape 1) Lire à partir de l’URL d’origine
  3. (Si l’étape 2 a réussi) Réécrire dans le miroir

Vous pouvez activer/désactiver les étapes 1 et 3 via le spécificateur, et désactiver l’étape <rw> 2 via x-block-origin ci-dessous.

Consultez également la documentation de mise en cache binaire pour Stockage Blob Azure pour plus d’informations sur la configuration d’une x-azurl source.

x-block-origin

Syntaxe : x-block-origin

Désactive la restauration vers l’URL de téléchargement d’origine lorsqu’une ressource n’est trouvée dans aucune des sources configurées.

x-script

Syntaxe : x-script,<template>

Répartit vers un outil externe pour récupérer la ressource.

<template>: requis. Modèle de commande exécuté par vcpkg pour acquérir une ressource. Par exemple : x-script,curl -L {url} --output {dst} configure vcpkg pour qu’il s’exécute curl et fournisse les paramètres et {dst} les {url} paramètres.

La logique de restauration et de chargement des ressources et de connexion au point de terminaison de stockage du cache est responsable de la commande fournie dans le modèle.

vcpkg remplace ces arguments lors de l’exécution de la commande :

  • {url}: URL de téléchargement d’origine de la ressource.
  • {sha512}: sha512 attendu de la ressource téléchargée.
  • {dst}: emplacement où la ressource téléchargée est attendue.

La commande de modèle est exécutée dans l’environnement de build de vcpkg ; cela signifie que certaines variables d’environnement telles PATH que peuvent être modifiées par le triplet.

Étape suivante

Utiliser un script personnalisé comme source de mise en cache des ressources pour NuGet