LoginSignup
0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

@kodack

#0114（2025/05/01）CI/CD導入ガイド

Posted at

全体概要

この記事では、技術スタック（Pythonバックエンド、Angularフロントエンド、GraphQL、PostgreSQL、Redis、Docker/docker-compose）をベースに、以下の観点からCI/CD導入の全体像を示します：

  1. 組織文化とプロセス全体：CI/CDが開発チームにもたらす効果と文化的変革
  2. 自動化フェーズのフロー：継続的インテグレーション（CI）から継続的デリバリー/デプロイ（CD）へのステップ
  3. 技術スタック別の設計ポイント：バックエンド、フロントエンド、非同期処理、セキュリティ解析
  4. 運用と監視：セキュリティ／コンプライアンス強化、観測性の導入
  5. よくある課題と改善策：ビルド時間短縮やフレークテスト対策など

以下の記事構成に沿って、深堀りと実践テンプレートを順にご紹介します。

1. CI/CDの本質と組織文化への影響

はじめに

現代のソフトウェア開発において、CI/CDは単なるツールチェーンではなく、組織の文化と開発プロセスを変革する極めて重要な要素です。本記事では、Pythonバックエンド＋Angularフロントエンド＋GraphQL＋PostgreSQL＋Redis＋Docker（docker-compose）という技術スタックをベースに、上級エンジニアにも刺さる深堀りとTipsを盛り込んだ「CI/CD導入ガイド」をお届けします。

1. CI/CDの本質と組織文化への影響

  • 継続的インテグレーション（CI）: 小さな変更を頻繁にマージし、自動テストを通じて品質を保証
  • 継続的デリバリー／デプロイメント（CD）: テストをパスしたアーティファクトを自動でステージング／本番環境へデプロイ

CI/CDは単なる自動化ではなく、フィードバックループを短くし、意思決定とリリースの高速化を実現します。DevOps文化の醸成やチームの信頼構築にも寄与し、結果的に技術的負債やマニュアルタスクの削減に繋がります。

2. 技術スタック別CI導入ポイント

バックエンド（Python + GraphQL）

# .github/workflows/backend-ci.yml
name: Backend CI
on: [push, pull_request]
jobs:
  test:
    runs-on: ubuntu-latest
    services:
      postgres:
        image: postgres:14
        ports: ['5432:5432']
        env:
          POSTGRES_USER: test
          POSTGRES_PASSWORD: test
          POSTGRES_DB: testdb
      redis:
        image: redis:6
        ports: ['6379:6379']
    steps:
      - uses: actions/checkout@v3
      - uses: actions/setup-python@v4
        with:
          python-version: '3.10'
      - run: pip install -r backend/requirements.txt
      - run: cd backend && pytest --cov=.
      - run: cd backend && coverage xml
      - name: Upload coverage to Codecov
        uses: codecov/codecov-action@v3
  • ポイント:
    • servicesを使ったインテグレーションテスト
    • コードカバレッジ収集→Codecov連携
    • 並列化やマトリクス実行でバージョン多様性を検証可能

フロントエンド（Angular）

# .github/workflows/frontend-ci.yml
name: Frontend CI
on: [push, pull_request]
jobs:
  lint-test-build:
    runs-on: ubuntu-latest
    strategy:
      matrix:
        node-version: ['16', '18']
        browser: ['chrome', 'firefox']
    steps:
      - uses: actions/checkout@v3
      - uses: actions/setup-node@v3
        with:
          node-version: ${{ matrix.node-version }}
      - run: cd frontend && npm ci
      - run: cd frontend && npm run lint
      - name: Run unit tests
        run: cd frontend && npm test -- --browsers=${{ matrix.browser }} --watch=false
      - name: Build production bundle
        run: cd frontend && npm run build -- --configuration production
  • ポイント:
    • マトリクス戦略で複数Node.jsバージョンとブラウザに対応
    • E2Eやパフォーマンステストを追加可能（Playwright, Lighthouse）

3. CD導入のベストプラクティス

3.1 自動ステージングデプロイ

# .github/workflows/deploy-staging.yml
name: Deploy to Staging
on:
  push:
    branches:
      - main
jobs:
  deploy-staging:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3
      - uses: docker/setup-buildx-action@v3
      - run: docker-compose -f docker-compose.yml build --parallel
      - name: Push images
        uses: docker/build-push-action@v3
        with:
          push: true
          tags: |
            ghcr.io/${{ github.repository }}/backend:staging
            ghcr.io/${{ github.repository }}/frontend:staging
      - name: SSH Deploy
        uses: appleboy/ssh-action@v1
        with:
          host: ${{ secrets.STAGING_HOST }}
          username: ${{ secrets.STAGING_USER }}
          key: ${{ secrets.SSH_KEY }}
          script: |
            docker pull ghcr.io/${{ github.repository }}/backend:staging
            docker pull ghcr.io/${{ github.repository }}/frontend:staging
            docker-compose down && docker-compose up -d
  • ポイント:
    • Container Registry利用でビルドとデプロイを分離
    • 並列ビルドでCI時間短縮

3.2 本番デプロイ with Approval

# .github/workflows/deploy-prod.yml
name: Deploy to Production
on:
  workflow_dispatch:
    inputs:
      environment:
        description: 'Environment to deploy'
        required: true
        default: 'production'
jobs:
  deploy-prod:
    runs-on: ubuntu-latest
    environment:
      name: production
      url: ${{ secrets.PROD_URL }}
    steps:
      - uses: actions/checkout@v3
      - uses: docker/setup-buildx-action@v3
      - run: docker-compose -f docker-compose.yml build
      - name: Approval
        uses: hmarr/auto-approve-action@v2.0.0
      - name: SSH Deploy
        uses: appleboy/ssh-action@v1
        with:
          host: ${{ secrets.PROD_HOST }}
          username: ${{ secrets.PROD_USER }}
          key: ${{ secrets.SSH_KEY }}
          script: |
            docker-compose down && docker-compose up -d --remove-orphans
  • ポイント:
    • workflow_dispatch + 環境プロテクションルールで「承認付きデプロイ」
    • GitHub Environments機能でシークレット分離

4. セキュリティ／コンプライアンス強化

  • Dependabot: 自動脆弱性検知 & PR作成
  • Secret Scanning: リポジトリ内のシークレット流出防止
  • CodeQL: 静的解析による脆弱性検出
# .github/workflows/codeql-analysis.yml
on:
  push:
    branches: [main]
  pull_request:
    branches: [main]
jobs:
  analyze:
    name: "CodeQL Analysis"
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3
      - uses: github/codeql-action/init@v2
        with:
          languages: javascript, python
      - uses: github/codeql-action/analyze@v2

5. 観測性とフィードバックループ

  • CIメトリクス: ビルド時間、テストカバレッジ、成功率を可視化 (GitHub Actions API)
  • デプロイ監視: Slack通知、PagerDuty連携
  • アプリ監視: Sentry + Grafana + Prometheus

6. よくある課題と対策

課題 対策
ビルド時間が長い イメージキャッシュ、並列処理、Docker BuildKit
フレークテスト 再実行戦略、再現性確保（DBリセット）
シークレット管理が煩雑 GitHub Environments & Vault連携

おわりに

本稿では、上級エンジニアにも有用となる深掘りポイントと実践テンプレートを提供しました。CI/CDは導入して終わりではなく、定期的なレビューと改善が欠かせません。ぜひ自チームのボトルネックを洗い出し、継続的に進化させていきましょう。

0
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
Sign upLogin
0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?