🎯 인수테스트에 대해 정리합니다.

📗 Today I Learned

인수 테스트 (UAT)

인수테스트(UAT; User Acceptance Test)는 기능이 요구사항 (requirement) 대로 기능이 구현되었는지를 사용자 관점에서 검증하는 절차입니다.

이는 전체 시스템을 사용자 관점에서 시험하는 블랙박스 테스트를 포함하고, 시스템이 ‘기능적으로’ 잘 동작하는지만이 아니라, 사용자가 실제로 사용할 수 있을 수준인지를 확인하는 데 중점을 둡니다.

🤔 인수 테스트 왜 자동화가 어려울까?

• 사용자 참여 필요 : 기술적 측면과 비기술적 측면에 대한 요구사항의 최종 확인은 실사용자여야 합니다.
• 의존성 통합 실행 : 테스트 시점에 애플리케이션이 실제 환경처럼 모든 의존성 서비스와 함께 실행되어야 합니다.
• 스테이징 환경 구축 필요 : 테스트는 반드시 프로덕션과 최대한 동일한 환경(스테이징)에서 이루어져야 합니다.
• 애플리케이션 동일성 보장 : 프로덕션에 배포될 애플리케이션과 완전히 동일한 빌드 결과물(바이너리)을 사용해야 합니다.
• 릴리스 준비 : 인수 테스트를 통과한 결과물은 바로 릴리스할 수 있는 품질을 갖추고 있어야 합니다.

아티팩트 리포지토리 (Artifact Repository)

위에서 언급한 “동일한 바이너리 사용”을 보장하기 위해 꼭 필요한 요소가 바로 아티팩트 리포지토리📦 입니다.

소프트웨어 개발 과정에서 생성되는 패키지, 바이너리, 라이브러리 등 결과물을 저장,관리,배포할 수 있는 중앙 저장소를 말합니다.

버전 관리, 접근 제어, 이력 추적 등 다양한 기능을 제공하며, CI/CD 파이프라인의 각 단계가 동일한 아티팩트를 사용할 수 있게 해줍니다.

도커 레지스트리 (Docker Registry)

오늘날 많은 애플리케이션은 컨테이너 기반으로 운영되며, 이 경우 아티팩트는 일반적인 패키지가 아니라 도커 이미지(Docker Image)입니다.

도커 이미지를 저장하고 관리하는 전용 아티팩트 저장소가 바로 도커 레지스트리(Docker Registry)입니다.

도커 레지스트리 종류

• 클라우드 방식 레지스트리

  • Docker Hub

  • AWS ECR

  • GCP Artifact Registry

  • Azure Container Registry 등

• 자체 호스팅 방식 레지스트리

  • 조직 내부 보안 정책상 외부 저장소 사용이 불가능한 경우 사용합니다.

  • 직접 클러스터 내에 레지스트리를 설치하고 운영해야 합니다.

    • 인증, 접근 제어, TLS 구성 등을 수동으로 처리해야 하며, 관리 부담이 큽니다.

Jenkins 파이프라인에서의 인수 테스트

1. 개발자가 변경한 코드를 GitHub에 푸시

2. Jenkins가 변경을 감지하고 코드를 인출해 빌드를 시작, 코드 점검(단위테스트 수행)

3. Jenkins가 빌드를 완료하여 도커 이미지를 생성

4. Jenkins가 생성한 이미지를 레지스트리로 푸시

5. Jenkins가 스테이징 환경을 구성하고 도커 컨테이너 실행

6. 스테이징 환경의 도커 호스트가 이미지를 가져다가(Pull) 컨테이너를 실행

7. Jenkins가 스테이징 환경에서 실행 중인 애플리케이션을 대상으로 인수 테스트를 실행
   출처: oreilly

---

사용자-대면 테스트

코드 단위에서 기능이 잘 작동하는 것과 사용자 입장에서 그 기능이 제대로 전달되는 것은 전혀 다른 이야기입니다.

예를 들어, REST API는 curl 명령어로 테스트할 수 있지만, 비개발자인 실제 사용자나 사업부서 담당자 입장에서는 그 결과를 읽고 이해하기가 어렵습니다.

또한 이런 식의 테스트는 코드가 바뀔수록 갱신하기 어려워 유지보수에도 취약합니다.

그래서 사용자와 함께 작성하고, 누구나 이해할 수 있는 형태의 테스트 방식이 필요해집니다. 이런 배경에서 등장한 것이 바로 BDD와 TDD입니다.

BDD (Behavior-Driven Development)

BDD는 기능 요구사항을 사용자 또는 프로덕트 오너의 언어로 표현하고, 이를 테스트로 연결하는 방식입니다.

• 사용자 또는 PM이 인수 기준을 명확히 정의합니다.

• 개발자는 해당 기준에 맞춰 테스트 시나리오를 작성합니다.

• 자연어에 가까운 DSL(Domain-Specific Language)로 시나리오 작성합니다.

TDD (Test-Driven Development)

TDD는 테스트를 먼저 작성하고, 테스트를 통과할 수 있는 코드를 구현하는 개발 방법론입니다.

• 인수 기준을 테스트로 먼저 작성하여 테스트 통과를 기능 구현 완료로 간주합니다.

  • 이슈 트래킹 시스템(예: Jira)의 기능 요청에 인수 사양을 포함시키는 방식도 있습니다.

---

✏️ 회고

TDD를 많이 들었었는데 실제로 개념을 알고나니 테스트를 먼저 작성하고, 코드를 구현하는 방법이라는 것을 보통 생각했던 방법이 아니라서 신기했다.