🤖 자동화된 테스트 실행 환경

이 프로젝트는 GitHub Actions 를 사용하여 자동화된 테스트 환경을 제공해요. 이는 코드가 병합되고 배포되기까지의 과정에서 다양한 테스트를 실행함으로써 코드의 품질을 유지하고, 배포 전에 문제가 발생하지 않도록 사전에 인지하고 해결하기 위함이에요.

🔄 워크플로우 구성 (.github/workflows/test.yml)

이 워크플로우는 다양한 테스트 잡(job)으로 구성되어 있으며, 각 잡은 다음과 같은 역할을 합니다.

요약

1. unit-test

• 의존성 설치, 빌드, 단위 테스트, 커버리지 리포트 생성을 담당합니다.
• Turbo, node_modules, dist, 테스트 커버리지 등 다양한 캐시를 활용하여 빌드/테스트 속도를 높입니다.
• 테스트 결과와 커버리지 리포트, 빌드/테스트 로그를 아티팩트로 업로드합니다.

2. set-docker-compose

• 도커 기반 통합 테스트 환경을 위한 docker-compose.gha.yaml 파일을 변환 및 캐싱합니다.
• 이후 E2E, Lighthouse, Storybook 테스트에서 공통으로 활용됩니다.

3. lighthouse-test

• 웹앱과 Lighthouse 테스트용 이미지를 도커로 빌드하고, Lighthouse CI를 통해 웹 접근성/성능/SEO 등을 자동 점검합니다.
• temporary-public-storage 에 테스트 결과를 업로드하고, 리포트를 PR 에 첨부합니다.

4. e2e-web

• 웹앱과 Playwright 기반 E2E 테스트 이미지를 도커로 빌드하고, 실제 브라우저 환경에서 통합 테스트를 수행합니다.
• 테스트 결과(junit.xml)를 아티팩트로 업로드합니다.

5. storybook-test

• Storybook 및 Storybook 테스트 러너 이미지를 도커로 빌드하고, Storybook 기반 UI 컴포넌트 접근성/테스트를 자동화합니다.
• 접근성 리포트(a11y-audit)를 아티팩트로 업로드합니다.

🔁 자동화 흐름 요약

1. 단위 테스트: 코드 변경 시 가장 먼저 실행되어 빠르게 피드백을 제공합니다.
2. 도커 환경 준비: 통합 테스트를 위한 도커 컴포즈 파일을 변환/캐싱합니다.
3. 통합 테스트: E2E, Lighthouse, Storybook 테스트가 병렬로 실행되어 실제 서비스 환경과 유사하게 검증합니다.
4. 아티팩트 업로드: 각 테스트 결과물(커버리지, 리포트 등)은 GitHub Actions의 아티팩트로 업로드되어 추후 확인할 수 있습니다.

💾 캐시 전략

• Turbo, node_modules, dist, 테스트 커버리지, docker-compose 변환 파일 등 다양한 캐시를 적극 활용하여 워크플로우 실행 속도를 최적화합니다.

🐳 도커 기반 통합 테스트 환경

• E2E, Lighthouse, Storybook 테스트는 실제 서비스와 유사한 환경을 도커 컨테이너로 구성하여 신뢰도 높은 테스트를 보장합니다.
• 도커 컴포즈 파일(docker-compose.gha.yaml)을 사용하여 필요한 서비스(웹, Playwright, Lighthouse, Storybook 등)를 컨테이너로 띄웁니다.
• 각 테스트 컨테이너는 별도의 네트워크(test_network)에서 실행되어 서비스 간 통신이 원활하게 이뤄집니다.

📌 참고

• 각 잡의 상세 스크립트 및 설정은 .github/workflows/test.yml 파일을 참고하세요.
• 테스트 결과물은 GitHub Actions의 “Artifacts”에서 다운로드할 수 있습니다.