GitHub Actions で CI/CD パイプラインの実行時間を50%削減する最適化テクニック

本記事では、GitHub Actions を使用した CI/CD パイプラインの実行時間を大幅に短縮するための実践的な最適化手法を解説します。キャッシング戦略、並列処理、ワークフロー設計の改善により、ビルドとデプロイの効率を劇的に向上させられます。

GitHub Actions のパイプライン最適化が必須である理由

実務では、CI/CD パイプラインの実行時間はチーム生産性に直結します。筆者の経験上、10分のビルド時間は1日50回のデプロイ試行で8時間以上のロスになります。さらに、GitHub Actions は無料枠が毎月2,000分に制限されているため、最適化によるコスト削減効果も見逃せません。

特にマイクロサービスアーキテクチャや大規模プロジェクトでは、パイプラインの効率化が直接的にリリースサイクルの短縮につながるため、戦略的な最適化が重要です。

GitHub Actions パイプラインの最適化戦略

1. actions/cache を活用した依存関係のキャッシング

最も効果的な最適化は、毎回ダウンロードされる依存関係をキャッシュすることです。npm、pip、Maven などのパッケージマネージャーは、デフォルトでは実行のたびに依存関係をすべてダウンロードします。これを回避することで、ビルド時間を30～60%削減できます。

以下は Node.js プロジェクトの場合の実装例です：

name: Build with Caching
on:
  push:
    branches: [main, develop]
  pull_request:
    branches: [main]

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4

      # npm キャッシュを設定（package-lock.json のハッシュをキーに使用）
      - uses: actions/setup-node@v4
        with:
          node-version: '20'
          cache: 'npm'

      # 依存関係のインストール（キャッシュがあれば即座に完了）
      - run: npm ci

      # ビルドと テスト
      - run: npm run build
      - run: npm test

ここで重要なのは npm install ではなく npm ci (Clean Install) を使用する点です。CI/CD 環境では npm ci のほうが確実で高速です。

2. 複数ジョブの並列実行による高速化

テスト、ビルド、リント などの独立したタスクを順序ではなく並列実行することで、パイプライン全体の実行時間を削減できます。

name: Parallel CI Pipeline
on: [push, pull_request]

jobs:
  lint:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: '20'
          cache: 'npm'
      - run: npm ci
      - run: npm run lint
      - run: npm run type-check

  test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: '20'
          cache: 'npm'
      - run: npm ci
      - run: npm test -- --coverage

  build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: '20'
          cache: 'npm'
      - run: npm ci
      - run: npm run build

  # すべてのジョブの完了を待つゲートジョブ
  all-passed:
    if: always()
    needs: [lint, test, build]
    runs-on: ubuntu-latest
    steps:
      - run: |
          if [ "${{ needs.lint.result }}" == "failure" ] || \
             [ "${{ needs.test.result }}" == "failure" ] || \
             [ "${{ needs.build.result }}" == "failure" ]; then
            exit 1
          fi

実務では、並列実行により従来の直列実行比で 40～50% の時間短縮が期待できます。

flowchart LR
    A[Push] --> B[並列ジョブ開始]
    B --> C[Lint]
    B --> D[Test]
    B --> E[Build]
    C --> F{すべて成功?}
    D --> F
    E --> F
    F -->|Yes| G[デプロイ]
    F -->|No| H[パイプライン失敗]
    

3. matrix を活用した複数環境での効率的なテスト

複数の Node.js バージョンや OS でテストする場合、matrix ストラテジーを使うことで、同一コードの重複を避けられます。

name: Test Multiple Environments
on: [push, pull_request]

jobs:
  test:
    runs-on: ${{ matrix.os }}
    strategy:
      # 1つの失敗でマトリックス全体を停止しない
      fail-fast: false
      matrix:
        os: [ubuntu-latest, macos-latest, windows-latest]
        node-version: [18, 20, 22]
        exclude:
          # 一部の組み合わせを除外（例：Windows + Node 18 は除外）
          - os: windows-latest
            node-version: 18

    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: ${{ matrix.node-version }}
          cache: 'npm'

      - run: npm ci
      - run: npm test
      - name: Upload coverage
        if: matrix.os == 'ubuntu-latest' && matrix.node-version == '20'
        uses: codecov/codecov-action@v4

ワークフロー実行時間の詳細な計測と分析

GitHub Actions 内での処理時間ロギング

最適化効果を測定するには、各ステップの実行時間を記録する必要があります。以下は実行時間をジョブの出力に記録する例です：

name: Performance Monitoring
on: [push]

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4

      - name: Setup Node.js
        run: |
          echo "⏱️ セットアップ開始: $(date)"
          node --version
          npm --version

      - uses: actions/setup-node@v4
        with:
          node-version: '20'
          cache: 'npm'

      - name: Install dependencies
        run: |
          echo "⏱️ インストール開始: $(date)"
          time npm ci
          echo "⏱️ インストール完了: $(date)"

      - name: Run linter
        run: |
          echo "⏱️ Lint 開始: $(date)"
          time npm run lint
          echo "⏱️ Lint 完了: $(date)"

      - name: Run tests
        run: |
          echo "⏱️ テスト開始: $(date)"
          time npm test
          echo "⏱️ テスト完了: $(date)"

      - name: Build application
        run: |
          echo "⏱️ ビルド開始: $(date)"
          time npm run build
          echo "⏱️ ビルド完了: $(date)"

GitHub API による実行時間の自動集計

複数のワークフロー実行から統計情報を取得するスクリプトの例：

#!/bin/bash

# GitHub API から最新10回のワークフロー実行を取得
OWNER="your-org"
REPO="your-repo"
WORKFLOW_ID="ci.yml"

curl -s "https://api.github.com/repos/$OWNER/$REPO/actions/workflows/$WORKFLOW_ID/runs?per_page=10" \
  -H "Authorization: token $GITHUB_TOKEN" | jq '.workflow_runs[] | {
    id: .id,
    status: .status,
    conclusion: .conclusion,
    name: .name,
    run_number: .run_number,
    duration_seconds: (.updated_at | fromdate) - (.created_at | fromdate)
  }' | jq -s 'map(.duration_seconds) | {
    count: length,
    avg: (add / length),
    min: min,
    max: max
  }'

実務で遭遇しやすいハマりポイントと解決策

問題1: キャッシュが効いていない、またはヒット率が低い

原因： package-lock.json や requirements.txt が変更されるたび、キャッシュキーが変わるため、キャッシュが無効化されます。また、タイムアウトで古いキャッシュが削除される場合もあります。

解決策： キャッシュキーを明確に指定し、復元キーをフォールバック設定します：

- uses: actions/cache@v4
    with:
      path: ~/.npm
      key: ${{ runner.os }}-npm-${{ hashFiles('**/package-lock.json') }}
      # キャッシュがヒットしなかった場合の復元キー
      restore-keys: |
        ${{ runner.os }}-npm-
        ${{ runner.os }}-

問題2: マトリックスの組み合わせが爆発的に増加

原因： exclude を設定せず、すべての組み合わせを実行してしまい、利用可能ランナー数に達する。

解決策： 実務で必要な組み合わせのみを明示的に定義します：

strategy:
  matrix:
    include:
      - os: ubuntu-latest
        node-version: 20
        python-version: '3.11'
      - os: ubuntu-latest
        node-version: 22
        python-version: '3.12'
      - os: macos-latest
        node-version: 20
        python-version: '3.11'

問題3: デプロイが失敗しても通知されない

原因： 並列ジョブの一部が失敗しても、他のジョブは実行継続してしまい、結果がマスクされる。

解決策： if: always() と needs を組み合わせて、明示的に成功/失敗判定します：

deploy:
    if: success()
    needs: [lint, test, build]
    runs-on: ubuntu-latest
    steps:
      - run: echo "All checks passed, deploying..."

コスト最適化とランナー選択

GitHub ホステッドランナーと Self-hosted ランナーの使い分け

GitHub ホステッドランナーは無料枠が 2,000分/月ですが、組織の規模が大きい場合、Self-hosted ランナーの導入でコストを削減できます。

推奨される使い分け

name: Optimized Pipeline
on: [push, pull_request]

jobs:
  lint-and-test:
    # PR やフィーチャーブランチは ホステッドで十分
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - run: npm ci && npm run lint && npm test

  build-and-deploy:
    # 本番デプロイは Self-hosted で高速化
    if: github.ref == 'refs/heads/main'
    runs-on: self-hosted
    steps:
      - uses: actions/checkout@v4
      - run: npm run build
      - run: npm run deploy

実装パターン：実際の大規模プロジェクト例

以下は、複数のマイクロサービスを持つプロジェクトの本番レベルの CI/CD 設定例です：

name: Production CI/CD
on:
  push:
    branches: [main, develop]
  pull_request:
    branches: [main, develop]

env:
  REGISTRY: ghcr.io
  IMAGE_NAME: ${{ github.repository }}

jobs:
  # ステップ1: 品質チェック（並列実行）
  quality:
    runs-on: ubuntu-latest
    strategy:
      matrix:
        task: [lint, type-check, security-audit]
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: '20'
          cache: 'npm'
      - run: npm ci
      - run: npm run ${{ matrix.task }}

  # ステップ2: テスト（複数環境）
  test:
    runs-on: ubuntu-latest
    strategy:
      matrix:
        node-version: [18, 20, 22]
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: ${{ matrix.node-version }}
          cache: 'npm'
      - run: npm ci
      - run: npm test -- --coverage
      - uses: codecov/codecov-action@v4
        if: matrix.node-version == '20'

  # ステップ3: ビルド
  build:
    runs-on: ubuntu-latest
    needs: quality
    permissions:
      contents: read
      packages: write
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: '20'
          cache: 'npm'

      - run: npm ci
      - run: npm run build

      - name: Build and push Docker image
        if: github.event_name == 'push'
        uses: docker/build-push-action@v5
        with:
          context: .
          push: true
          tags: ${{ env.REGISTRY }}/${{ env.IMAGE_NAME }}:${{ github.sha }}
          registry: ${{ env.REGISTRY }}
          username: ${{ github.actor }}
          password: ${{ secrets.GITHUB_TOKEN }}

  # ステップ4: デプロイ（本番ブランチのみ）
  deploy:
    if: github.ref == 'refs/heads/main' && github.event_name == 'push'
    needs: [test, build]
    runs-on: self-hosted
    environment:
      name: production
      url: https://api.example.com
    steps:
      - uses: actions/checkout@v4

      - name: Deploy to production
        env:
          DEPLOY_KEY: ${{ secrets.DEPLOY_KEY }}
          DEPLOY_HOST: ${{ secrets.DEPLOY_HOST }}
        run: |
          mkdir -p ~/.ssh
          echo "$DEPLOY_KEY" > ~/.ssh/deploy_key
          chmod 600 ~/.ssh/deploy_key
          ssh -i ~/.ssh/deploy_key -o StrictHostKeyChecking=no \
            $DEPLOY_HOST "cd /app && docker pull ${{ env.REGISTRY }}/${{ env.IMAGE_NAME }}:${{ github.sha }} && docker-compose up -d"

      - name: Verify deployment
        run: |
          sleep 10
          curl -f https://api.example.com/health || exit 1

flowchart TD
    A[コード Push] --> B[品質チェック
Lint/Type/Security]
    B --> C{チェック
成功?}
    C -->|失敗| D[通知]
    C -->|成功| E[複数環境でテスト
Node 18/20/22]
    E --> F{テスト
成功?}
    F -->|失敗| D
    F -->|成功| G[ビルド]
    G --> H{本番
ブランチ?}
    H -->|いいえ| I[完了]
    H -->|はい| J[Docker イメージ ビルド]
    J --> K[Self-hosted にデプロイ]
    K --> L[ヘルスチェック]
    L --> M{成功?}
    M -->|失敗| D
    M -->|成功| N[本番稼働]
    

パフォーマンス測定の実装

最適化の効果を定量的に測定するため、ワークフロー実行の履歴を記録し、トレンドを分析します：

name: Monitor Pipeline Performance
on:
  workflow_run:
    workflows: ["Production CI/CD"]
    types: [completed]

jobs:
  analyze:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4

      - name: Fetch workflow metrics
        run: |
          # 最新50回の実行データを取得
          curl -s \
            -H "Authorization: token ${{ secrets.GITHUB_TOKEN }}" \
            https://api.github.com/repos/${{ github.repository }}/actions/workflows/ci.yml/runs?per_page=50 \
            | jq -r '.workflow_runs[] | [.run_number, .conclusion, .run_started_at, .updated_at] | @csv' \
            > workflow_metrics.csv

      - name: Analyze trends
        run: |
          python3 << 'EOF'
          import csv
          import json
          from datetime import datetime
          
          durations = []
          with open('workflow_metrics.csv') as f:
              reader = csv.reader(f)
              for row in reader:
                  if row[1] == 'success':
                      start = datetime.fromisoformat(row[2].replace('Z', '+00:00'))
                      end = datetime.fromisoformat(row[3].replace('Z', '+00:00'))
                      duration_sec = (end - start).total_seconds()
                      durations.append(duration_sec)
          
          if durations:
              avg = sum(durations) / len(durations)
              print(f"平均実行時間: {avg:.0f}秒")
              print(f"最小: {min(durations):.0f}秒")
              print(f"最大: {max(durations):.0f}秒")
          EOF

よくある質問