次の方法で共有

チュートリアル: GitHub Actions Cache を使用して vcpkg バイナリ キャッシュを設定する

注意事項

バイナリ キャッシュ用の GitHub Actions Cache バックエンドが削除されました。 このチュートリアルは維持されなくなりました。
詳細と移行のガイダンスについては、 GitHub Pull Request #1662 を参照してください。

注

このセクションでは、いつでも変更または削除できる 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 キャッシュからパッケージをアップロードまたは復元するようになりました。

次のステップ

プライベート NuGet フィードに対する認証

次に試すその他のタスクを次に示します。