오늘의 기술 토픽

Internal Developer Platform (IDP)

이번 글은 특정 밋업 발표가 아니라 Internal Developer Platform(IDP)이라는 주제를 중심으로 정리한 기술 브리프입니다. IDP는 개발자가 인프라를 직접 다루지 않고도 애플리케이션을 배포·운영할 수 있도록 표준화된 셀프서비스 환경을 제공하는 개념으로, 최근 플랫폼 엔지니어링(Platform Engineering) 트렌드의 핵심입니다. Backstage, Crossplane, Score 같은 도구들이 IDP를 실제로 구현하는 데 쓰이며, Kubernetes 생태계와 밀접하게 연결되어 있습니다. 이 브리프는 개념 이해부터 실습까지 이어지는 학습 경로를 제시합니다.

🔑 핵심 요점

  • IDP는 개발자 셀프서비스를 위해 인프라 복잡성을 추상화한 내부 플랫폼이다.
  • 플랫폼 엔지니어링 팀은 IDP를 ‘제품’처럼 설계하고 운영한다는 사고방식을 취한다.
  • Backstage는 IDP의 포털(프론트엔드) 역할을 하는 대표적인 오픈소스 도구다.
  • Crossplane 같은 Kubernetes 기반 제어 플레인은 IDP의 프로비저닝 백엔드로 자주 쓰인다.
  • Score는 애플리케이션 명세를 선언적으로 작성해 어떤 플랫폼에도 배포할 수 있게 해주는 표준을 지향한다.
  • IDP 도입의 핵심은 황금 경로(Golden Path)를 제공해 개발자의 인지 부하를 줄이는 것이다.

🛠 핵심 기술 쉽게 이해하기

Internal Developer Platform (IDP)

IDP는 조직 내부 개발자가 애플리케이션을 배포, 모니터링, 운영하는 과정을 표준화된 셀프서비스 방식으로 제공하는 플랫폼을 말합니다. 쿠버네티스, CI/CD, 클라우드 리소스 같은 복잡한 하부 시스템을 개발자가 직접 다루지 않도록 추상화 계층을 제공합니다.

왜 필요한가 — 개발자가 매번 인프라 지식을 익히지 않고도 빠르게 배포할 수 있게 하고, 플랫폼 팀이 보안·거버넌스 정책을 일관되게 적용할 수 있게 하기 위해 사용합니다.

발표에서는 — 이 브리프의 중심 주제로, IDP의 개념과 등장 배경, 그리고 이를 구성하는 도구들을 소개합니다.

Backstage

Backstage는 Spotify가 만들고 CNCF에 기증한 오픈소스 프레임워크로, 여러 서비스와 도구를 하나의 포털(UI)에서 검색하고 관리할 수 있게 해줍니다. 소프트웨어 카탈로그, 템플릿, 문서를 한곳에 모아 보여줍니다.

왜 필요한가 — 조직 내에 흩어진 서비스와 문서를 한 곳에서 찾을 수 있게 해 개발자 온보딩과 서비스 탐색 시간을 줄이기 위해 사용합니다.

발표에서는 — IDP를 구현할 때 가장 널리 쓰이는 포털 계층 도구로 언급됩니다.

Crossplane

Crossplane은 Kubernetes API를 확장해 클라우드 인프라(데이터베이스, 네트워크 등)를 쿠버네티스 리소스처럼 선언적으로 관리할 수 있게 해주는 오픈소스 프로젝트입니다. 클라우드 제공자별 API 대신 하나의 통일된 인터페이스로 리소스를 생성합니다.

왜 필요한가 — 개발자가 클라우드별 세부 설정을 몰라도 표준화된 매니페스트로 인프라를 요청할 수 있게 하기 위해 사용합니다.

발표에서는 — IDP의 프로비저닝(백엔드) 계층을 구현하는 대표적인 선택지로 소개됩니다.

Score

Score는 애플리케이션의 워크로드 요구사항(환경변수, 리소스, 의존성 등)을 플랫폼에 종속되지 않는 방식으로 선언하는 명세 포맷입니다. 하나의 Score 파일로 여러 플랫폼에 변환해 배포할 수 있습니다.

왜 필요한가 — 개발자가 작성한 배포 명세가 특정 플랫폼 구현에 묶이지 않도록 해 플랫폼 교체나 멀티 플랫폼 지원을 쉽게 하기 위해 사용합니다.

발표에서는 — IDP의 개발자 인터페이스를 표준화하려는 최근 움직임의 예시로 언급됩니다.

🧭 추구 방향과 흐름

  • 플랫폼을 제품으로 바라보는 사고방식 (Platform as a Product) — 플랫폼 엔지니어링 커뮤니티는 IDP를 단순한 내부 도구가 아니라 개발자를 고객으로 보는 ‘제품’으로 취급하는 방향으로 나아가고 있습니다. 이는 사용성, 문서화, 피드백 루프를 제품 개발처럼 관리해야 한다는 관점을 포함합니다.
  • 셀프서비스와 황금 경로(Golden Path) — 개발자가 플랫폼 팀에 티켓을 올리지 않고도 표준화된 템플릿과 워크플로를 통해 스스로 리소스를 생성하고 배포할 수 있게 하는 방향입니다. 이를 통해 인지 부하를 줄이고 반복 작업을 자동화합니다.
  • 쿠버네티스 중심 제어 플레인 확산 — Crossplane처럼 Kubernetes API를 범용 제어 플레인으로 확장해 클라우드 리소스, 애플리케이션, 정책을 하나의 선언적 모델로 통합하는 흐름이 강화되고 있습니다.
  • 플랫폼 명세의 표준화 — Score와 같이 플랫폼 구현과 독립된 애플리케이션 명세 표준을 만들어 벤더 종속을 줄이고 여러 IDP 구현 간 상호운용성을 높이려는 움직임이 나타나고 있습니다.

🚀 바로 활용하기

  1. Backstage 공식 문서의 Getting Started 가이드를 따라 로컬에서 Backstage 인스턴스를 띄워본다.
  2. Crossplane을 로컬 Kubernetes 클러스터(kind, minikube 등)에 설치하고 간단한 Provider로 리소스를 하나 선언해본다.
  3. platformengineering.org에서 IDP와 플랫폼 엔지니어링의 기본 개념을 다룬 글을 읽어본다.
  4. Score 명세로 간단한 애플리케이션을 정의하고 score-k8s CLI로 로컬에 배포해본다.

🔗 참고 자료

  • Backstage — IDP 포털 계층 구현에 널리 쓰이는 오픈소스 프레임워크 공식 문서
  • Crossplane — Kubernetes 기반 인프라 프로비저닝 제어 플레인 공식 홈페이지
  • CNCF — Backstage, Crossplane 등 IDP 관련 프로젝트들을 호스팅하는 재단
  • Kubernetes — 대부분의 IDP 구현이 기반으로 삼는 컨테이너 오케스트레이션 플랫폼