Mock 중심 테스트만으로는 운영 장애를 막기 어렵습니다. DB/캐시를 실제 컨테이너로 띄우는 통합 테스트를 기본 체계에 포함해야 합니다.

왜 이 조합인가

  • Ginkgo: 시나리오 가독성(BDD 구조)
  • Testcontainers: 격리된 실환경 의존성 제공

기본 구조

  1. BeforeSuite: 컨테이너 기동 + 연결 확인
  2. BeforeEach: 데이터 초기화
  3. It: 비즈니스 시나리오 실행
  4. AfterSuite: 컨테이너 정리

핵심 원칙

  1. 테스트는 “행동” 기준으로 작성
  2. 컨테이너 초기화 실패를 즉시 fail-fast
  3. 재시작/타임아웃/네트워크 지연 시나리오 포함
  4. CI에서 병렬 실행 시 리소스 한도 명시

실무 팁

  • 컨테이너 재사용 옵션은 속도엔 좋지만, 상태 오염 방지 전략이 있어야 합니다.
  • 로컬과 CI의 Docker 차이를 줄이기 위해 버전 고정을 권장합니다.
  • flaky 테스트는 즉시 원인 추적하고 격리해야 합니다.

결론

통합 테스트의 목적은 커버리지 숫자가 아니라 “운영에서 터질 문제를 배포 전에 잡는 것”입니다. 최소 한 개의 골든 경로와 한 개의 실패 경로를 항상 자동화해 두세요.