GitHub Actions로 CI/CD 파이프라인 구축하기

GitHub Actions란

저장소에 YAML 워크플로우 파일을 두면, 코드 푸시나 PR 같은 이벤트가 발생할 때 자동으로 빌드·테스트·배포 작업을 실행해주는 CI/CD 플랫폼입니다. 별도의 CI 서버를 직접 운영할 필요가 없습니다.

기본 워크플로우 파일 위치

.github/workflows/ 디렉토리 아래에 YAML 파일을 두면 자동으로 인식됩니다.

예제 — push 시 테스트 자동 실행

# .github/workflows/ci.yml
name: CI
on:
  push:
    branches: [main]
jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: 20
      - run: npm install
      - run: npm test

배포 단계 추가

테스트 job이 성공한 뒤에만 실행되도록 needs로 의존성을 지정합니다.

  deploy:
    needs: test
    runs-on: ubuntu-latest
    steps:
      - run: echo "여기에 배포 스크립트 실행"

시크릿 관리

배포용 API 키나 서버 접속 정보는 워크플로우 파일에 직접 쓰지 않고, 저장소 Settings → Secrets에 등록한 뒤 ${{ secrets.MY_KEY }} 형태로 참조합니다.