my-project/
├── .github/
│   └── workflows/
│       ├── ci.yml          # テスト自動実行
│       ├── deploy.yml      # 自動デプロイ
│       └── scheduled.yml   # 定期実行タスク
├── src/
├── tests/
└── README.md

# ワークフロー名（GitHub上で表示される）
name: CI

# トリガー：いつ実行するか
on:
  push:
    branches: [ main ]
  pull_request:
    branches: [ main ]

# ジョブ：何を実行するか
jobs:
  test:
    # 実行環境（ランナー）
    runs-on: ubuntu-latest

    # ステップ：ジョブ内の各処理
    steps:
      - uses: actions/checkout@v4
      - name: Run tests
        run: echo "Hello, GitHub Actions!"

on:
  push:
    # 特定のブランチのみ
    branches:
      - main
      - develop
    # 特定のパスのみ（src配下の変更時のみ実行）
    paths:
      - 'src/**'
      - 'tests/**'
    # 特定のパスを除外
    paths-ignore:
      - '*.md'
      - 'docs/**'

on:
  pull_request:
    branches: [ main ]
    # 特定のアクティビティタイプのみ
    types:
      - opened        # PR作成時
      - synchronize   # PRに新しいコミットがpushされた時
      - reopened      # PRが再オープンされた時

on:
  schedule:
    # 毎日UTC 0:00（JST 9:00）に実行
    - cron: '0 0 * * *'
    # 毎週月曜UTC 3:00（JST 12:00）に実行
    - cron: '0 3 * * 1'

# 手動実行 + パラメータ入力
on:
  workflow_dispatch:
    inputs:
      environment:
        description: 'デプロイ先環境'
        required: true
        default: 'staging'
        type: choice
        options:
          - staging
          - production

jobs:
  # ジョブ1: テスト（最初に実行）
  test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Run tests
        run: npm test

  # ジョブ2: ビルド（testの完了後に実行）
  build:
    needs: test
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Build
        run: npm run build

  # ジョブ3: デプロイ（buildの完了後に実行）
  deploy:
    needs: build
    runs-on: ubuntu-latest
    steps:
      - name: Deploy
        run: echo "Deploying..."

jobs:
  test:
    runs-on: ubuntu-latest
    strategy:
      matrix:
        python-version: ['3.10', '3.11', '3.12']
        os: [ubuntu-latest, macos-latest]
      # 1つ失敗しても他は継続
      fail-fast: false

    steps:
      - uses: actions/checkout@v4
      - name: Set up Python ${{ matrix.python-version }}
        uses: actions/setup-python@v5
        with:
          python-version: ${{ matrix.python-version }}
      - name: Run tests
        run: python -m pytest

steps:
  - uses: actions/checkout@v4

  # 条件付き実行（mainブランチのみ）
  - name: Deploy to production
    if: github.ref == 'refs/heads/main'
    run: ./deploy.sh

  # 前のステップが失敗しても実行
  - name: Upload error logs
    if: failure()
    run: ./upload-logs.sh

  # 常に実行（成功・失敗問わず）
  - name: Cleanup
    if: always()
    run: ./cleanup.sh

steps:
  # 基本的な使い方
  - uses: actions/checkout@v4

  # 履歴も含めてチェックアウト（git logが必要な場合）
  - uses: actions/checkout@v4
    with:
      fetch-depth: 0   # 全履歴を取得（デフォルトは1）

  # 別のリポジトリをチェックアウト
  - uses: actions/checkout@v4
    with:
      repository: owner/other-repo
      token: ${{ secrets.PAT_TOKEN }}

steps:
  - uses: actions/checkout@v4
  - uses: actions/setup-python@v5
    with:
      python-version: '3.12'
      # pipのキャッシュを有効化
      cache: 'pip'
  - run: pip install -r requirements.txt
  - run: python -m pytest

steps:
  - uses: actions/checkout@v4
  - uses: actions/setup-node@v4
    with:
      node-version: '20'
      # npmのキャッシュを有効化
      cache: 'npm'
  - run: npm ci
  - run: npm test

steps:
  - uses: actions/checkout@v4
  - uses: actions/cache@v4
    with:
      path: ~/.cache/pip
      # requirements.txtが変わったらキャッシュを更新
      key: ${{ runner.os }}-pip-${{ hashFiles('requirements.txt') }}
      restore-keys: |
        ${{ runner.os }}-pip-

name: Django CI

on:
  push:
    branches: [ main, develop ]
  pull_request:
    branches: [ main ]

jobs:
  test:
    runs-on: ubuntu-latest

    # サービスコンテナ（PostgreSQL）
    services:
      postgres:
        image: postgres:16
        env:
          POSTGRES_USER: testuser
          POSTGRES_PASSWORD: testpass
          POSTGRES_DB: testdb
        ports:
          - 5432:5432
        options: >-
          --health-cmd pg_isready
          --health-interval 10s
          --health-timeout 5s
          --health-retries 5

    env:
      DATABASE_URL: postgres://testuser:testpass@localhost:5432/testdb
      DJANGO_SETTINGS_MODULE: myproject.settings.test

    steps:
      - uses: actions/checkout@v4

      - uses: actions/setup-python@v5
        with:
          python-version: '3.12'
          cache: 'pip'

      - name: Install dependencies
        run: |
          python -m pip install --upgrade pip
          pip install -r requirements.txt

      - name: Run migrations
        run: python manage.py migrate

      - name: Run tests
        run: python -m pytest --cov=. --cov-report=xml

      - name: Upload coverage report
        uses: actions/upload-artifact@v4
        with:
          name: coverage-report
          path: coverage.xml

name: Build and Deploy

on:
  push:
    branches: [ main ]

jobs:
  build-and-deploy:
    runs-on: ubuntu-latest

    steps:
      - uses: actions/checkout@v4

      # Docker Hubにログイン
      - name: Login to Docker Hub
        uses: docker/login-action@v3
        with:
          username: ${{ secrets.DOCKER_USERNAME }}
          password: ${{ secrets.DOCKER_PASSWORD }}

      # Dockerイメージのビルドとプッシュ
      - name: Build and push
        uses: docker/build-push-action@v5
        with:
          context: .
          push: true
          tags: |
            myuser/myapp:latest
            myuser/myapp:${{ github.sha }}

      # SSHでサーバーにデプロイ
      - name: Deploy to server
        uses: appleboy/ssh-action@v1
        with:
          host: ${{ secrets.SERVER_HOST }}
          username: ${{ secrets.SERVER_USER }}
          key: ${{ secrets.SSH_PRIVATE_KEY }}
          script: |
            cd /app
            docker compose pull
            docker compose up -d

# シークレットは ${{ secrets.名前 }} で参照
env:
  API_KEY: ${{ secrets.API_KEY }}
  DATABASE_URL: ${{ secrets.DATABASE_URL }}

# 環境（Environment）ごとのシークレットも設定可能
jobs:
  deploy:
    runs-on: ubuntu-latest
    environment: production   # production環境のシークレットを使用
    steps:
      - name: Deploy
        run: ./deploy.sh
        env:
          SERVER_HOST: ${{ secrets.SERVER_HOST }}

name: PR Test Report

on:
  pull_request:
    branches: [ main ]

permissions:
  pull-requests: write

jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-python@v5
        with:
          python-version: '3.12'

      - name: Install dependencies
        run: pip install -r requirements.txt

      - name: Run tests with report
        run: python -m pytest --junitxml=report.xml

      # テスト結果をPRにコメント
      - name: Publish test results
        uses: EnricoMi/publish-unit-test-result-action@v2
        if: always()
        with:
          files: report.xml