풀스택 개발자를 위한 CI/CD 2강 — GitHub Actions 해부와 첫 워크플로

Repository
└── .github/workflows/
    ├── ci.yml          ← Workflow (파일 하나 = 워크플로 하나)
    │   ├── on:         ← Event (언제 실행할까)
    │   └── jobs:
    │       ├── lint    ← Job (Runner 한 대에서 실행)
    │       │   └── steps:
    │       │       ├── uses: ...   ← Action (재사용 가능한 부품)
    │       │       └── run: ...    ← 셸 명령
    │       └── test
    └── deploy.yml

on:
  push:
    branches: [main]
    tags: ['v*']            # v로 시작하는 태그 push
    paths-ignore:
      - '**.md'             # 문서만 바뀌면 실행하지 않음
  pull_request:
    branches: [main]        # main을 대상으로 하는 PR
  workflow_dispatch:        # Actions 탭에서 수동 실행 버튼
    inputs:
      environment:
        type: choice
        options: [staging, production]
  schedule:
    - cron: '0 18 * * *'    # 매일 18:00 UTC = 한국 시간 새벽 3시

- name: 운영 배포
  if: github.ref == 'refs/heads/main' && github.event_name == 'push'
  run: ./deploy.sh
 
- name: 실패했을 때만 리포트 업로드
  if: failure()
  run: echo "테스트 실패"

{
  "scripts": {
    "dev": "next dev",
    "build": "next build",
    "start": "next start",
    "lint": "eslint .",
    "typecheck": "tsc --noEmit",
    "test": "vitest run"
  }
}

22

name: CI
 
on:
  push:
    branches: [main]
  pull_request:
    branches: [main]
 
# GITHUB_TOKEN 권한을 최소로 제한
permissions:
  contents: read
 
jobs:
  ci:
    name: Lint, Test, Build
    runs-on: ubuntu-latest
    timeout-minutes: 15
 
    steps:
      - name: 코드 체크아웃
        uses: actions/checkout@v4
 
      - name: Node.js 설치
        uses: actions/setup-node@v4
        with:
          node-version-file: .nvmrc
          cache: npm              # ~/.npm 캐시 자동 처리
 
      - name: 의존성 설치
        run: npm ci
 
      - name: Lint
        run: npm run lint
 
      - name: 타입 체크
        run: npm run typecheck
 
      - name: 단위 테스트
        run: npm test
 
      - name: 빌드
        run: npm run build
        env:
          NEXT_TELEMETRY_DISABLED: 1

      - uses: pnpm/action-setup@v4       # package.json의 packageManager 필드로 버전 결정
      - uses: actions/setup-node@v4
        with:
          node-version-file: .nvmrc
          cache: pnpm
      - run: pnpm install --frozen-lockfile

jobs:
  verify:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with: { node-version-file: .nvmrc, cache: npm }
      - run: npm ci
      - run: npm run lint
      - run: npm run typecheck
      - run: npm test
 
  build:
    needs: verify                    # verify 성공 후 실행
    runs-on: ubuntu-latest
    outputs:
      version: ${{ steps.ver.outputs.version }}
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with: { node-version-file: .nvmrc, cache: npm }
      - run: npm ci
      - run: npm run build
      - id: ver
        run: echo "version=$(node -p "require('./package.json').version")" >> "$GITHUB_OUTPUT"
      - name: 빌드 결과를 아티팩트로 업로드
        uses: actions/upload-artifact@v4
        with:
          name: next-build
          path: |
            .next
            !.next/cache
          retention-days: 7
 
  report:
    needs: build
    runs-on: ubuntu-latest
    steps:
      - uses: actions/download-artifact@v4
        with:
          name: next-build
          path: .next
      - run: |
          echo "버전: ${{ needs.build.outputs.version }}"
          du -sh .next

![CI](https://github.com/<OWNER>/<REPO>/actions/workflows/ci.yml/badge.svg)