Varlık önbelleğe alma yapılandırması

  • Makale

Kaynaklar

<rw> parametresi isteğe bağlıdır ve aşağıda açıklanan çoğu kaynak için ortaktır. Belirli bir kaynak için erişim izinlerini denetler ve , writeveya readwrite değerlerini readkabul eder (varsayılan olarak readolur).

Kaynak dizelerin içindeki karakterlerden kurtulmak için bir ters köşe (') kullanın.

clear

Söz dizimi: clear

Yapılandırma dizesindeki önceki tüm kaynakları kaldırır. Ortam değişkeninden X_VCPKG_ASSET_SOURCES gelen tüm varlık önbelleğe alma kaynaklarını devre dışı bırakmak için parametresiyle --x-asset-sources birlikte kullanışlıdır.

Azure Blob Depolama (x-azurl)

Söz dizimi:

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

<url>:Gerekli. Azure Blob Depolama bağlantı URL'si. Kapsayıcı yolunu ve sondaki /bir öğesini içermelidir.

<sas>:Opsiyonel. Paylaşılan Erişim İmzası doğrulamasını kullanan uç noktalar için, oluşturulan SAS'yi sağlamak için bu parametreyi kullanın.

Azure dışı uç noktalar bu parametreyi kullanarak bir erişim belirteci sağlayabilir. Formun <url>/<sha512>?<sas>GET ve PUT isteklerine yanıt verebildiği sürece.

Örneğin, şu şekilde yapılandırılan bir kaynak: azurl,https://mydomain.com/vcpkg/,token=abc123,readwrite, biçiminde bir istek oluşturur: https://mydomain.com/vcpkg/<sha512>?token=abc123.

Alternatif olarak, deseni kullanarak x-azurl,file://<filesystem-location>[,,<rw>] uç nokta olarak bir dosya sistemi konumu kullanabilirsiniz.

Örneğin, x-azurl,file:///Z:/vcpkg/assetcache/,,readwrite ağ klasöründe bir önbellek Z:/ yapılandırır.

Bu varlık kaynağının iş akışı:

  1. Yansıtmadan okumayı deneme
  2. (1. adım başarısız olduysa) Özgün URL'den okuma
  3. (2. adım başarılı olduysa) Aynaya geri yazma

Tanımlayıcı aracılığıyla <rw> 1. ve 3. adımları etkinleştirebilir/devre dışı bırakabilir ve aşağıdaki aracılığıyla 2 x-block-origin . adımı devre dışı bırakabilirsiniz.

Kaynak ayarlama x-azurl hakkında daha fazla bilgi için Azure Blob Depolama için ikili önbelleğe alma belgelerine de bakın.

x-block-origin

Söz dizimi: x-block-origin

Yapılandırılmış kaynakların hiçbirinde bir varlık bulunamadığında özgün indirme URL'sine geri dönmeyi devre dışı bırakır.

x-script

Söz dizimi: x-script,<template>

Varlığı getirmek için bir dış aralığa gönderilir.

<template>:Gerekli. Vcpkg'nin bir varlık almak için yürüttüğü komut şablonu. Örneğin: x-script,curl -L {url} --output {dst} ve parametrelerini yürütmek curl ve sağlamak {url} {dst} için vcpkg yapılandırılır.

Varlıkları geri yükleme ve karşıya yükleme ve önbellek depolama uç noktasına bağlanma mantığı, şablonda sağlanan komutun sorumluluğundadır.

vcpkg, komutu yürütürken bu bağımsız değişkenlerin yerini alır:

  • {url}: varlığın özgün indirme URL'si.
  • {sha512}: indirilen varlığın beklenen SHA512 değeridir.
  • {dst}: indirilen varlığın beklendiği konum.

şablon komutu vcpkg'nin derleme ortamında çalıştırılır; bu, gibi PATH bazı ortam değişkenlerinin üçlü tarafından değiştirilebileceği anlamına gelir.

Sonraki adım

NuGet için varlık önbelleğe alma kaynağı olarak özel betik kullanma