피드로 돌아가기
Dev.toDevOps
원문 읽기
Building a Complete CI/CD Pipeline for Node.js TypeScript Project, A Step-by-Step Guide
Node.js TypeScript 프로젝트에서 GitHub Actions, Jest, Docker를 통합하여 테스트·빌드·배포를 완전 자동화한 CI/CD 파이프라인 구축
AI 요약
Context
개발자가 CI/CD 파이프라인 도입 시 GitHub Actions, Docker, 테스팅, 린팅 등 여러 도구를 함께 구성해야 하는 복잡성에 직면했다. 각 도구의 역할과 연계 방식이 명확하지 않아 초기 학습 곡선이 가팠다.
Technical Solution
- TypeScript 설정: tsconfig.json에서 ES2022 타겟, CommonJS 모듈, strict 모드 활성화로 Node.js 호환성 및 타입 안정성 확보
- Jest 기반 테스트: supertest를 활용한 API 엔드포인트 테스팅, 함수/라인/문 커버리지 70% 임계값 설정
- 코드 품질 도구: ESLint와 Prettier를 통해 린팅 및 자동 포맷팅 적용
- Git 훅 통합: husky와 lint-staged로 커밋 전 코드 검사 및 테스트 실행
- GitHub Actions 워크플로우: 모든 푸시에 대해 컴파일, 린팅, 테스트, 빌드를 순차 실행
- Docker 멀티스테이지 빌드: TypeScript 컴파일 스테이지와 프로덕션 이미지 생성 스테이지를 분리
- 자동 Docker 이미지 배포: CI/CD 파이프라인에서 빌드된 이미지를 컨테이너 레지스트리에 자동 푸시
Key Takeaway
Node.js TypeScript 프로젝트에서 TypeScript 컴파일러 설정, Jest 커버리지 임계값 적용, Git 훅, GitHub Actions 워크플로우, Docker 멀티스테이지 빌드를 조합하면 수동 배포 단계를 제거하고 코드 변경 시 자동으로 검증 및 배포되는 시스템을 구축할 수 있다.
실천 포인트
Node.js TypeScript 프로젝트를 시작하는 팀에서 tsconfig.json의 strict: true와 target: ES2022를 적용하고, Jest 커버리지 임계값을 70% 이상으로 설정한 후, GitHub Actions에서 npm run lint → npm run test → npm run build 순서로 실행하고 최종 단계에서 Docker 이미지를 빌드·푸시하면, 모든 코드 변경이 자동으로 검증되고 테스트를 통과한 것만 배포되도록 보장할 수 있다.