Read Original
#Backend

[코드가 환경을 모르는 구조 7/7] Variant와 스냅샷 캐시, 그리고 다섯 축의 총합

[코드가 환경을 모르는 구조 7/7] Variant와 스냅샷 캐시, 그리고 다섯 축의 총합
01

Summary

CI 시간 10분에서 2분으로! 'Variant'와 '스냅샷 캐시'로 완성하는 초고속 테스트 인프라

컨테이너 재사용을 넘어 스키마 초기화 비용까지 제로로 만드는 시니어 엔지니어의 설계 전략

본 아티클은 '코드가 환경을 모르는 구조' 시리즈의 최종장으로, 테스트 인프라 최적화의 정수를 다룹니다. 컨테이너 공유 단위인 Variant 정의와 스키마 초기화 오버헤드를 제거하는 스냅샷 캐싱 기법을 통해, 단순한 속도 개선을 넘어 팀의 엔지니어링 문화를 어떻게 변화시키는지 상세히 설명합니다.

  • 01Variant 데이터 클래스를 활용한 명확한 컨테이너 공유 및 격리 메커니즘
  • 02Liquibase 초기화 과정을 스킵하는 지능형 스냅샷 캐시 키 해싱 전략
  • 03CQRS 및 CDC 환경을 위한 프로덕션 복제형 테스트 인프라 구성
  • 04배포·클라우드·시간·공간·테스트라는 다섯 가지 축의 설계 대칭성 통찰
  • 05빠른 피드백 루프가 엔지니어의 가설 검증 비용과 실험의 수에 미치는 영향

RECOMMENDATION

대규모 멀티모듈 환경에서 통합 테스트 속도로 인해 개발 생산성이 저하된 팀에게 필독을 권하며, 특히 DB 초기화 비용을 획기적으로 줄이고 싶은 백엔드 리드급 엔지니어에게 유용한 가이드를 제공합니다.

The Problem

멀티모듈 프로젝트에서 도메인마다 상이한 DB 스키마와 버전(MySQL 8.0 vs 8.4)을 요구하며, 매 테스트마다 Liquibase를 통해 전체 스키마를 초기화하는 과정에서 빌드 성능이 심각하게 저하되는 문제를 해결하고자 합니다.

The Solution

컨테이너의 이미지, 스크립트, 설정을 규정하는 'Variant' 개념을 도입하여 모듈 간 컨테이너 공유 경계를 정의하고, Variant 설정과 Liquibase 변경 내역을 해싱하여 이미 초기화된 DB 상태를 복원하는 '스냅샷 캐시' 시스템을 구축했습니다.

The Result

통합 테스트 빌드 시간을 10분에서 2분으로 약 80% 단축하는 정량적 성과를 거두었으며, 빠른 피드백 루프를 통해 개발자가 컨텍스트를 유지하며 작업할 수 있는 질적 변화와 팀 전체의 테스트 신뢰도 향상을 이끌어냈습니다.

Trade-off

캐시 키 생성 시 이미지 태그나 환경 변수 등 Variant의 정체성을 결정하는 요소가 하나라도 누락될 경우, 변경된 환경에서도 구버전 스냅샷이 복원되어 원인 파악이 어려운 테스트 실패를 유발할 수 있는 운영상의 정교함이 요구됩니다.

03

Key Concepts

Concept · 01

Variant

특정 컨테이너의 이미지 버전, 초기화 스크립트, 환경 변수 조합을 식별하는 값 객체입니다.

  • 필드 조합이 동일하면 하나의 컨테이너를 공유하고, 다르면 별도의 BuildService 인스턴스를 생성하는 기준으로 활용됩니다.
  • 동일한 이미지라도 초기화 스크립트가 다르면 다른 Variant로 취급하여 독립적인 환경을 보장합니다.
Concept · 02

Snapshot Cache

이미 초기화가 완료된 데이터베이스의 상태를 스냅샷 형태로 저장하고 재사용하는 기술입니다.

  • Liquibase changelog 파일들의 내용과 컨테이너 설정값을 조합한 해시를 키로 사용합니다.
  • 캐시 적중 시 Liquibase 실행 과정을 건너뛰고 스냅샷을 즉시 복원하여 초기화 오버헤드를 제거합니다.
Concept · 03

Five Axes of Abstraction

배포(Helm), 클라우드(Adapter), 시간(Clock), 공간(Routing), 테스트(Variant)를 관통하는 설계 원칙입니다.

  • 핵심 비즈니스 로직과 외부 환경의 경계를 깎아 교체 가능한 구조를 만드는 일관된 사고방식을 의미합니다.
  • 이러한 대칭적 설계는 AI 에이전트가 코드를 더 잘 이해하게 만드는 'AI-ready' 환경의 기반이 됩니다.