コンテンツへスキップ

GitHub Actions キャッシュキー生成ツール

パッケージマネージャーを選択すると、適切なパス、ロックファイルベースのキー、restore-keys によるフォールバックを含む actions/cache ステップが生成されます。インストールを高速に保ち、キャッシュが古くなることを防ぎます。

既存のキャッシュをすべて無効化するには値を上げます

Workflow step

- uses: actions/cache@v4
  with:
    path: |
      ~/.npm
    key: ${{ runner.os }}-npm-v1-${{ hashFiles('**/package-lock.json') }}
    restore-keys: |
      ${{ runner.os }}-npm-v1-

Exact key: ${{ runner.os }}-npm-v1-${{ hashFiles('**/package-lock.json') }}. Fallback prefix: ${{ runner.os }}-npm-v1-

すべての処理はお使いのブラウザー内で行われます。入力した内容が外部に送信されることはありません。

使い方

  1. パッケージマネージャーを選択してください。キャッシュパスとロックファイルのパターンが自動で入力されます。
  2. キーに OS と CPU アーキテクチャを含めるかどうかを決め、キャッシュを無効化するためのバージョンソルトを追加してください。
  3. インストールステップの前に、YAML をワークフローにコピーしてください。

よくある質問

良いキャッシュキーとは何ですか?

OS、ツール、ソルトを識別するプレフィックスと、ロックファイルのハッシュを組み合わせたものです。ロックファイルが変わるとキーも変わるため、新しいキャッシュが作成されます。

restore-keys は何のためにありますか?

完全一致するキャッシュがない場合、GitHub は restore key で始まるキーを持つ最新のキャッシュを復元します。これにより、インストールでは変更された部分のみを取得すれば済みます。

問題のあるキャッシュを無効化するにはどうすればよいですか?

キーのバージョンソルトを変更します(例:v1 から v2 へ)。古いエントリは、7 日間使用されないと期限切れになります。

キャッシュのサイズにはどの程度の上限がありますか?

リポジトリのキャッシュ容量は既定で合計 10 GB です。容量がいっぱいになると、最後に使用された時期が最も古いエントリから削除されます。

関連ガイド

この計算ツールをサイトに埋め込む

ブログやドキュメントへの埋め込みは無料です。表示させたい場所に次の HTML を貼り付けてください:

<iframe src="https://compiler.dev/embed/actions-cache-key-builder" title="GitHub Actions cache key builder" width="100%" height="560" style="border:1px solid #e5e7eb;border-radius:12px" loading="lazy"></iframe>
<p style="font-size:12px">Calculator by <a href="https://compiler.dev/tools/actions-cache-key-builder">compiler.dev</a></p>