資產快取參考

  • 發行項

來源

參數 <rw> 是選擇性的，而且大部分來源都常見於下面所述的來源。 它會控制特定來源的訪問許可權，並接受 、或 readwrite 值 readwrite（預設值為 read）。

使用反引號 （'） 逸出來源字串內的字元。

clear

語法： clear

拿掉組態字串中的所有先前來源。 與 --x-asset-sources 參數搭配使用，可停用來自 X_VCPKG_ASSET_SOURCES 環境變數的所有資產快取來源。

Azure Blob 儲存體 （x-azurl）

語法：

  1. x-azurl,<url>[,<sas>[,<rw>]]
  2. 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. 嘗試從鏡像讀取
  2. （如果步驟 1 失敗）從原始 URL 讀取
  3. （如果步驟 2 成功）回寫至鏡像

您可以透過 <rw> 規範啟用/停用步驟 1 和 3，也可以透過 x-block-origin 下列方式停用步驟 2。

如需如何設定x-azurl來源的詳細資訊，請參閱 Azure Blob 儲存體 的二進位快取檔。

x-block-origin

語法： x-block-origin

當任何設定的來源中找不到資產時，停用回復至原始下載 URL。

x-script

語法： x-script,<template>

分派至外部工具以擷取資產。

<template>：必填。 vcpkg 執行以取得資產的命令範本。 例如： x-script,curl -L {url} --output {dst} 設定 vcpkg 來執行 curl 並提供 和 {url}{dst} 參數。

還原和上傳資產並連線到快取記憶體端點的邏輯，由範本內提供的命令負責。

vcpkg 會在執行命令時取代這些自變數：

  • {url}：資產的原始下載 URL。
  • {sha512}：所下載資產的預期SHA512。
  • {dst}：預期下載資產的位置。

範本命令是在 vcpkg 的組建環境中執行;這表示某些環境變數，例如 PATH ，可能會由三元組修改。

後續步驟

使用自定義腳本作為 NuGet 的資產快取來源