Share via


チュートリアル: 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 キャッシュからパッケージをアップロードまたは復元するようになりました。

次のステップ

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