GitHub Actionsの実行速度を上げるキャッシュアクションの活用法

Thu, 20 Nov 2025 00:00:00 +0900

GitHub ActionsなどのCI/CDツールは、プルリクエストの作成時やメインブランチへのプッシュ時に自動的にテストやビルドを実行し、コードの安全性を担保してくれます。しかし、毎回「コンテナの起動」「外部依存パッケージ（node_modules など）のゼロからのダウンロード」「全ビルドプロセスの再実行」を繰り返していると、ジョブの実行時間は数分以上に膨れ上がります。

これにより、CIの完了待ち時間が長くなり、開発の流れが止まるほか、GitHub Actionsの利用料金（実行時間ベース）も増加してしまいます。

本記事では、GitHub公式のキャッシュアクションを活用し、CIパイプラインの実行速度を劇的に高速化させる設定方法を解説します。

1. キャッシュの仕組みと方針

GitHub Actionsにおけるキャッシュとは、**「あるワークフロー実行時にダウンロード・生成したファイルをGitHub側のストレージに保存し、次回実行時にそれをリストアして再利用する」**仕組みです。

特に時間のかかる以下の処理に対してキャッシュが効果的です。

npm, yarn, pnpm などの依存パッケージ（~/.npm フォルダ）
Next.js や Nuxt.js などのフレームワークのビルドキャッシュ（.next/cache フォルダ）
各種コンパイラ（Go、Rust等）のビルド中間ファイル

2. Node.js (npm / yarn) での簡単な設定方法

最も手軽に導入できるのが、GitHub公式の actions/setup-node アクションに内蔵されているキャッシュ機能です。現在はこのワンライナー指定がベストプラクティスとなっています。

npmプロジェクトでのワークフロー設定例（`.github/workflows/ci.yml`）：

name: CI

on: [push, pull_request]

jobs:
 build:
 runs-on: ubuntu-latest

 steps:
 - name: Checkout repository
 uses: actions/checkout@v4

 - name: Set up Node.js
 uses: actions/setup-node@v4
 with:
 node-version: 20
 # キャッシュ対象として npm を指定
 cache: 'npm'

 # package-lock.jsonのハッシュをもとにキャッシュが判定され、
 # 変更がなければダウンロード済みのグローバルキャッシュから一瞬で復元されます。
 - name: Install dependencies
 run: npm ci

 - name: Run test
 run: npm test

cache: 'yarn' や cache: 'pnpm' を指定するだけで、それぞれのパッケージマネージャーに合わせた最適化キャッシュが自動で適用されます。

Ci-Cd on 技術・ゲーム・分かりやすく

GitHub Actionsの実行速度を上げるキャッシュアクションの活用法

1. キャッシュの仕組みと方針

2. Node.js (npm / yarn) での簡単な設定方法

npmプロジェクトでのワークフロー設定例（.github/workflows/ci.yml）：

npmプロジェクトでのワークフロー設定例（`.github/workflows/ci.yml`）：