수천 개의 API/Batch 서버를 하나의 설정 체계로 관리하기
·2026.01.09 13:43
토스페이먼츠는 오버레이 아키텍처와 템플릿 패턴을 통해 수천 개의 API 및 배치 서버 설정을 안전하게 관리한다.
설정 파일의 작은 오타 하나가 수십억 원 규모의 정산 오류와 같은 심각한 인프라 장애로 이어질 수 있다. 특히 수천 개의 API 및 Batch 서버를 운영하는 환경에서는 설정 중복이 버그와 장애의 주요 원인이 된다.
이를 해결하기 위해 **오버레이 아키텍처(Overlay Architecture)**를 도입했다. 설정값을 global, cluster, phase, application과 같은 계층으로 나누어 관리하며, 하위 계층으로 갈수록 높은 우선순위를 갖도록 설계하여 중복을 방지한다.
또한, 긴 문자열 내의 특정 값만 수정하기 어려운 문제를 해결하고자 **템플릿 패턴(Template Pattern)**을 적용했다. {{MAX_HEAP}}과 같은 변수를 활용해 설정값 내에 값을 채워 넣는 방식을 사용함으로써, 설정의 유연성을 확보하고 오타로 인한 위험을 최소화했다.
이 요약은 원문 이해를 돕기 위한 큐레이션입니다. 저작권은 원저작자에게 있으며, 정확한 내용과 맥락은 원문을 확인하세요.
요약 오류, 출처 표기 문제, 삭제 요청은 문의 · 건의로 알려주세요.