Auf Englisch lesen

Freigeben über


Konfiguration der Objektzwischenspeicherung

Sources

Der <rw> Parameter ist optional und gilt für die meisten unten beschriebenen Quellen. Sie steuert Zugriffsberechtigungen für die bestimmte Quelle und akzeptiert die Werte read, writeoder readwrite (Standardwerte für read).

Verwenden Sie ein Backtick (') zum Escapezeichen innerhalb der Quellzeichenfolgen.

clear

Syntax: clear

Entfernt alle vorherigen Quellen in der Konfigurationszeichenfolge. Nützlich in Kombination mit dem --x-asset-sources Parameter zum Deaktivieren aller Ressourcenzwischenspeicherungsquellen, die aus der X_VCPKG_ASSET_SOURCES Umgebungsvariable stammen.

Azure Blob Storage (x-azurl)

Syntax:

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

<url>: Erforderlich. Die Azure Blob Storage-Verbindungs-URL. Er muss den Containerpfad und einen nachgestellten /Pfad enthalten.

<sas>: Optional. Verwenden Sie für Endpunkte, die die Signaturüberprüfung für den freigegebenen Zugriff verwenden, diesen Parameter, um die generierte SAS bereitzustellen.

Nicht-Azure-Endpunkte können mithilfe dieses Parameters ein Zugriffstoken bereitstellen. Solange sie auf GET- und PUT-Anforderungen des Formulars <url>/<sha512>?<sas>reagieren können.

Beispielsweise erzeugt eine wie folgt azurl,https://mydomain.com/vcpkg/,token=abc123,readwritekonfigurierte Quelle eine Anforderung im Formular: https://mydomain.com/vcpkg/<sha512>?token=abc123.

Alternativ können Sie einen Dateisystemspeicherort als Endpunkt mithilfe des x-azurl,file://<filesystem-location>[,,<rw>] Musters verwenden.

Konfiguriert z. B x-azurl,file:///Z:/vcpkg/assetcache/,,readwrite . einen Cache im Z:/ Netzwerkordner.

Der Workflow dieser Ressourcenquelle lautet:

  1. Versuch, aus der Spiegelung zu lesen
  2. (Wenn Schritt 1 fehlgeschlagen ist) Lesen aus der ursprünglichen URL
  3. (Wenn Schritt 2 erfolgreich war) Zurückschreiben in den Spiegel

Sie können die Schritte 1 und 3 über den <rw> Bezeichner aktivieren/deaktivieren, und Sie können Schritt 2 über x-block-origin unten deaktivieren.

Weitere Informationen zum Einrichten einer x-azurl Quelle finden Sie in der Dokumentation zur binären Zwischenspeicherung für Azure Blob Storage.

x-block-origin

Syntax: x-block-origin

Deaktiviert das Zurückfallen auf die ursprüngliche Download-URL, wenn eine Ressource in keiner der konfigurierten Quellen gefunden wird.

x-script

Syntax: x-script,<template>

Verteilt an ein externes Tool, um die Ressource abzurufen.

<template>: Erforderlich. Eine Befehlsvorlage, die vcpkg ausführt, um eine Ressource zu erwerben. Beispiel: x-script,curl -L {url} --output {dst} konfiguriert vcpkg so, dass es ausgeführt curl und die {url} Parameter bereitstellt {dst} .

Die Logik zum Wiederherstellen und Hochladen von Ressourcen und zum Herstellen einer Verbindung mit dem Cachespeicherendpunkt ist verantwortlich für den Befehl, der in der Vorlage bereitgestellt wird.

vcpkg ersetzt diese Argumente beim Ausführen des Befehls:

  • {url}: die ursprüngliche Download-URL für das Objekt.
  • {sha512}: die erwartete SHA512 der heruntergeladenen Ressource.
  • {dst}: der Speicherort, an dem die heruntergeladene Ressource erwartet wird.

Der Vorlagenbefehl wird in der Buildumgebung von vcpkg ausgeführt. Dies bedeutet, dass einige Umgebungsvariablen wie PATH das Triplet geändert werden können.

Nächster Schritt