GitHub Actionsチートシート — 逆引きレシピと定番自動化集

# mainへのpushとmain向けPR（CIの基本形）
on:
  push:
    branches: [main]
  pull_request:
    branches: [main]
 
# ドキュメントのみの変更は除外
    paths-ignore: ['**.md', 'docs/**']
 
# 手動実行ボタン
on:
  workflow_dispatch:
 
# 定期実行（UTC注意。JSTは-9時間）
on:
  schedule:
    - cron: '0 0 * * 1'   # 毎週月曜 9:00 JST
 
# バージョンタグでリリース駆動
on:
  push:
    tags: ['v*']

- id: version
  run: echo "value=1.2.3" >> "$GITHUB_OUTPUT"
- run: echo "${{ steps.version.outputs.value }}"

# 依存関係（testの成功を待つ）
jobs:
  deploy:
    needs: test
 
# マトリックス（Node 20/22で並列テスト）
    strategy:
      matrix:
        node-version: [20, 22]
 
# 古い実行をキャンセル（CI用）
concurrency:
  group: ${{ github.workflow }}-${{ github.ref }}
  cancel-in-progress: true
 
# 同時実行を防ぎつつ中断はしない（デプロイ用）
concurrency:
  group: deploy
  cancel-in-progress: false
 
# 権限の最小化（書いた瞬間、書いてない権限はnoneになる）
permissions:
  contents: read

# .github/dependabot.yml
version: 2
updates:
  - package-ecosystem: npm
    directory: /
    schedule:
      interval: weekly
 
  - package-ecosystem: github-actions   # アクションの@v4なども更新対象に
    directory: /
    schedule:
      interval: weekly

# .github/workflows/labeler.yml
name: PR Labeler
on: pull_request_target
permissions:
  contents: read
  pull-requests: write
jobs:
  label:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/labeler@v5

# .github/labeler.yml（ラベルの定義）
frontend:
  - changed-files:
      - any-glob-to-any-file: 'src/**'
docs:
  - changed-files:
      - any-glob-to-any-file: '**/*.md'
ci:
  - changed-files:
      - any-glob-to-any-file: '.github/**'

# .github/workflows/release.yml
name: Release
on:
  push:
    tags: ['v*']
permissions:
  contents: write
jobs:
  release:
    runs-on: ubuntu-latest
    steps:
      - name: リリースを作成する
        env:
          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
        run: gh release create "$GITHUB_REF_NAME" --generate-notes --repo "$GITHUB_REPOSITORY"

      - name: 失敗をSlackに通知する
        if: failure()
        env:
          WEBHOOK_URL: ${{ secrets.SLACK_WEBHOOK_URL }}
          RUN_URL: ${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }}
        run: |
          curl -X POST -H 'Content-Type: application/json' \
            -d "{\"text\":\"❌ CIが失敗しました: $RUN_URL\"}" \
            "$WEBHOOK_URL"