Part III. 로컬 실습: Neon 자체 호스팅

Neon의 storage 엔진은 Apache 2.0으로 공개되어 있습니다. 저장소에는 pageserver, safekeeper, compute를 한 번에 실행하는 Docker Compose 예제가 들어 있습니다. 이 Part는 그 예제를 학습용으로 정리한 neon-lab을 macOS의 Docker에서 실제로 실행한 기록입니다. branch 생성, 쓰기 격리, 과거 LSN 분기, storage 관찰도 직접 확인했습니다.

upstream README는 이 compose 구성이 "이미지 테스트용이며 사용 가능한 시스템을 배포하려는 목적이 아니다"라고 명시합니다. control plane과 storage controller가 없으므로 branch 생성은 pageserver의 HTTP API를 직접 호출하는 방식으로 대신합니다. 이 제약은 3.6에서 따로 정리합니다.

• 3.1 Docker Compose로 Neon 구동
• 3.2 첫 Branch 만들기
• 3.3 과거 LSN에서 Branch 만들기
• 3.4 Storage 관찰: LSN, Layer, MinIO
• 3.5 cargo neon 개발 환경과 Neon Local
• 3.6 자체 호스팅 한계와 문제 해결

실습 파일은 /examples/neon-lab/ 아래에 있습니다. 측정값은 모두 이 노트의 실습 환경(Apple Silicon, Docker VM 2 vCPU, 12 GB)에서 얻었습니다. 따라서 다른 환경에서는 달라집니다.