Freigeben über

Lernprogramm: Einrichten eines vcpkg-Ressourcencaches

  • Artikel

Alle Ressourcencaches werden über die X_VCPKG_ASSET_SOURCES Umgebungsvariable konfiguriert. Der Wert folgt X_VCPKG_ASSET_SOURCES einer bestimmten Konfigurationssyntax.

In diesem Tutorial lernen Sie Folgendes:

Voraussetzungen

  • Ein Terminal
  • vcpkg

1 – Erstellen eines Objektcacheverzeichnisses

Sie können das Azure Blob Storage-Back-End "x-azurl" verwenden, um Ressourcen zu speichern. Alternativ können Sie Dateisystemverzeichnisse verwenden, um Ihre Downloadressourcen, einschließlich Netzwerkspeicherorte, zu speichern. Dazu müssen Sie das file:// Protokoll in Ihrer Objektcache-URL verwenden.

In diesem Lernprogramm erstellen Sie einen lokalen Speicherort für den Objektcache, um heruntergeladene Artefakte zu speichern. Wenn Sie stattdessen über einen Azure DevOps Blob Storage verfügen, ersetzen Sie die URL, und stellen Sie ein SAS-Token als zweiten Parameter in der Konfigurationszeichenfolge bereit.

  1. Erstellen Sie ein Verzeichnis, das als Objektcachespeicherort dient (ersetzen Sie durch beliebige Speicherorte Ihrer Wahl):
mkdir D:\vcpkg\asset-cache

mkdir /home/vcpkg/asset-cache

2 – Konfigurieren X_VCPKG_ASSET_SOURCES

Legen Sie als Nächstes den Wert wie X_VCPKG_ASSET_SOURCES folgt fest:

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

Hinweis

Das Festlegen von Umgebungsvariablen auf diese Weise wirkt sich nur auf die aktuelle Terminalsitzung aus. Um diese Änderungen in allen Sitzungen dauerhaft vorzunehmen, legen Sie sie über den Bereich "Windows System Environment Variables" fest.

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

Hinweis

Das Festlegen von Umgebungsvariablen auf diese Weise wirkt sich nur auf die aktuelle Terminalsitzung aus. Um diese Änderungen in allen Sitzungen dauerhaft vorzunehmen, legen Sie sie über den Bereich "Windows System Environment Variables" fest.

Diese X_VCPKG_ASSET_SOURCES Konfiguration fügt die folgenden Quellzeichenfolgen hinzu:

  • clear, deaktiviert alle zuvor konfigurierten Ressourcencaches.
  • x-azurl,file://C:/vcpkg/asset-cache,,readwrite, legt einen Dateisystem-Objektcache fest, der sich in D:\vcpkg\asset-cache, mit Lese-/Schreibberechtigungen befindet.
export X_VCPKG_ASSET_SOURCES="clear;x-azurl,file:///home/vcpkg/asset-cache,,readwrite"

Hinweis

Das Festlegen von Umgebungsvariablen mit dem export Befehl wirkt sich nur auf die aktuelle Shellsitzung aus. Um diese Änderung dauerhaft in Sitzungen vorzunehmen, fügen Sie den export Befehl zum Profilskript Ihrer Shell hinzu (z. B ~/.bashrc . oder ~/.zshrc).

Diese X_VCPKG_ASSET_SOURCES Konfiguration fügt die folgenden Quellzeichenfolgen hinzu:

  • clear, deaktiviert alle zuvor konfigurierten Ressourcencaches.
  • x-azurl,file:///home/vcpkg/asset-cache,,readwrite, legt einen Dateisystem-Objektcache fest, der sich in home/vcpkg/asset-cache, mit Lese-/Schreibberechtigungen befindet.

Nächste Schritte

Hier sind weitere Aufgaben, die Sie als Nächstes ausprobieren können: