資産キャッシュの構成
<rw>
パラメーターは省略可能であり、以下で説明するほとんどのソースに共通です。 特定のソースのアクセス許可を制御し、 read
、 write
、または readwrite
(既定値は read
) の値を受け入れます。
バックティック (') を使用して、ソース文字列内の文字をエスケープします。
構文: clear
構成文字列内の以前のソースをすべて削除します。 --x-asset-sources
パラメーターと組み合わせて使用すると、X_VCPKG_ASSET_SOURCES
環境変数からのすべての資産キャッシュ ソースを無効にすることができます。
構文:
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 が成功した場合)ミラーに書き戻す
<rw>
指定子を使用して手順 1 と 3 を有効または無効にし、次のx-block-origin
を使用して手順 2 を無効にすることができます。
x-azurl
ソースを設定する方法の詳細についてはAzure Blob Storage の binary キャッシュに関するドキュメントも参照してください。
構文: x-block-origin
構成されているソースのいずれかで資産が見つからない場合に、元のダウンロード URL へのフォールバックを無効にします。
構文: x-script,<template>
外部ツールにディスパッチして資産をフェッチします。
<template>
: 必須。 vcpkg が資産を取得するために実行するコマンド テンプレート。 たとえば、 x-script,curl -L {url} --output {dst}
は、 curl
を実行し、 {url}
パラメーターと {dst}
パラメーターを指定するように vcpkg を構成します。
資産を復元してアップロードし、キャッシュ ストレージ エンドポイントに接続するロジックは、テンプレート内で提供されるコマンドの役割を担います。
vcpkg は、コマンドの実行時にこれらの引数を置き換えます。
{url}
: 資産の元のダウンロード URL。{sha512}
: ダウンロードした資産の SHA512 が必要です。{dst}
: ダウンロードした資産が必要な場所。
テンプレート コマンドは vcpkg のビルド環境内で実行されます。これは、 PATH
のような一部の環境変数がトリプレットによって変更される可能性があることを意味します。
vcpkg に関するフィードバック
vcpkg はオープンソース プロジェクトです。 フィードバックを提供するにはリンクを選択します。