Leggere in inglese

Condividi tramite


Configurazione della memorizzazione nella cache degli asset

Origini

Il <rw> parametro è facoltativo e comune alla maggior parte delle origini descritte di seguito. Controlla le autorizzazioni di accesso per l'origine specifica e accetta i valori read, writeo readwrite (per impostazione predefinita è read).

Utilizzare un backtick (') per eseguire l'escape dei caratteri all'interno delle stringhe di origine.

clear

Sintassi: clear

Rimuove tutte le origini precedenti nella stringa di configurazione. Utile in combinazione con il --x-asset-sources parametro per disabilitare tutte le origini di memorizzazione nella cache degli asset provenienti dalla X_VCPKG_ASSET_SOURCES variabile di ambiente.

Archiviazione BLOB di Azure (x-azurl)

Sintassi:

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

<url>: richiesto. URL di connessione Archiviazione BLOB di Azure. Deve includere il percorso del contenitore e un oggetto finale /.

<sas>: facoltativo. Per gli endpoint che usano la convalida della firma di accesso condiviso, usare questo parametro per fornire la firma di accesso condiviso generata.

Gli endpoint non Azure possono fornire un token di accesso usando questo parametro. Finché possono rispondere alle richieste GET e PUT del modulo <url>/<sha512>?<sas>.

Ad esempio, un'origine configurata come segue: azurl,https://mydomain.com/vcpkg/,token=abc123,readwrite, produce una richiesta nel formato : https://mydomain.com/vcpkg/<sha512>?token=abc123.

In alternativa, è possibile usare un percorso del file system come endpoint usando il x-azurl,file://<filesystem-location>[,,<rw>] modello .

Ad esempio, x-azurl,file:///Z:/vcpkg/assetcache/,,readwrite configura una cache nella Z:/ cartella di rete.

Il flusso di lavoro di questa origine asset è:

  1. Tentativo di lettura dal mirror
  2. (Se il passaggio 1 non è riuscito) Leggere dall'URL originale
  3. (Se il passaggio 2 ha avuto esito positivo) Eseguire il writeback nel mirror

È possibile abilitare/disabilitare i passaggi 1 e 3 tramite l'identificatore e disabilitare il <rw> passaggio 2 tramite x-block-origin di seguito.

Per altre informazioni su come configurare un'originex-azurl, vedere anche la documentazione sulla memorizzazione nella cache binaria per Archiviazione BLOB di Azure.

x-block-origin

Sintassi: x-block-origin

Disabilita il fallback all'URL di download originale quando un asset non viene trovato in nessuna delle origini configurate.

x-script

Sintassi: x-script,<template>

Invia a uno strumento esterno per recuperare l'asset.

<template>: richiesto. Modello di comando eseguito da vcpkg per acquisire un asset. Ad esempio: x-script,curl -L {url} --output {dst} configura vcpkg per l'esecuzione curl e fornire i {url} parametri e {dst} .

La logica per ripristinare e caricare gli asset e per connettersi all'endpoint di archiviazione della cache è responsabilità del comando fornito all'interno del modello.

vcpkg sostituirà questi argomenti durante l'esecuzione del comando:

  • {url}: l'URL di download originale per l'asset.
  • {sha512}: previsto SHA512 dell'asset scaricato.
  • {dst}: percorso in cui è previsto l'asset scaricato.

Il comando modello viene eseguito nell'ambiente di compilazione di vcpkg; ciò significa che alcune variabili di ambiente come PATH possono essere modificate dal tripletto.

Passaggio successivo