CIパイプラインの高速化|キャッシュと並列化で待ちを減らす

CIパイプラインの高速化|キャッシュと並列化で待ちを減らす

CI は、変更を統合するたびにビルドとテストを回し、その結果を見てから次の作業に進む仕組みです。

結果が返るまでの時間が延びると、開発者はテストを回す回数そのものを減らし始めます。

遅くなったパイプラインを速くする手は、毎回同じものを取り直さないキャッシュ、待たなくてよいものを同時に走らせる並列化、走らせなくてよいものを走らせない変更検知の 3 つに分けると見通しがよくなります。

私も DevOps を学んでいる途中なので、GitHub Actions と GitLab CI の公式ドキュメント、DORA の解説をもとに整理し、npm の依存キャッシュの効き目は手元で測りました。

CI そのものの定義と、10 分のビルドという目安の出どころは、先に次の記事でまとめています。

継続的インテグレーション(CI)入門|壊れたらすぐ気づく

遅いCIは統合の回数を減らす

速くする理由を先に押さえておくと、どこまで速くすればよいかも決めやすくなります。

DORA の Continuous integration の解説は、コミットごとにビルドを走らせ、自動テストが数分でフィードバックを返すことを CI の要素に挙げています。

テストに時間が掛かると開発者はテストを頻繁に回さなくなり、失敗したときに原因の候補となる変更が増える、というのがその理由です。

同じ解説では、テストにかける時間は数分、上限はおよそ 10 分とされていました。

それを超えたときの手当てとして挙がっているのは、テストの効率を上げる、計算資源を足して並列に回す、時間の掛かるテストを別のビルドへ分ける、の 3 つです。

参考: Continuous integration – DORA

GitLab の Pipeline efficiency のページは、遅さを見つける手がかりとして、ジョブ・ステージ・パイプライン全体の実行時間を最初に挙げています。

全体の所要時間には、リポジトリの大きさ、ジョブとステージの数、ジョブ同士の依存、依存でつながった一番長い経路であるクリティカルパスが効くと書かれています。

速くする作業は、どのジョブのどの手順で時間を使っているかを、実行時間の記録から確かめるところから始まります。

参考: Pipeline efficiency – GitLab Docs

依存キャッシュで毎回のダウンロードを省く

依存パッケージの取得は、キャッシュが無ければジョブのたびにくり返される手順です。

GitLab のドキュメントも、依存があまり変わらないならキャッシュでパイプラインの実行をかなり速くできるとしています。

キーはロックファイルのハッシュから作る

GitHub Actions の actions/cache は、key と完全に一致するキャッシュがあればそれを復元します。

一致が無ければ、ジョブが成功したときに path の中身を新しいキャッシュとして保存する仕組みです。

既存のキャッシュの中身は書き換えられないので、中身を変えたいときは新しい key で作り直します。

そこで key には、hashFiles でロックファイルのハッシュを入れる書き方が使われます。

依存が変わればハッシュが変わり、新しいキャッシュが自動で作られるからです。

完全一致が無いときは restore-keys に書いた接頭辞で前方一致を探し、一致したもののうち一番新しいキャッシュを復元します。

# 略(checkout などの前の手順)
      - uses: actions/cache@v6
        id: cache-npm
        with:
          path: ~/.npm
          key: ${{ runner.os }}-npm-${{ hashFiles('**/package-lock.json') }}
          restore-keys: |
            ${{ runner.os }}-npm-
      - run: npm ci

完全一致したかどうかは cache-hit という出力で分かるので、後の手順の条件にも使えます。

参考: Dependency caching reference – GitHub Docs

Dependency caching reference - GitHub Docs

setup-nodeのcache入力なら数行で済む

npm・Yarn・pnpm、pip、Gradle などには、言語ごとの setup 系のアクションにキャッシュの機能が組み込まれています。

actions/setup-node では cache に npm と書くだけで、ロックファイルのハッシュを key に含めたキャッシュが作られ、次の実行で復元されます。

jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v7
      - uses: actions/setup-node@v7
        with:
          node-version: 24
          cache: npm
      - run: npm ci
      - run: npm test

setup-node の README によると、キャッシュされるのは npm のグローバルなキャッシュで、node_modules ではありません。

v6 からは、package.json の packageManager などに npm が指定されていれば、cache を書かなくてもキャッシュが有効になります。

参考: actions/setup-node

GitHub - actions/setup-node: Set up your GitHub Actions workflow with a specific version of node.js

ここに挙げた YAML は公式の例をもとにした書式の提示で、GitHub Actions 上では実行していません。

アクションの版は、2026 年 10 月 26 日に各リポジトリのリリースで確かめた最新のメジャーにそろえています。

手元で測ったキャッシュの効き目

node_modules を保存しないなら、キャッシュで縮むのはどこまでかを手元で確かめました。

環境は Windows 11 の Node.js 24.20.0・npm 11.19.0 で、TypeScript・ESLint・Vitest・Prettier を入れる 127 パッケージのプロジェクトを使っています。

キャッシュなしは毎回空のフォルダを、キャッシュありは一度埋めたフォルダを –cache で指定し、npm ci を 3 回ずつ実行しました。

条件1 回目2 回目3 回目平均
キャッシュなし2.74 秒2.61 秒2.69 秒2.68 秒
キャッシュあり2.33 秒2.29 秒2.35 秒2.32 秒

縮んだのは平均で 0.36 秒で、全体の 1 割強でした。

npm ci は始める前に node_modules を消し、npm のキャッシュが持っているのは HTTP のリクエストで取ったデータなどです。

そのため、キャッシュがあっても node_modules を組み立て直す手間は毎回残ります。

–prefer-offline を足した実行も試しましたが、平均 2.38 秒で、はっきりした差は出ませんでした。

Next.js や AWS SDK を加えた 302 パッケージの構成でも 3 回ずつ測っています。

キャッシュなしが 24.7 秒・28.0 秒・64.3 秒、ありが 23.9 秒・23.4 秒・28.6 秒で、キャッシュの有無より回ごとのばらつきのほうが大きく出ました。

回線が速い環境では、キャッシュの効き目は 1 回の計測では見分けにくいので、前後を比べるときは何回か回して並べる必要があります。

GitHub がホストするランナーの上での効き目は測っていないので、実際のパイプラインではジョブのログに出る各手順の所要時間で確かめてください。

届く範囲と消える条件を知っておく

GitHub Actions のキャッシュは、実行したブランチと既定のブランチで作られたものを復元できます。

プルリクエストで起動した実行なら、ベースブランチのキャッシュも使えます。

一方で、プルリクエストの実行が作ったキャッシュはマージ用の参照に紐づくので、同じプルリクエストの再実行からしか復元できません。

既定のブランチへの push でキャッシュを作る実行があれば、各ブランチの最初の実行もそこから始められます。

7 日以上アクセスされなかったキャッシュは削除され、合計の上限は既定でリポジトリごとに 10 GB です。

上限に達すると、最後にアクセスされた日が古いものから消されていきます。

GitLab のドキュメントは、キャッシュは最適化であって、いつも効くとは限らないと書いています。

キャッシュが無くても通るジョブにしておき、復元できたら速くなる、という扱いにとどめておくと安心です。

GitLab は、ネットから取ってくる依存パッケージにはキャッシュ、ステージの間でビルドの途中結果を渡すにはアーティファクト、という使い分けも示しています。

参考: Caching in GitLab CI/CD

Docker のイメージをビルドするジョブでは、Dockerfile の命令の並べ方がそのままキャッシュの効き方を決めます。

その順番の考え方は、次の記事で手元のビルドと一緒に確かめました。

Dockerfileの書き方|小さく作り直しやすいイメージへ

並列化で待ち時間を重ねない

キャッシュで 1 つひとつの手順を短くしたら、次は手順同士の待ち合わせを減らします。

GitHub Actions のワークフローに書いたジョブは、既定で並列に走る決まりです。

順番に走らせたいときだけ needs で依存を書き、needs に挙げたジョブが失敗するかスキップされると、それを待つジョブもスキップされます。

lint と単体テストのように互いの結果を使わないジョブは、needs でつながずに並べておくと、全体の時間は長いほうのジョブで決まるようになります。

jobs:
  lint:
    runs-on: ubuntu-latest
    steps:
      # 略(checkout・setup-node・npm ci)
      - run: npm run lint
  test:
    runs-on: ubuntu-latest
    strategy:
      matrix:
        node: [22, 24]
    steps:
      # 略(node-version に matrix.node を渡す)
      - run: npm test
  deploy:
    needs: [lint, test]
    # 略

matrix は変数の組み合わせごとにジョブを作る仕組みで、1 回の実行で作れるのは 256 ジョブまでです。

既定ではランナーの空きに応じてできるだけ多くを並列に走らせ、同時に走る数を抑えたいときは max-parallel で上限を決めます。

fail-fast は既定で true になっていて、matrix のどれかが失敗すると、実行中と待機中の残りのジョブがキャンセルされます。

どの組み合わせで落ちるかを全部見たいときは false にします。

参考: Running variations of jobs in a workflow – GitHub Docs

Running variations of jobs in a workflow - GitHub Docs

GitLab CIはneedsでステージの待ち合わせを外す

GitLab CI の基本の構成では、ジョブは前のステージのジョブがすべて終わるのを待ってから走ります。

needs を書くと必要なジョブだけを待つ形になり、多くの場合は速くなりますが、パイプラインの見通しは悪くなると Pipeline efficiency のページに書かれていました。

同じページは、構文や書式の lint のように速く終わって失敗しやすいジョブを早い段に置き、失敗を早く返す並べ方も勧めています。

1 つのジョブを分けて並列に回すときは、parallel に 1〜200 の数を書くと、その数だけ同じジョブが作られます。

各ジョブには CI_NODE_INDEX と CI_NODE_TOTAL という変数が入るので、テストランナーの分割の機能に渡して、テストを分けて受け持たせられます。

lint:
  stage: test
  script: npm run lint

unit-test:
  stage: test
  parallel: 4
  script:
    - npm ci
    - npx vitest run --shard=$CI_NODE_INDEX/$CI_NODE_TOTAL

この YAML も GitLab 上では実行していない書式の提示です。

分割の部分だけは手元の Vitest 4.0.8 で確かめ、4 つのテストファイルに –shard=1/2 と –shard=2/2 を付けると、2 ファイルずつに分かれて実行されました。

参考: Vitest の Improving Performance

Vitest

並列にした数だけランナーが要り、足りなければ余ったジョブは pending のまま待つことも、GitLab の parallel の説明に書かれています。

変更検知で走らせるジョブを絞る

変更と関係のないジョブを走らせないことも、待ち時間を減らす手の 1 つです。

GitHub Actions では、push と pull_request のイベントに paths か paths-ignore を書くと、変わったファイルがパターンに合うときだけワークフローが起動します。

ただし、この絞り込みはワークフロー単位で、ジョブやステップ単位では効きません。

ジョブ単位で分けたいときは、dorny/paths-filter のような変更検知のアクションで判定し、その結果を後続のジョブの if に渡します。

jobs:
  changes:
    runs-on: ubuntu-latest
    permissions:
      pull-requests: read
    outputs:
      web: ${{ steps.filter.outputs.web }}
    steps:
      - uses: dorny/paths-filter@v4
        id: filter
        with:
          filters: |
            web:
              - 'web/**'
  web-test:
    needs: changes
    if: ${{ needs.changes.outputs.web == 'true' }}
    # 略

この形は README のプルリクエスト向けの例をもとにしていて、push で使うときは先にリポジトリの checkout が要ります。

参考: dorny/paths-filter

GitHub - dorny/paths-filter: Conditionally run actions based on files modified by PR, feature branch or pushed commits

GitLab CI では rules:changes を書くと、指定したファイルが変わったときだけジョブがパイプラインに加わります。

新しいブランチのパイプラインや、タグ・スケジュールのように push を伴わないパイプラインでは rules:changes が常に真になり、ジョブは毎回走ります。

同じブランチへ続けて push したときは、古い実行を止めるのも無駄を減らす手です。

GitHub Actions の concurrency に cancel-in-progress: true を付けると、同じグループで実行中のものもキャンセルされます。

GitLab では interruptible を使うと、新しいパイプラインに置き換えられた古いパイプラインを止められます。

参考: Control the concurrency of workflows and jobs – GitHub Docs、CI/CD YAML syntax reference – GitLab Docs

速くするほど増える落とし穴

キャッシュも並列化も変更検知も、走らせる量を減らす仕組みなので、減らしてはいけないものまで減らしていないかを確かめる必要があります。

スキップがマージの判定を変える

paths や paths-ignore でワークフローごとスキップされると、そのワークフローに紐づくチェックは Pending のまま残り、必須のチェックならマージを止めてしまいます。

GitHub のドキュメントは、スキップされうるワークフローを必須にしないよう勧めています。

逆に、ジョブの if でスキップされたジョブは Success として扱われる決まりです。

必須にしたジョブが needs で失敗したジョブを待っていると、そのジョブはスキップされ、マージを止めないことがあります。

必須のチェックを needs でつなぐときは、always() と組み合わせてジョブ自体は必ず走るようにする、というのがドキュメントの示す直し方です。

参考: Troubleshooting required status checks – GitHub Docs

Troubleshooting required status checks - GitHub Docs

paths による絞り込みには上限もあり、1 回の push が 1,000 コミットを超えると、ワークフローは必ず実行されます。

差分が 3,000 ファイルを超え、パターンに合うファイルが先頭の 3,000 件に入っていないときは、逆に実行されません。

キャンセルと変更検知が重なると変更が判定されない

concurrency は、同じグループに待機中の実行があると、既定でそれをキャンセルして新しい実行に置き換えます。

一方で、GitHub Actions の paths も dorny/paths-filter も、既定のブランチへの push では、その push の前のコミットとの差分で判定します。

キャンセルされた実行が運ぶはずだった変更は、次の実行の差分に入らず、どのジョブにも判定されないまま本番に出ないことがあります。

この組み合わせで起きる取りこぼしと、差分の起点を最後に成功した実行に変える直し方は、別の記事で書きました。

paths-filterの取りこぼし|差分の起点は前回の成功

キャッシュに秘密を入れない

キャッシュの中身には署名も検証もなく、リポジトリを読めて、プルリクエストを作れる人なら、ベースブランチのキャッシュの中身を読めます。

アクセストークンや認証情報を、キャッシュの path に置かないよう GitHub のドキュメントは注意しています。

信頼の低いイベントで動く実行が細工したキャッシュを、後で権限の強い実行が復元してしまう攻撃は、キャッシュポイズニングと呼ばれます。

その対策として、既定のブランチのキャッシュを作ったり上書きしたりできるのは、push や workflow_dispatch などの決まったイベントで起動した実行だけです。

pull_request_target や issue_comment のようなイベントの実行は、既定では読み取りしかできません。

cache-mode で書き込みを明示すればこの制限は外せますが、ドキュメントは外す前に、より狭い対策で足りないかを考えるよう求めています。

最後に

CI を速くする手は、依存キャッシュで取り直さない、並列化で待たない、変更検知で走らせない、の 3 つに分けられます。

ただ、依存キャッシュは node_modules の組み立てまでは省かず、手元の計測でも縮んだのは 1 割強でした。

並列化はランナーの数に、変更検知はスキップとキャンセルの扱いに、それぞれ注意が要ります。

DORA の言う 10 分を目安に、まず実行時間を測り、長い手順から順に手を入れると、効かない手に時間を使わずに済みます。

以上です。

コメントを残す

メールアドレスが公開されることはありません。 ※ が付いている欄は必須項目です

CAPTCHA