Pact

개요

Pact는 마이크로서비스 환경에서 서비스 간 통신 계약(API Contract)을 코드로 정의하고, 이를 기반으로 생산자(Producer)와 소비자(Consumer) 간의 상호 기대를 자동 검증할 수 있게 해주는 오픈소스 계약 기반 API 테스트 프레임워크이다.

---

1. 개념 및 정의

항목	설명
정의	소비자 중심의 계약(Contract)을 기반으로 API 동작을 검증하는 오픈소스 테스트 프레임워크
주요 목적	마이크로서비스 간 통신 안정성 확보, 계약 위반 사전 감지
구성 모델	Consumer → Pact 정의 → Pact Broker → Provider 검증

Pact는 Producer와 Consumer 간 사양 불일치로 인한 장애를 방지하는 데 핵심적인 역할을 수행한다.

---

2. 특징

특징	설명	기존 방식과 차이점
소비자 중심 계약 정의	테스트는 소비자의 기대를 기준으로 작성됨	API 문서 기반 검증보다 현실적인 시나리오 반영
Pact 파일 기반 테스트 공유	JSON 형태의 계약 파일로 양방향 테스트 가능	Swagger 등 사양 기반 일방향 테스트와 다름
Pact Broker 연동	계약 파일의 버전 관리 및 테스트 상태 공유	Git 외 별도 계약 저장소 운영 가능

Pact는 계약 그 자체가 테스트 케이스로 기능한다.

---

3. 구성 요소

구성 요소	설명	예시
Pact Contract (JSON)	소비자의 요청과 기대 응답을 JSON으로 정의	GET /orders → 200 + JSON 목록
Consumer Test	MockProvider 기반 요청 → 응답 시뮬레이션	Jest, JUnit, Mocha 등 테스트 프레임워크 사용
Provider Verification	Pact 파일과 실제 Provider 응답 비교 테스트	pact-verifier CLI로 서버 검증 수행
Pact Broker	계약 파일 저장소 및 테스트 상태 공유 서비스	GitHub, self-hosted, cloud broker 등 지원

Pact의 테스트 흐름은 Consumer → Broker → Provider → CI에 자연스럽게 통합된다.

---

4. 기술 요소 및 통합성

기술	설명	활용 예시
언어별 SDK 지원	Java, JS, Python, Go, .NET 등 지원	pact-js, pact-jvm, pact-go 등
CI/CD 연동	GitHub Actions, GitLab CI, Jenkins 등과 연계	Contract 생성 및 검증을 파이프라인에 포함
Pactflow 연계	Pact 공식 클라우드 SaaS 서비스	Broker 기능 + 분석 + 보안 제공
Bi-Directional Contract	OpenAPI ↔ Pact 쌍방향 비교 가능	Swagger-to-Pact 변환 및 역검증

팀 내 언어 혼용 환경에서도 적용 가능하다.

---

5. 장점 및 기대 효과

장점	설명	효과
사전 장애 방지	Producer ↔ Consumer 간 기대 불일치 조기 검출	배포 실패, 통신 오류 최소화
변경 영향도 파악	계약 변경 시 어떤 Consumer에 영향 있는지 확인 가능	릴리즈 계획 수립에 도움
마이크로서비스 신뢰도 향상	테스트 기반 통신 계약 보장	운영 안정성 증가 및 장애 트러블슈팅 감소

Pact는 마이크로서비스 CI/CD의 안정성과 신뢰성을 강화한다.

---

6. 주요 활용 사례 및 고려사항

사례	설명	고려사항
API 변경 시 릴리즈 전 검증	신규 API가 기존 Consumer와 호환되는지 확인	Pact Broker 내 계약 최신화 필요
서비스 간 상호 작용 시뮬레이션	실제 배포 없이 Mock 기반 통합 테스트 가능	소비자 기대가 정확히 명시되어야 함
다국적 팀 간 계약 공유	전 세계 팀 간 API 사양 교환	계약 파일 버전 관리 정책 필요

초기 도입 시 Pact 작성 패턴과 팀 간 협약이 중요하다.

---

7. 결론

Pact는 마이크로서비스 환경에서 안정적인 API 연동을 위한 계약 기반 테스트 프레임워크로, Consumer 주도 계약 정의, 양방향 테스트, Pact Broker 기반 공유 구조를 통해 서비스 간 통신 신뢰성과 협업 효율을 극대화한다. Contract-First API 개발 전략과 결합하면, 전체 서비스 품질을 근본적으로 끌어올릴 수 있다.