2025年7月29日 / 最終更新日 : 2025年7月29日 fujifuji コラム

Python CI/CD自動化完全マスター – GitHub Actions・Docker・pytest実践ガイド

 

CI/CDとは？Pythonプロジェクトでの重要性

**CI/CD（Continuous Integration/Continuous Deployment）**は、コードの統合・テスト・デプロイを自動化する開発手法です。Pythonプロジェクトでは、テスト実行・コード品質チェック・パッケージ化・デプロイまでを自動化できます。

CI/CDの基本フロー

ステージ 内容 ツール例
CI（継続的統合） テスト・リント・ビルド GitHub Actions, pytest
CD（継続的デプロイ） 本番環境への自動デプロイ Docker, AWS, Heroku

GitHub Actionsで始めるPython CI/CD

基本的なワークフロー設定

# .github/workflows/ci.yml
name: Python CI
on: [push, pull_request]

jobs:
  test:
    runs-on: ubuntu-latest
    steps:
    - uses: actions/checkout@v3
    - name: Set up Python
      uses: actions/setup-python@v4
      with:
        python-version: '3.11'
    - name: Install dependencies
      run: |
        pip install -r requirements.txt
    - name: Run tests
      run: pytest

マルチPythonバージョンテスト

jobs:
  test:
    runs-on: ubuntu-latest
    strategy:
      matrix:
        python-version: ['3.9', '3.10', '3.11', '3.12']
    steps:
    - uses: actions/checkout@v3
    - name: Set up Python ${{ matrix.python-version }}
      uses: actions/setup-python@v4
      with:
        python-version: ${{ matrix.python-version }}
    - name: Test
      run: pytest

コード品質チェックの自動化

リント・フォーマットチェック

  lint:
    runs-on: ubuntu-latest
    steps:
    - uses: actions/checkout@v3
    - name: Set up Python
      uses: actions/setup-python@v4
    - name: Install tools
      run: pip install black flake8 mypy
    - name: Check formatting
      run: black --check .
    - name: Lint
      run: flake8 .
    - name: Type check
      run: mypy .

pre-commitフックの設定

# .pre-commit-config.yaml
repos:
  - repo: https://github.com/psf/black
    rev: 23.3.0
    hooks:
      - id: black
  - repo: https://github.com/pycqa/flake8
    rev: 6.0.0
    hooks:
      - id: flake8
  - repo: https://github.com/pre-commit/mirrors-mypy
    rev: v1.3.0
    hooks:
      - id: mypy

テストカバレッジとレポート

カバレッジレポート生成

    - name: Test with coverage
      run: |
        pip install pytest-cov
        pytest --cov=src --cov-report=xml
    - name: Upload coverage
      uses: codecov/codecov-action@v3
      with:
        file: ./coverage.xml

テスト結果の可視化

    - name: Publish test results
      uses: dorny/test-reporter@v1
      if: success() || failure()
      with:
        name: pytest
        path: test-results.xml
        reporter: java-junit

Dockerを使った環境標準化

基本的なDockerfile

FROM python:3.11-slim

WORKDIR /app
COPY requirements.txt .
RUN pip install -r requirements.txt

COPY . .
EXPOSE 8000

CMD ["python", "app.py"]

Docker Composeでの開発環境

# docker-compose.yml
version: '3.8'
services:
  app:
    build: .
    ports:
      - "8000:8000"
    volumes:
      - .:/app
    environment:
      - FLASK_ENV=development
  
  db:
    image: postgres:15
    environment:
      POSTGRES_DB: myapp
      POSTGRES_PASSWORD: password

DockerでのCI実行

  docker-test:
    runs-on: ubuntu-latest
    steps:
    - uses: actions/checkout@v3
    - name: Build Docker image
      run: docker build -t myapp .
    - name: Run tests in container
      run: docker run --rm myapp pytest

依存関係管理とセキュリティ

Dependabotの設定

# .github/dependabot.yml
version: 2
updates:
  - package-ecosystem: "pip"
    directory: "/"
    schedule:
      interval: "weekly"
    open-pull-requests-limit: 10

セキュリティスキャン

  security:
    runs-on: ubuntu-latest
    steps:
    - uses: actions/checkout@v3
    - name: Security check
      run: |
        pip install safety bandit
        safety check
        bandit -r src/

デプロイメント自動化

Herokuへの自動デプロイ

  deploy:
    needs: test
    runs-on: ubuntu-latest
    if: github.ref == 'refs/heads/main'
    steps:
    - uses: actions/checkout@v3
    - name: Deploy to Heroku
      uses: akhileshns/heroku-deploy@v3.12.12
      with:
        heroku_api_key: ${{ secrets.HEROKU_API_KEY }}
        heroku_app_name: "your-app-name"
        heroku_email: "your-email@example.com"

AWS ECSへのデプロイ

  deploy-aws:
    runs-on: ubuntu-latest
    steps:
    - name: Configure AWS credentials
      uses: aws-actions/configure-aws-credentials@v2
      with:
        aws-access-key-id: ${{ secrets.AWS_ACCESS_KEY_ID }}
        aws-secret-access-key: ${{ secrets.AWS_SECRET_ACCESS_KEY }}
        aws-region: us-east-1
    - name: Deploy to ECS
      run: |
        aws ecs update-service --cluster myapp --service myapp-service --force-new-deployment

パッケージの自動リリース

PyPIへの自動公開

  publish:
    needs: test
    runs-on: ubuntu-latest
    if: github.event_name == 'release'
    steps:
    - uses: actions/checkout@v3
    - name: Set up Python
      uses: actions/setup-python@v4
    - name: Build package
      run: |
        pip install build
        python -m build
    - name: Publish to PyPI
      uses: pypa/gh-action-pypi-publish@release/v1
      with:
        password: ${{ secrets.PYPI_API_TOKEN }}

セマンティックバージョニング

    - name: Semantic Release
      uses: cycjimmy/semantic-release-action@v3
      with:
        semantic_version: 19
        extra_plugins: |
          @semantic-release/changelog
          @semantic-release/git
      env:
        GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

環境別デプロイ戦略

ブランチベースデプロイ

  deploy-staging:
    if: github.ref == 'refs/heads/develop'
    runs-on: ubuntu-latest
    environment: staging
    steps:
    - name: Deploy to staging
      run: echo "Deploying to staging"

  deploy-production:
    if: github.ref == 'refs/heads/main'
    runs-on: ubuntu-latest
    environment: production
    steps:
    - name: Deploy to production
      run: echo "Deploying to production"

環境変数の管理

    env:
      DATABASE_URL: ${{ secrets.DATABASE_URL }}
      SECRET_KEY: ${{ secrets.SECRET_KEY }}
      DEBUG: ${{ github.ref != 'refs/heads/main' }}

高度なCI/CDパターン

並列実行によるスピード最適化

jobs:
  lint:
    runs-on: ubuntu-latest
    steps: [linting steps]
  
  test:
    runs-on: ubuntu-latest
    strategy:
      matrix:
        python-version: ['3.9', '3.11']
    steps: [testing steps]
  
  security:
    runs-on: ubuntu-latest
    steps: [security checks]
  
  deploy:
    needs: [lint, test, security]
    runs-on: ubuntu-latest
    steps: [deployment steps]

キャッシュ活用によるビルド高速化

    - name: Cache pip packages
      uses: actions/cache@v3
      with:
        path: ~/.cache/pip
        key: ${{ runner.os }}-pip-${{ hashFiles('requirements.txt') }}
    
    - name: Cache Docker layers
      uses: actions/cache@v3
      with:
        path: /tmp/.buildx-cache
        key: ${{ runner.os }}-buildx-${{ github.sha }}

モニタリングと通知

Slack通知の設定

    - name: Notify Slack
      if: failure()
      uses: 8398a7/action-slack@v3
      with:
        status: failure
        webhook_url: ${{ secrets.SLACK_WEBHOOK }}
        text: "CI/CD failed for ${{ github.repository }}"

メトリクス収集

    - name: Upload metrics
      run: |
        curl -X POST "${{ secrets.METRICS_ENDPOINT }}" \
          -H "Content-Type: application/json" \
          -d '{"build_time": "${{ env.BUILD_TIME }}", "status": "success"}'

トラブルシューティング

よくある問題と解決法

# デバッグ用の詳細ログ出力
    - name: Debug info
      run: |
        python --version
        pip list
        env | grep -E "(PYTHON|PATH)"
      
# ワークフロー失敗時の調査
    - name: Upload logs
      if: failure()
      uses: actions/upload-artifact@v3
      with:
        name: logs
        path: logs/

実プロジェクトでの完全なCI/CDパイプライン

フルスタックWebアプリの例

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

jobs:
  test:
    runs-on: ubuntu-latest
    services:
      postgres:
        image: postgres:15
        env:
          POSTGRES_PASSWORD: postgres
        options: >-
          --health-cmd pg_isready
          --health-interval 10s
          --health-timeout 5s
          --health-retries 5
    
    steps:
    - uses: actions/checkout@v3
    - name: Setup Python
      uses: actions/setup-python@v4
      with:
        python-version: '3.11'
    
    - name: Install dependencies
      run: |
        pip install -r requirements.txt
        pip install pytest-cov flake8 black
    
    - name: Lint and format check
      run: |
        flake8 .
        black --check .
    
    - name: Run tests
      run: pytest --cov=src --cov-report=xml
      env:
        DATABASE_URL: postgresql://postgres:postgres@localhost:5432/test
    
    - name: Build Docker image
      run: docker build -t myapp:${{ github.sha }} .
    
    - name: Deploy to staging
      if: github.ref == 'refs/heads/develop'
      run: |
        docker tag myapp:${{ github.sha }} myapp:staging
        # Deploy to staging environment
    
    - name: Deploy to production
      if: github.ref == 'refs/heads/main'
      run: |
        docker tag myapp:${{ github.sha }} myapp:production
        # Deploy to production environment

パフォーマンス最適化

ビルド時間の短縮

# 条件付き実行でスキップ
    - name: Skip if no Python changes
      id: changes
      uses: dorny/paths-filter@v2
      with:
        filters: |
          python:
            - '**/*.py'
            - 'requirements.txt'
    
    - name: Run tests
      if: steps.changes.outputs.python == 'true'
      run: pytest

まとめ：Python CI/CD成功の秘訣

CI/CDの効果

  • 品質向上と バグ減少
  • デプロイ時間の大幅短縮
  • 開発者の生産性向上
  • リリースの信頼性向上

導入のベストプラクティス

  • 小さく始めて段階的に拡張
  • テストの自動化を最優先
  • 環境の標準化（Docker活用）
  • セキュリティチェックの組み込み

避けるべき落とし穴

  • 過度に複雑なパイプライン
  • テスト時間の長期化
  • 環境間の設定差異
  • シークレット管理の不備

推奨する段階的導入

  1. 基本的なテスト自動化
  2. コード品質チェック追加
  3. Docker化と環境標準化
  4. 本番デプロイ自動化

Python CI/CDをマスターすることで、開発チームの生産性が大幅に向上し、より安全で高品質なソフトウェアを継続的にリリースできるようになります。まずはGitHub Actionsでの基本的なテスト自動化から始めて、徐々に高度な機能を追加していきましょう。

■プロンプトだけでオリジナルアプリを開発・公開してみた！！

プロンプトだけでオリジナルアプリを開発・公開してみた！！

■AI時代の第一歩！「AI駆動開発コース」はじめました！

テックジム東京本校で先行開始。

AI時代の第一歩！「AI駆動開発コース」（初心者向け）

■テックジム東京本校

「武田塾」のプログラミング版といえば「テックジム」。
講義動画なし、教科書なし。「進捗管理とコーチング」で効率学習。
より早く、より安く、しかも対面型のプログラミングスクールです。

テックジム東京本校

＜短期講習＞5日で5万円の「Pythonミニキャンプ」開催中。

独学もオンラインも無理だから、有給とって「Pythonミニキャンプ」へ【5日間で5万円】

＜月1開催＞放送作家による映像ディレクター養成講座

現役放送作家が教える動画講座！『ＤＯＧＡ』

＜オンライン無料＞ゼロから始めるPython爆速講座

ゼロから始めるPython爆速講座（理系・プログラミング初心者向け）

プログラミング学習に関するお役立ちコンテンツ

カテゴリー
コラム
コラム

前の記事

Pythonテスト駆動開発（TDD）実践マスターガイド – unittest・pytest完全攻略
2025年7月29日
コラム

次の記事

配列完全マスターガイド – Python・JavaScript・Java徹底比較と実践活用法
2025年7月29日