아키텍처
API Management Platform 개발기: API 관리를 위한 플랫폼의 효율화 여정
두줄요약
API 관리 플랫폼을 Version 1부터 3까지 발전시키며 셀프서비스와 자동화를 중심으로 재설계했습니다. 개발자 생산성과 운영 효율을 높이고 Gateway 독립성과 확장성도 확보했습니다.
핵심 내용
- API 관리 플랫폼의 발전 과정을 Version 1~3로 정리하며, 중앙 집중 관리에서 플랫폼 엔지니어링 기반 셀프서비스 구조로 전환한 여정
- 개발자 생산성, 운영 효율성, 비용 절감을 목표로 API 배포·모니터링·보안 관리를 통합한 플랫폼 설계
- 핵심 구조는 Management Plane, Data Plane, User Plane의 3계층과 Synchronizer, Gateway, Storage, Portal로 구성
- Gateway 독립성을 위한 Proxy Spec 추상화, 해시 기반 변경 감지, Kubernetes 친화적 배포 구조가 주요 설계 포인트
구조와 흐름
- Organization, Environment, Proxy, Key, Group, User를 중심으로 API 관리 도메인 구성
- API Design부터 Development, Testing, Deployment, Operation and Monitoring, Decommissioning까지 전 생애주기 관리
- Data Plane은 Gateway와 Synchronizer로 트래픽 처리와 API 동기화를 분리하고, Management Plane이 중앙 제어 역할 수행
선택 이유
- 운영팀 의존과 수동 배포로 인한 느린 반영, 휴먼 에러, 기능 한계를 해결하기 위한 셀프서비스 지향
- 전용 Synchronizer의 Pull 모델과 최종 일관성 모델로 장애 격리와 유연한 스케일링 확보
- 전략 패턴 기반 Transformer로 Gateway 구현체 종속성을 줄이고 확장성 확보
성능/운영 포인트
- API 배포 시간 1~2일에서 5분으로 단축
- API 명세 작성량 약 700줄 JSON에서 15개 필드 입력으로 감소
- 운영팀 업무 80% 이상 감소, 연간 상용 솔루션 라이선스 비용 100% 절감