資產快取設定
參數 <rw>
是選擇性的,而且大部分來源都常見於下面所述的來源。 它會控制特定來源的訪問許可權,並接受 、或 readwrite
值 read
write
(預設值為 read
)。
使用反引號 (') 逸出來源字串內的字元。
語法:clear
拿掉組態字串中的所有先前來源。 與 --x-asset-sources
參數搭配使用,可停用來自 X_VCPKG_ASSET_SOURCES
環境變數的所有資產快取來源。
語法:
x-azurl,<url>[,<sas>[,<rw>]]
x-azurl,file://<network-location>[,,<rw>]
<url>
:必填。 Azure Blob 儲存體 連線 URL。 它必須包含容器路徑和尾端 /
。
<sas>
: 選用。 對於使用共用存取簽章驗證的端點,請使用此參數來提供產生的SAS。
非 Azure 端點可以使用此參數來提供存取令牌。 只要它們可以響應表單 <url>/<sha512>?<sas>
的 GET 和 PUT 要求即可。
例如,依下列方式設定的來源: azurl,https://mydomain.com/vcpkg/,token=abc123,readwrite
,會以下列形式產生要求: https://mydomain.com/vcpkg/<sha512>?token=abc123
。
或者,您可以使用檔案系統位置作為端點,方法是使用 x-azurl,file://<filesystem-location>[,,<rw>]
模式。
例如, x-azurl,file:///Z:/vcpkg/assetcache/,,readwrite
在網路資料夾中設定快取 Z:/
。
此資產來源的工作流程為:
- 嘗試從鏡像讀取
- (如果步驟 1 失敗)從原始 URL 讀取
- (如果步驟 2 成功)回寫至鏡像
您可以透過 <rw>
規範啟用/停用步驟 1 和 3,也可以透過 x-block-origin
下列方式停用步驟 2。
如需如何設定x-azurl
來源的詳細資訊,請參閱 Azure Blob 儲存體 的二進位快取檔。
語法: x-block-origin
當任何設定的來源中找不到資產時,停用回復至原始下載 URL。
語法: x-script,<template>
分派至外部工具以擷取資產。
<template>
:必填。 vcpkg 執行以取得資產的命令範本。 例如: x-script,curl -L {url} --output {dst}
設定 vcpkg 來執行 curl
並提供 和 {url}
{dst}
參數。
還原和上傳資產並連線到快取記憶體端點的邏輯,由範本內提供的命令負責。
vcpkg 會在執行命令時取代這些自變數:
{url}
:資產的原始下載 URL。{sha512}
:所下載資產的預期SHA512。{dst}
:預期下載資產的位置。
範本命令是在 vcpkg 的組建環境中執行;這表示某些環境變數,例如 PATH
,可能會由三元組修改。