Configuration de la mise en cache des ressources
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
, write
ou readwrite
(valeur par défaut read
).
Utilisez un backtick (') pour échapper des caractères à l’intérieur des chaînes sources.
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
.
Syntaxe :
x-azurl,<url>[,<sas>[,<rw>]]
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 :
- Tentative de lecture à partir du miroir
- (Échec de l’étape 1) Lire à partir de l’URL d’origine
- (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.
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.
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.
Commentaires sur vcpkg
vcpkg est un projet open source. Sélectionnez un lien pour fournir des commentaires :