チュートリアル: GitHub Actions Cache を使用して vcpkg バイナリ キャッシュを設定する
Note
このセクションでは、いつでも変更または削除できる vcpkg の試験的な機能について説明します。
vcpkg では、GitHub Actions ワークフローのコンテキストで実行する場合に、バイナリ キャッシュ ストレージとして GitHub Actions キャッシュを使用できます。 バイナリ パッケージを外部 NuGet フィードにアップロードする場合は、GitHub Actions ワークフローでバイナリ キャッシュを使用することをお勧めします。 それ以外の 場合は、GitHub Actions ワークフローで GitHub パッケージを使用するためのチュートリアルをお読みください。
このチュートリアルで学習する内容は次のとおりです。
前提条件
- コード エディター
- GitHub Actions を使用した GitHub リポジトリ
- vcpkg を使用するプロジェクト
1 - 必要な GitHub Actions 環境変数をエクスポートする
vcpkg では、アクション キャッシュ URL とランタイム トークンを、ワークフローで使用できる環境変数としてエクスポートする必要があります。 ワークフロー ファイルに次の手順をコピーします。
- name: Export GitHub Actions cache environment variables
uses: actions/github-script@v7
with:
script: |
core.exportVariable('ACTIONS_CACHE_URL', process.env.ACTIONS_CACHE_URL || '');
core.exportVariable('ACTIONS_RUNTIME_TOKEN', process.env.ACTIONS_RUNTIME_TOKEN || '');
2 - GitHub Actions キャッシュを使用するように vcpkg を構成する
次に、次のように値を VCPKG_BINARY_SOURCES
設定します。
env:
VCPKG_BINARY_SOURCES: "clear;x-gha,readwrite"
以上で作業は終了です。 vcpkg は GitHub Actions キャッシュからパッケージをアップロードまたは復元するようになりました。
次のステップ
次に試すその他のタスクを次に示します。
GitHub で Microsoft と共同作業する
このコンテンツのソースは GitHub にあります。そこで、issue や pull request を作成および確認することもできます。 詳細については、共同作成者ガイドを参照してください。
vcpkg