GitHub Actionsの肥大化対策:ワークフロー分割とキャッシュ設計

当ページのリンクには広告が含まれています。
GitHub Actionsの肥大化対策:ワークフロー分割とキャッシュ設計
IT女子 アラ美IT女子 アラ美
🚀 CI/CD設計スキルで年収を上げなさい!
DevOps経験を活かしたキャリアアップでハイクラス転職を実現しなさい
自分らしく働けるエンジニア転職を目指すなら【strategy career】
この記事の結論
GitHub Actionsの肥大化はワークフロー分割・Reusable Workflows・キャッシュ最適化の3つで防げます。膨らんだci.ymlを分けてビルドを速くする進め方の例とともに、設計パターンを解説します。

お疲れ様です!IT業界で働くアライグマです!

「GitHub Actionsのワークフローが500行を超えて、もう誰もメンテできない」「CIが30分かかるせいで、PRのマージが渋滞している」。こうした悩みを抱えているチームは多いのではないでしょうか。

GitHub Actionsは手軽にCI/CDを構築できる反面、無計画に機能を追加すると急速に肥大化します。本記事では、ワークフローの肥大化を防ぎ、保守性と実行速度を両立する設計パターンを解説します。

目次

GitHub Actionsが肥大化する3つの原因

IT女子 アラ美IT女子 アラ美
💡 CI/CDの設計を独学で消耗してるの?体系的に学びなさい!
DevOps・インフラスキルを個人レッスンで習得できるわよ
資格と仕事に強い!個人レッスンのプログラミングスクール【Winスクール】

GitHub Actionsの肥大化は、ほとんどの場合以下の3つのパターンに集約されます。

原因1:1つのワークフローに全てを詰め込む

リント → テスト → ビルド → デプロイ → 通知を1つの .github/workflows/ci.yml に書くと、あっという間に300行を超えます。変更の影響範囲が把握できず、「触ると壊れそうだから誰も手を出さない」状態になります。

原因2:コピペの繰り返し

複数のワークフローで同じステップ(Nodeセットアップ、キャッシュ設定、Slack通知など)をコピペしていると、変更時に全ファイルを修正する必要があります。修正漏れがCI障害の原因になります。

原因3:キャッシュ未活用

npm install や pip install を毎回フルインストールしていると、依存関係の数に比例してビルド時間が伸びます。キャッシュを使えば数分の処理が数秒に短縮できます。

IT女子 アラ美IT女子 アラ美
500行のYAML、見た瞬間に閉じたくなるよね…。「これ誰が書いたの?」って聞いても全員が目をそらす。

ITアライグマITアライグマ
あるあるですね。「最初は30行だった」はずなのに、気づいたら500行になっている。CIのスパゲッティ化です。

設計パターン1:ワークフロー分割とReusable Workflows

肥大化を防ぐ最も効果的な方法は、ワークフローを責務ごとに分割することです。

分割の基本方針

  • lint.yml:コードスタイルチェック(ESLint, Ruff, etc.)
  • test.yml:ユニットテスト + インテグレーションテスト
  • build.yml:ビルド + アーティファクト生成
  • deploy.yml:デプロイ(main branch のみ)

Reusable Workflowsで共通処理を1箇所に

GitHub ActionsのReusable Workflowsを使えば、共通のステップを1つのファイルに集約し、他のワークフローから呼び出せます。

# .github/workflows/reusable-node-setup.yml
name: Node.js Setup
on:
  workflow_call:
    inputs:
      node-version:
        required: false
        type: string
        default: '20'

jobs:
  setup:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: ${{ inputs.node-version }}
          cache: 'npm'
      - run: npm ci

これを各ワークフローから uses: ./.github/workflows/reusable-node-setup.yml で呼び出します。Node.jsのバージョン変更が1箇所で済み、コピペ地獄から解放されます。

ワークフローを分けるときは、シークレットを使うジョブを、外部からのPRで動くジョブと分けておくと安全です。分け方はGitHub Actionsのシークレット管理とCI/CDセキュリティで解説しています。

Git運用の設計についてはソロ開発者のGitワークフローも参考にしてください。

IT女子 アラ美IT女子 アラ美
Reusable Workflows、名前は知ってたけど使ったことなかった。コピペ地獄の解決策がこれだったのね。

ITアライグマITアライグマ
導入コストはほぼゼロです。既存のワークフローから共通部分を切り出すだけで始められますよ。

設計パターン2:キャッシュ戦略とビルド高速化

ビルド時間の短縮は、開発者体験(DX)に直結します。

依存関係のキャッシュ

actions/cache を使って、node_modules や .venv をキャッシュします。

- uses: actions/cache@v4
  with:
    path: ~/.cache/pip
    key: ${{ runner.os }}-pip-${{ hashFiles('requirements.txt') }}
    restore-keys: |
      ${{ runner.os }}-pip-

変更ファイルに基づく条件実行

paths フィルターを使って、関連ファイルが変更された場合のみワークフローを実行します。

on:
  push:
    paths:
      - 'src/**'
      - 'tests/**'
      - 'package.json'

ドキュメントの修正やREADMEの更新でCIが走らなくなり、不要なビルドを減らせます。

IT女子 アラ美IT女子 アラ美
READMEの修正でCIが走るの、無駄だと分かってても放置してた。paths設定、今日やるわ。

ITアライグマITアライグマ
設定2行で済む改善です。月間のビルド時間が大幅に削減されて、コスト削減にもなりますよ。

1つに膨らんだci.ymlを分けてビルドを速くする進め方の例

IT女子 アラ美IT女子 アラ美
💡 DevOpsスキルがあるならフリーランスで稼ぎなさい!
CI/CD設計の経験があれば月収80万以上の案件が狙えるわよ
ITフリーランスエンジニアの案件探しなら【techadapt】

リント・テスト・ビルド・デプロイをすべて1つの ci.yml に書き、直列に実行しているリポジトリを例に、肥大化を解く順番を整理します。

よくある状態

  • ワークフロー構成:1つの ci.yml に全処理が書かれ、数百行に膨らんでいる
  • ビルド時間:すべての処理が直列に実行され、PRを出してからCIが終わるまで待たされる
  • 変更のしにくさ:どこを直すと何に影響するかわからず、YAMLを触るのが怖い

進める順番

  • ワークフロー分割:ci.yml を lint.yml / test.yml / build.yml / deploy.yml のように役割ごとに分けます
  • 並列実行:互いに依存しない lint と test を並列に動かします
  • キャッシュ導入:npm ci などの依存関係のインストールをキャッシュします
  • pathsフィルター:docs/ や README だけの変更では CI を動かさないように設定します
  • Reusable Workflows:Node.jsのセットアップ、Slack通知、AWS認証のような共通処理を切り出します

キャッシュだけを入れても、直列の構造が残っていると短くなる時間は限られます。先にワークフローの分割と並列実行を行い、構造を直してからキャッシュを足してください。

効果を確かめる

直す前と後で、CIの平均実行時間、月のビルド回数、YAMLの合計行数を比べます。GitHub Actionsの実行履歴から、ワークフローごとの所要時間を確かめられます。

IT女子 アラ美IT女子 アラ美
PRを出したあと、CIが終わるまでずっと待ってることあるわ。うちも同じ状況だわ…。

ITアライグマITアライグマ
CIの待ち時間は「見えないコスト」です。エンジニアの集中力が切れるのが一番の損失ですね。

さらなる実践・活用に向けて

GitHub Actionsの最適化を進めたら、次のステップとして以下を検討してみてください。

GitHub Actions以外の選択肢

プロジェクトの規模やセキュリティ要件によっては、CircleCI(並列実行が強力)やGitLab CI(オンプレ対応)、Dagger(ローカルで再現可能なCI)も検討対象です。

セルフホストランナーの活用

大規模プロジェクトでは、GitHub提供のランナーよりもセルフホストランナーの方がコスト効率が良い場合があります。特にGPUやカスタムハードウェアが必要なビルドでは必須です。

DevOpsスキルを活かしたキャリア設計についてはフリーランスエージェント5社比較も参考にしてください。CI/CD設計の経験はフリーランス市場でも高く評価されます。

IT女子 アラ美IT女子 アラ美
セルフホストランナーはコスト削減になるのね。でも管理コストとのトレードオフがありそう。

ITアライグマITアライグマ
月間のビルド時間が100時間を超えたら検討する価値があります。それまではGitHub提供ランナーで十分ですよ。

よくある質問

ワークフローを分割するとジョブ間のデータ共有はどうしますか?

actions/upload-artifact と actions/download-artifact を使えば、ジョブ間でビルド成果物やテスト結果を共有できます。アーティファクトのサイズ上限は500MBです。

Reusable Workflowsと Composite Actionsの違いは?

Reusable Workflowsはワークフロー全体を再利用する仕組みで、Composite Actionsはステップ単位で再利用する仕組みです。大きな処理の共通化にはReusable、小さなユーティリティにはCompositeが適しています。

GitHub Actionsの実行時間の上限は?

1ジョブあたり最大6時間、1ワークフローあたり最大35日です。Freeプランでは月間2,000分の実行時間制限があります。Proプランは3,000分、Teamプランは3,000分です。

自分のスキルを活かしてフリーランスとして独立したい方は、以下の4社を比較して最適なエージェントを見つけましょう。

比較項目 techadapt Midworks レバテックフリーランス IT求人ナビ
単価帯 月60〜120万円高単価特化 月50〜90万円中〜高単価 月60〜120万円Web系直請け中心 AI診断適正単価を自動提案
マージン ◎10〜20%公開 ◎10〜15%公開 ◯非公開・案件ごと ◯案件ごと
保障・福利厚生 限定的案件品質で勝負 正社員並み社保・交通費・研修 基本的健診・税務サポート 相談サポートチャット・オンライン
対応エリア 首都圏東京・神奈川中心 首都圏+関西大阪・名古屋 首都圏中心+リモート主要都市対応 全国対応リモートあり
おすすめ度 S経験3年以上 S独立初期 SWeb系経験者 B+初心者向け
公式サイト 案件を探す 案件を探す 案件を探す AI診断する
IT女子 アラ美IT女子 アラ美
4社あると逆に迷っちゃう…結局どこに登録すればいいの?
ITアライグマITアライグマ
首都圏高単価ならtechadapt、Web系の直請けならレバテックフリーランス、独立初期で保障も欲しいならMidworksから2〜3社に登録して比較するのがおすすめです。保障重視ならMidworksを軸にすると安心ですよ。

まとめ

GitHub Actionsの肥大化を防ぐための設計パターンを解説しました。

  • ワークフロー分割:責務ごとにファイルを分け、1ファイル100行以下を維持する
  • Reusable Workflows:共通処理を切り出してコピペ地獄を解消する
  • キャッシュ+pathsフィルター:依存関係のインストールと不要なビルドを減らしてビルド時間を短くする
  • 段階的に改善:まずpathsフィルターとキャッシュから。効果を確認しながら分割に進む

「CIが遅い」「ワークフローが長すぎる」と感じたら、まずpathsフィルターとキャッシュを設定してみてください。数分の設定で効果が実感できるはずです。

IT女子 アラ美IT女子 アラ美
まずpathsフィルターとキャッシュの2つから試してみるわ。設定だけで効果出るなら楽でいいね。

ITアライグマITアライグマ
その2つだけで「CIが半分の時間で終わる」体験ができます。その後の改善モチベーションにも繋がりますよ。

この記事をシェアする
  • URLをコピーしました!
  • URLをコピーしました!

この記事を書いた人

ITアライグマのアバター ITアライグマ ITエンジニア / PM

都内の事業会社で働くPM兼Webエンジニアです(IT業界10年以上、既婚・子持ち)。
スマホや決済アプリ、Wi-Fi、スマートスピーカーなど、身近なITの「困った」を、公式のヘルプやサポート情報で確かめたうえで、原因の切り分けから直し方までまとめています。設定で直らないときは、回線やサービスの見直しも含めて紹介しています。

目次