Lire en anglais

Partager via


Tutoriel : Configurer un cache de ressources vcpkg

Tous les caches de ressources sont configurés via la variable d’environnement X_VCPKG_ASSET_SOURCES . La valeur de X_VCPKG_ASSET_SOURCES suit une syntaxe de configuration spécifique.

Ce didacticiel vous montre comment effectuer les opérations suivantes :

Prérequis

  • Un terminal
  • vcpkg

1 - Créer un répertoire de cache de ressources

Vous pouvez utiliser le serveur principal Stockage Blob Azure «x-azurl » pour stocker des ressources. Vous pouvez également utiliser des répertoires de système de fichiers pour stocker vos ressources de téléchargement, y compris les emplacements réseau. Pour ce faire, vous devez utiliser le file:// protocole dans votre URL de cache de ressources.

Dans ce tutoriel, vous allez créer un emplacement de cache de ressources local pour stocker les artefacts téléchargés. Si vous disposez d’un stockage Blob Azure DevOps que vous souhaitez utiliser à la place, remplacez l’URL et fournissez un jeton SAP comme deuxième paramètre dans la chaîne de configuration.

  1. Créez un répertoire pour servir d’emplacement de cache de ressources (remplacez par tous les emplacements de votre choix) :
mkdir D:\vcpkg\asset-cache
mkdir /home/vcpkg/asset-cache

2 - Configurer X_VCPKG_ASSET_SOURCES

Définissez ensuite la valeur comme X_VCPKG_ASSET_SOURCES suit :

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

Notes

La définition de variables d’environnement de cette façon affecte uniquement la session de terminal active. Pour rendre ces modifications permanentes dans toutes les sessions, définissez-les via le panneau Variables d’environnement système Windows.

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

Notes

La définition de variables d’environnement de cette façon affecte uniquement la session de terminal active. Pour rendre ces modifications permanentes dans toutes les sessions, définissez-les via le panneau Variables d’environnement système Windows.

Cette X_VCPKG_ASSET_SOURCES configuration ajoute les chaînes sources suivantes :

  • clear, désactive tout cache de ressources précédemment configuré
  • x-azurl,file://C:/vcpkg/asset-cache,,readwrite, définit un cache de ressources du système de fichiers, situé dans , avec des autorisations en D:\vcpkg\asset-cachelecture-écriture.
export X_VCPKG_ASSET_SOURCES="clear;x-azurl,file:///home/vcpkg/asset-cache,,readwrite"

Notes

La définition de variables d’environnement à l’aide de la export commande affecte uniquement la session shell active. Pour rendre cette modification permanente entre les sessions, ajoutez la export commande au script de profil de votre interpréteur de commandes (par exemple, ~/.bashrc ou ~/.zshrc).

Cette X_VCPKG_ASSET_SOURCES configuration ajoute les chaînes sources suivantes :

  • clear, désactive tout cache de ressources précédemment configuré
  • x-azurl,file:///home/vcpkg/asset-cache,,readwrite, définit un cache de ressources du système de fichiers, situé dans , avec des autorisations en home/vcpkg/asset-cachelecture-écriture.

Étapes suivantes

Voici d’autres tâches à essayer ensuite :