閱讀英文

共用方式為


資產快取設定

來源

參數 <rw> 是選擇性的,而且大部分來源都常見於下面所述的來源。 它會控制特定來源的訪問許可權,並接受 、或 readwritereadwrite(預設值為 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 ,可能會由三元組修改。

後續步驟