資産キャッシュのリファレンス
ソース
この <rw>
パラメーターは省略可能であり、以下で説明するほとんどのソースに共通です。 特定のソースのアクセス許可を制御し、値 read
(write
read
既定値readwrite
) を受け入れます。
バックティック (') を使用して、ソース文字列内の文字をエスケープします。
clear
構文: clear
構成文字列内の以前のソースをすべて削除します。 環境変数からのすべての資産キャッシュ ソースを無効にするパラメーターと --x-asset-sources
組み合わせて使用すると X_VCPKG_ASSET_SOURCES
便利です。
Azure Blob Storage (x-azurl
)
構文:
x-azurl,<url>[,<sas>[,<rw>]]
x-azurl,file://<network-location>[,,<rw>]
<url>
: 必須。 Azure Blob Storage 接続 URL。 コンテナー パスと末尾 /
のパスを含める必要があります。
<sas>
: オプション。 Shared Access Signature 検証を使用するエンドポイントの場合は、このパラメーターを使用して生成された 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 が成功した場合)ミラーに書き戻す
指定子を使用して手順 1 と 3 を <rw>
有効または無効にし、次の手順 2 を無効 x-block-origin
にすることができます。
ソースの設定方法x-azurl
の詳細については、Azure Blob Storage のバイナリ キャッシュに関するドキュメントも参照してください。
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
いくつかの環境変数がトリプレットによって変更される可能性があることを意味します。
次のステップ
vcpkg