IT女子 アラ美お疲れ様です!IT業界で働くアライグマです!
「GitHub Actionsのワークフローが500行を超えて、もう誰もメンテできない」「CIが30分かかるせいで、PRのマージが渋滞している」。こうした悩みを抱えているチームは多いのではないでしょうか。
GitHub Actionsは手軽にCI/CDを構築できる反面、無計画に機能を追加すると急速に肥大化します。本記事では、ワークフローの肥大化を防ぎ、保守性と実行速度を両立する設計パターンを解説します。
GitHub Actionsが肥大化する3つの原因
IT女子 アラ美GitHub Actionsの肥大化は、ほとんどの場合以下の3つのパターンに集約されます。
原因1:1つのワークフローに全てを詰め込む
リント → テスト → ビルド → デプロイ → 通知を1つの .github/workflows/ci.yml に書くと、あっという間に300行を超えます。変更の影響範囲が把握できず、「触ると壊れそうだから誰も手を出さない」状態になります。
原因2:コピペの繰り返し
複数のワークフローで同じステップ(Nodeセットアップ、キャッシュ設定、Slack通知など)をコピペしていると、変更時に全ファイルを修正する必要があります。修正漏れがCI障害の原因になります。
原因3:キャッシュ未活用
npm install や pip install を毎回フルインストールしていると、依存関係の数に比例してビルド時間が伸びます。キャッシュを使えば数分の処理が数秒に短縮できます。
IT女子 アラ美設計パターン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女子 アラ美設計パターン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女子 アラ美1つに膨らんだci.ymlを分けてビルドを速くする進め方の例
IT女子 アラ美リント・テスト・ビルド・デプロイをすべて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女子 アラ美さらなる実践・活用に向けて
GitHub Actionsの最適化を進めたら、次のステップとして以下を検討してみてください。
GitHub Actions以外の選択肢
プロジェクトの規模やセキュリティ要件によっては、CircleCI(並列実行が強力)やGitLab CI(オンプレ対応)、Dagger(ローカルで再現可能なCI)も検討対象です。
セルフホストランナーの活用
大規模プロジェクトでは、GitHub提供のランナーよりもセルフホストランナーの方がコスト効率が良い場合があります。特にGPUやカスタムハードウェアが必要なビルドでは必須です。
DevOpsスキルを活かしたキャリア設計についてはフリーランスエージェント5社比較も参考にしてください。CI/CD設計の経験はフリーランス市場でも高く評価されます。
IT女子 アラ美よくある質問
ワークフローを分割するとジョブ間のデータ共有はどうしますか?
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%公開 | 非公開・案件ごと | 案件ごと |
| 保障・福利厚生 | 限定的案件品質で勝負 | 正社員並み社保・交通費・研修 | 基本的健診・税務サポート | 相談サポートチャット・オンライン |
| 対応エリア | 首都圏東京・神奈川中心 | 首都圏+関西大阪・名古屋 | 首都圏中心+リモート主要都市対応 | 全国対応リモートあり |
| おすすめ度 | 経験3年以上 | 独立初期 | Web系経験者 | B+初心者向け |
| 公式サイト | 案件を探す | 案件を探す | 案件を探す | AI診断する |
IT女子 アラ美まとめ
GitHub Actionsの肥大化を防ぐための設計パターンを解説しました。
- ワークフロー分割:責務ごとにファイルを分け、1ファイル100行以下を維持する
- Reusable Workflows:共通処理を切り出してコピペ地獄を解消する
- キャッシュ+pathsフィルター:依存関係のインストールと不要なビルドを減らしてビルド時間を短くする
- 段階的に改善:まずpathsフィルターとキャッシュから。効果を確認しながら分割に進む
「CIが遅い」「ワークフローが長すぎる」と感じたら、まずpathsフィルターとキャッシュを設定してみてください。数分の設定で効果が実感できるはずです。
IT女子 アラ美