개발자의 "어디 있지?"를 해결하는 마법, Backstage에 대해 알아보겠습니다.

현대 마이크로서비스(MSA) 환경에서 개발자는 수많은 서비스와 도구의 바다에 빠지기 일쑤입니다. "이 API 문서 어디 있어요?", "이 서비스 장애나면 누구한테 연락하죠?" 같은 질문에 지친 팀을 위한 구원투수, Backstage를 소개합니다.

Ⅰ. Backstage란 ?

"분산된 마이크로서비스, 인프라, 문서를 단 하나의 화면(Single Pane of Glass)에서 관리하는 개발자 전용 허브" 로 Spotify가 사내 개발자들의 혼란을 해결하기 위해 개발한 오픈소스 개발자 포털(IDP) 프레임워크입니다.

Ⅱ.  Backstage 핵심 기능 3가지

기능명	역할	효과
소프트웨어 카탈로그	모든 서비스와 API의 '호적부' 관리	소유 팀 및 의존 관계 즉시 파악
소프트웨어 템플릿	표준화된 프로젝트 '붕어빵 틀'	클릭 몇 번으로 표준 보안/CI 적용 서비스 생성
TechDocs	코드와 함께 관리되는 문서 (Docs-like-code)	코드 수정 시 문서 자동 업데이트 및 통합 조회

Ⅲ.  Backstage 시스템 구성 및 아키텍처

마치 레고 블록처럼 플러그인을 끼워 맞추는 구조로 되어 있습니다.

계층	기술	역할	주요 기능	핵심특징
Frontend	React	사용자 인터페이스(UI) 제공	서비스 카탈로그 CI/CD 상태 확인 문서(TechDocs) 조회	모든 개발 도구를 하나의 화면으로 통합
Backend	Node.js	API 처리 및 시스템 연동	GitHub, AWS, Kubernetes 연동 인증/권한 관리	Frontend와 외부 시스템을 연결하는 허브
Database	PostgreSQL	데이터 저장 및 관리	서비스 카탈로그 메타데이터 사용자 정보 저장	Backstage의 상태 및 구조 정보 저장
Extensibility	Plugins	기능 확장	CI/CD, 모니터링, 문서 관리 등 다양한 기능 추가	레고 블록처럼 조립 가능, 무한 확장

 Ⅳ. 기존 방식 vs Backstage 도입 후

도입 전후의 변화를 비교하면 그 가치가 더욱 명확해집니다.

상황	기존방식(Before)	Backstage 도입 후 (after)
담당자 찾기	슬랙 채널에 "이거 누구 건가요?" 질문	카탈로그에서 검색 후 즉시 확인
서비스 생성	메뉴얼 보고 일일이 수동 설정	템플릿 클릭 한 번으로 자동 배포
문서 탐색	노션, 컨플루언스, 위키 뒤지기	포털 내 TechDocs에서 통합 검색
인프라 모니터링	Datadog, AWS, K8s 대시보드 순회	포털 한 화면에서 모든 상태 모니터링

Ⅴ . 도입 전 체크리스트

 ⅰ. 추천 조직

   1) 운영 중인 마이크로서비스가 수십~수백 개에 달하는 조직

   2) 신규 입사자가 도구 파악에만 일주일 넘게 걸리는 팀

   3) 개발 표준화와 셀프서비스 인프라 구축이 절실한 기업

 ⅱ. 주의 사항

   1) 높은 초기 비용: 우리 회사에 맞게 플러그인을 설정하는 엔지니어링 시간이 필요합니다.

   2) 운영 부담: SaaS가 아닌 직접 설치형(Self-hosted)이므로 유지보수 인력이 필요합니다.

   3) 소규모 팀 주의: 관리할 서비스가 몇 개 없다면 오히려 배보다 배꼽이 더 클 수 있습니다.