GitHub Actions 実践ガイド｜CI/CDをゼロから構築する学習ステップ

# キーと値
name: my-workflow
 
# ネスト（階層）
jobs:
  test:
    runs-on: ubuntu-latest
 
# リスト（-）
steps:
  - name: チェックアウト
    uses: actions/checkout@v4
  - name: テスト実行
    run: npm test

# .github/workflows/test.yml
name: テスト自動実行
 
on:
  push:
    branches: [main, develop]
  pull_request:
    branches: [main]
 
jobs:
  test:
    runs-on: ubuntu-latest
 
    steps:
      - name: コードをチェックアウト
        uses: actions/checkout@v4
 
      - name: Node.js をセットアップ
        uses: actions/setup-node@v4
        with:
          node-version: '20'
          cache: 'npm'
 
      - name: 依存パッケージをインストール
        run: npm ci
 
      - name: テストを実行
        run: npm test

# Go の場合
- name: Go をセットアップ
  uses: actions/setup-go@v5
  with:
    go-version: '1.22'
 
- name: テストを実行
  run: go test ./...

jobs:
  lint-and-test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: '20'
          cache: 'npm'
      - run: npm ci
      - name: Lint チェック
        run: npm run lint
      - name: テスト実行
        run: npm test

# .github/workflows/ai-review.yml
name: AI コードレビュー
 
on:
  pull_request:
    types: [opened, synchronize]
 
jobs:
  review:
    runs-on: ubuntu-latest
    permissions:
      contents: read
      pull-requests: write
 
    steps:
      - uses: actions/checkout@v4
        with:
          fetch-depth: 0
 
      - name: AI レビューを実行
        uses: coderabbitai/ai-pr-reviewer@latest
        env:
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
          OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
        with:
          debug: false
          review_simple_changes: false
          review_comment_lgtm: false

# ❌ 絶対にやってはいけない（公開リポジトリで即アウト）
env:
  API_KEY: sk-xxxxxxxxxxxx
 
# ✅ Secretsから参照する
env:
  API_KEY: ${{ secrets.OPENAI_API_KEY }}

# .github/workflows/deploy.yml
name: 本番デプロイ
 
on:
  push:
    branches: [main]
 
env:
  AWS_REGION: ap-northeast-1
  ECR_REPOSITORY: my-app
  ECS_SERVICE: my-service
  ECS_CLUSTER: my-cluster
 
jobs:
  deploy:
    runs-on: ubuntu-latest
    permissions:
      id-token: write
      contents: read
 
    steps:
      - uses: actions/checkout@v4
 
      - name: AWS 認証（OIDC）
        uses: aws-actions/configure-aws-credentials@v4
        with:
          role-to-assume: ${{ secrets.AWS_ROLE_ARN }}
          aws-region: ${{ env.AWS_REGION }}
 
      - name: ECR にログイン
        id: login-ecr
        uses: aws-actions/amazon-ecr-login@v2
 
      - name: Docker イメージをビルド & プッシュ
        env:
          ECR_REGISTRY: ${{ steps.login-ecr.outputs.registry }}
          IMAGE_TAG: ${{ github.sha }}
        run: |
          docker build -t $ECR_REGISTRY/$ECR_REPOSITORY:$IMAGE_TAG .
          docker push $ECR_REGISTRY/$ECR_REPOSITORY:$IMAGE_TAG
 
      - name: ECS にデプロイ
        uses: aws-actions/amazon-ecs-deploy-task-definition@v2
        with:
          task-definition: task-definition.json
          service: ${{ env.ECS_SERVICE }}
          cluster: ${{ env.ECS_CLUSTER }}
          wait-for-service-stability: true

on:
  push:
    branches: [main]           # mainブランチへのpush時
  pull_request:
    branches: [main, develop]  # PRを作成・更新時
  schedule:
    - cron: '0 9 * * 1'        # 毎週月曜9時（UTC）
  workflow_dispatch:           # 手動実行ボタン

jobs:
  deploy:
    runs-on: ubuntu-latest
    # mainブランチのpushのみデプロイ
    if: github.ref == 'refs/heads/main' && github.event_name == 'push'
 
    env:
      NODE_ENV: production
      APP_PORT: 3000
 
    steps:
      - run: echo "環境: $NODE_ENV"

jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - run: npm test
 
  deploy:
    needs: test          # test ジョブ完了後に実行
    runs-on: ubuntu-latest
    steps:
      - run: ./deploy.sh

- name: npm キャッシュ
  uses: actions/cache@v4
  with:
    path: ~/.npm
    key: ${{ runner.os }}-node-${{ hashFiles('**/package-lock.json') }}
    restore-keys: |
      ${{ runner.os }}-node-

# ❌ 名前がない
- run: npm ci
- run: npm test
 
# ✅ 名前あり
- name: 依存パッケージをインストール
  run: npm ci
- name: 単体テストを実行
  run: npm test

- name: デバッグ確認
  run: |
    echo "ブランチ: ${{ github.ref }}"
    echo "コミット: ${{ github.sha }}"
    echo "イベント: ${{ github.event_name }}"

# インストール（macOS）
brew install act
 
# ローカルで実行
act push