Frontend Academy · 강의

프런트엔드를 위한 GitHub Actions: 린트, 테스트, 빌드

종속성을 설치하고 ESLint를 실행하며 Jest 테스트를 수행하고 모든 pull request에서 앱을 빌드하는 workflow YAML을 작성합니다.

프런트엔드를 위한 GitHub Actions: 린트, 테스트, 빌드은(는) CoddyKit의 무료 Frontend Academy 강의입니다. 이것은 4개 중 1번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 Frontend Academy 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. Frontend Academy 강의에는 총 4개의 강의가 포함되어 있습니다.

프론트엔드에 CI가 필요한 이유

지속적 통합은 모든 푸시와 풀 리퀘스트마다 테스트, 린트 검사, 빌드를 실행합니다. 회귀 버그가 main에 도달하기 전에 발견합니다. 개발자가 두 명을 초과하는 모든 팀에 필요합니다.

GitHub Actions 기초

워크플로는 .github/workflows/에 있는 YAML 파일입니다. 각 워크플로에는 트리거(push, pull_request, schedule)에 따라 실행되는 작업이 있습니다.

# .github/workflows/ci.yml
name: CI
on:
  push:
    branches: [main]
  pull_request:
concurrency:
  group: ${{ github.workflow }}-${{ github.ref }}
  cancel-in-progress: true
jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with: { node-version: '20' }
      - run: npm ci
      - run: npm test

의존성 캐싱

실행할 때마다 다시 설치하지 않도록 node_modules(또는 pnpm/yarn 캐시)를 캐시하십시오. setup-node에는 캐시 지원이 기본으로 포함되어 있습니다.

- uses: actions/setup-node@v4
  with:
    node-version: '20'
    cache: 'npm'   # or 'yarn' or 'pnpm'

린트 작업

ESLint와 Prettier 검사를 실행하십시오. 오류가 발생하면 빌드를 실패하게 하십시오.

lint:
  runs-on: ubuntu-latest
  steps:
    - uses: actions/checkout@v4
    - uses: actions/setup-node@v4
      with: { node-version: '20', cache: 'npm' }
    - run: npm ci
    - run: npm run lint
    - run: npm run format:check

테스트 작업

Vitest 또는 Jest를 실행하십시오. 가시성을 위해 코드 커버리지 보고서를 출력하십시오.

test:
  runs-on: ubuntu-latest
  steps:
    - uses: actions/checkout@v4
    - uses: actions/setup-node@v4
      with: { node-version: '20', cache: 'npm' }
    - run: npm ci
    - run: npm test -- --coverage
    - uses: codecov/codecov-action@v4
      with:
        files: ./coverage/lcov.info

빌드 작업

프로덕션 번들을 빌드하십시오. 후속 배포 작업에서 사용할 수 있도록 아티팩트로 업로드하십시오.

build:
  runs-on: ubuntu-latest
  needs: [lint, test]
  steps:
    - uses: actions/checkout@v4
    - uses: actions/setup-node@v4
      with: { node-version: '20', cache: 'npm' }
    - run: npm ci
    - run: npm run build
    - uses: actions/upload-artifact@v4
      with:
        name: dist
        path: dist/
        retention-days: 7

병렬 작업

린트, 테스트, 타입 검사는 병렬로 실행할 수 있습니다. Actions는 각 작업을 자체 실행기에서 실행합니다. 순서를 강제하려면 needs:를 사용하십시오(린트와 테스트 후에 빌드).

타입 검사

전용 타입 검사 작업을 추가하십시오. tsc --noEmit을 실행하면 런타임 전에 TypeScript 오류를 발견할 수 있습니다.

typecheck:
  runs-on: ubuntu-latest
  steps:
    - uses: actions/checkout@v4
    - uses: actions/setup-node@v4
      with: { node-version: '20', cache: 'npm' }
    - run: npm ci
    - run: npx tsc --noEmit

매트릭스 테스트

여러 Node 버전 또는 운영 체제에서 테스트 작업을 병렬로 실행하십시오.

test:
  strategy:
    fail-fast: false
    matrix:
      node: [18, 20, 22]
      os: [ubuntu-latest, windows-latest, macos-latest]
  runs-on: ${{ matrix.os }}
  steps:
    - uses: actions/checkout@v4
    - uses: actions/setup-node@v4
      with: { node-version: ${{ matrix.node }} }
    - run: npm ci && npm test

조건부 단계

if:를 사용하여 조건에 따라 단계가 실행되도록 하십시오. 예를 들어 main 브랜치에서만 실행할 수 있습니다.

- name: Deploy to staging
  if: github.ref == 'refs/heads/main'
  run: npm run deploy:staging

비밀 정보와 변수

API 키와 토큰은 저장소 비밀 정보에 저장하세요(Settings → Secrets). secrets.NAME으로 액세스하세요. 비밀 정보를 저장소에 절대 커밋하지 마세요.

- run: npm run deploy
  env:
    DEPLOY_TOKEN: ${{ secrets.DEPLOY_TOKEN }}
    AWS_ACCESS_KEY_ID: ${{ secrets.AWS_ACCESS_KEY_ID }}

브랜치 보호 규칙

Settings → Branches에서 main에 병합하기 전에 CI 워크플로가 통과하도록 설정하세요. 필수 검토와 함께 사용하면 표준적인 팀 보호 장치가 됩니다.

빠른 확인

GitHub Actions 워크플로의 동시성 블록에서 cancel-in-progress: true를 사용하는 목적은 무엇인가요?

복습: 프론트엔드를 위한 GitHub Actions

워크플로 YAML은 .github/workflows/에 저장합니다. 푸시 또는 PR이 생성되면 작업이 실행됩니다. setup-node를 사용해 node_modules를 캐시하세요. 표준 작업은 린트, 유형 검사, 테스트, 빌드입니다. 순서가 필요하면 needs를 사용해 병렬로 실행하세요. 여러 버전을 테스트할 때는 매트릭스를 사용하세요. 저장소 설정을 통해 비밀 정보를 관리하세요. 브랜치 보호를 설정하면 병합 전에 CI가 통과해야 합니다. cancel-in-progress를 사용하면 중복 실행을 제거할 수 있습니다.

자주 묻는 질문

“프런트엔드를 위한 GitHub Actions: 린트, 테스트, 빌드” 강의는 무료인가요?

네 — “프런트엔드를 위한 GitHub Actions: 린트, 테스트, 빌드” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 Frontend Academy 강의 전체를 잠금 해제할 수 있습니다. Frontend Academy 강의에는 총 4개의 강의가 포함되어 있습니다.

“프런트엔드를 위한 GitHub Actions: 린트, 테스트, 빌드”에서 뭘 배우나요?

종속성을 설치하고 ESLint를 실행하며 Jest 테스트를 수행하고 모든 pull request에서 앱을 빌드하는 workflow YAML을 작성합니다. 브라우저에서 직접 실행하는 실습 코드로 Frontend Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.

Frontend Academy을(를) 시작하는 데 경험이 필요한가요?

사전 경험은 필요하지 않습니다. CoddyKit의 Frontend Academy은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 1번째 강의입니다.

“프런트엔드를 위한 GitHub Actions: 린트, 테스트, 빌드” 강의는 얼마나 걸리나요?

대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.

이 Frontend Academy 강의에서 코드를 작성하고 실행할 수 있나요?

네. 모든 Frontend Academy 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.

이 강의의 모든 강의

프런트엔드를 위한 GitHub Actions: 린트, 테스트, 빌드
Vercel, Netlify 및 Cloudflare Pages에 배포
CI의 환경 변수
Lighthouse 자동 검사

← Frontend Academy(으)로 돌아가기