Monorepo vs Polyrepo (단일 저장소 vs 다수 저장소)

개요

소프트웨어 프로젝트의 규모가 커짐에 따라 코드베이스를 어떻게 관리할 것인가는 개발 생산성과 협업 효율성에 큰 영향을 미칩니다. Monorepo(모노레포)는 모든 프로젝트와 모듈을 하나의 저장소에서 관리하는 방식이고, Polyrepo(폴리레포)는 각각의 프로젝트를 독립적인 저장소로 관리하는 전략입니다. 두 방식은 각기 다른 조직 구조, 개발 규모, 협업 패턴에 따라 선택되어야 하며, DevOps, CI/CD, 모듈화 전략과 밀접하게 연관되어 있습니다.

---

1. 개념 및 정의

Monorepo는 하나의 Git 저장소에 여러 애플리케이션, 라이브러리, 구성 요소를 함께 관리하며, 코드 재사용성과 통합 빌드에 유리합니다. 반면 Polyrepo는 프로젝트마다 독립적인 저장소를 운영하여 팀별 자율성과 경량화를 추구합니다.

Google, Meta 등은 대규모 모노레포 전략을 채택하고 있으며, 중소기업이나 스타트업은 필요에 따라 폴리레포를 선호합니다.

---

2. 특징

항목	Monorepo	Polyrepo
저장소 구조	단일 저장소	다수의 저장소
버전 관리	전체 동기화	개별 관리 가능
변경 추적	전체 영향도 파악 용이	프로젝트별 간섭 최소화
권한 관리	세분화 어려움	저장소 단위로 가능

조직 규모가 클수록 일관성 관리를 위해 모노레포, 팀 자율성이 중요할수록 폴리레포를 선택하는 경향이 있습니다.

---

3. 구성 요소

구성 요소	Monorepo 예시	Polyrepo 예시
코드베이스	frontend/, backend/, shared/	frontend-repo, backend-repo
빌드 시스템	Bazel, Nx, Turborepo	각 저장소 별 build script
CI/CD	중앙화된 파이프라인	저장소별 GitHub Actions, Jenkins 등
Dependency 관리	공통 루트 패키지로 통일	저장소별 독립적인 관리

Monorepo는 루트 레벨에서 통합 관리를, Polyrepo는 저장소별 유연한 구성 방식을 지향합니다.

---

4. 기술 요소

기술 요소	Monorepo	Polyrepo
빌드 툴	Bazel, Pants, Nx	Gradle, npm, Maven 등 저장소 개별 사용
코드 공유	상대적으로 용이 (공용 폴더)	별도 패키지 배포 필요 (예: npm registry)
테스트 자동화	전체 영향 분석 테스트 가능	변경된 저장소에 한정된 테스트 적용
DevOps 전략	하나의 파이프라인 집중화	팀별 CI/CD 구성 가능

모노레포는 일관성과 공유에 강점이 있으나 빌드 속도나 병목 이슈에 주의해야 합니다.

---

5. 장점 및 이점

장점	Monorepo	Polyrepo
협업	전체 코드 베이스 공유로 통합 개발 가능	팀별 독립적 개발 가능
릴리즈 관리	일괄 릴리즈, 버전 통일 쉬움	프로젝트별 릴리즈 유연성 확보
유지보수	공통 모듈 수정 시 즉시 반영 가능	영향 범위 제한되어 안전성 확보
권한 제어	전체 코드 접근이 쉬움	보안 관점에서 세분화 용이

모노레포는 전체 시스템의 동기화에 유리하고, 폴리레포는 보안과 독립성이 강화됩니다.

---

6. 주요 활용 사례 및 고려사항

분야	Monorepo 사례	Polyrepo 사례
대규모 플랫폼	Google, Meta, Uber	Netflix, Airbnb
모듈화 제품군	사내 라이브러리 다수 운영	SaaS 제품군 별 독립 개발
스타트업/SMB	통합 배포, 빠른 초기 구축	빠른 팀 증설 및 위임 구조

도입 시 개발 문화, 도구 역량, 빌드 및 테스트 복잡도에 대한 고려가 필수입니다.

---

7. 결론

Monorepo와 Polyrepo는 일장일단이 뚜렷하며, 조직의 기술 성숙도, 팀 구성 방식, 릴리즈 전략에 따라 최적의 선택이 달라집니다. Monorepo는 통합성과 일관성, Polyrepo는 유연성과 독립성에서 강점을 보입니다. 장기적으로는 Hybrid 구조와 같은 유연한 혼합 전략도 고려할 수 있으며, 효율적인 코드베이스 관리를 위해 전략적 판단이 중요합니다.