英語で読む

次の方法で共有


資産キャッシュの構成

ソース

<rw> パラメーターは省略可能であり、以下で説明するほとんどのソースに共通です。 特定のソースのアクセス許可を制御し、 readwrite、または readwrite (既定値は read) の値を受け入れます。

バックティック (') を使用して、ソース文字列内の文字をエスケープします。

clear

構文: clear

構成文字列内の以前のソースをすべて削除します。 --x-asset-sources パラメーターと組み合わせて使用すると、X_VCPKG_ASSET_SOURCES環境変数からのすべての資産キャッシュ ソースを無効にすることができます。

Azure Blob Storage (x-azurl)

構文

  1. x-azurl,<url>[,<sas>[,<rw>]]
  2. 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. ミラーからの読み取りを試みる
  2. (手順 1 で失敗した場合)元の URL から読み取る
  3. (手順 2 が成功した場合)ミラーに書き戻す

<rw>指定子を使用して手順 1 と 3 を有効または無効にし、次のx-block-originを使用して手順 2 を無効にすることができます。

x-azurl ソースを設定する方法の詳細についてはAzure Blob Storage の binary キャッシュに関するドキュメントも参照してください。

x-block-origin

構文: x-block-origin

構成されているソースのいずれかで資産が見つからない場合に、元のダウンロード URL へのフォールバックを無効にします。

x-script

構文: x-script,<template>

外部ツールにディスパッチして資産をフェッチします。

<template>: 必須。 vcpkg が資産を取得するために実行するコマンド テンプレート。 たとえば、 x-script,curl -L {url} --output {dst} は、 curl を実行し、 {url} パラメーターと {dst} パラメーターを指定するように vcpkg を構成します。

資産を復元してアップロードし、キャッシュ ストレージ エンドポイントに接続するロジックは、テンプレート内で提供されるコマンドの役割を担います。

vcpkg は、コマンドの実行時にこれらの引数を置き換えます。

  • {url}: 資産の元のダウンロード URL。
  • {sha512}: ダウンロードした資産の SHA512 が必要です。
  • {dst}: ダウンロードした資産が必要な場所。

テンプレート コマンドは vcpkg のビルド環境内で実行されます。これは、 PATH のような一部の環境変数がトリプレットによって変更される可能性があることを意味します。

次のステップ