monorepo와 polyrepo 전략은 무엇인가요?

Question

Accepted Answer

**monorepo**(여러 프로젝트/서비스를 위한 하나의 repository)와 **polyrepo**(프로젝트마다 별도의 repository)는 여러 프로젝트에 걸쳐 코드를 조직하는 두 가지 전략입니다. 각각 협업, 도구, 확장에 영향을 미치는 상당한 트레이드오프가 있습니다 — 이를 이해하는 것이 중요한 아키텍처 결정을 내리는 데 도움이 됩니다.

## monorepo — 모든 것을 위한 하나의 repo

```text
여러 프로젝트/서비스/라이브러리를 단일 repository에:
  ✓ 공유 코드/라이브러리를 쉽게 사용하고 리팩터링(한 곳, 원자적 변경)
  ✓ 프로젝트 전반의 ATOMIC commit(API를 바꾸고 모든 소비자를 함께)
  ✓ 통합 도구, 버전 관리, CI; 일관된 표준; 쉬운 프로젝트 간 가시성
  ✓ 단순화된 의존성 관리(공유 코드의 하나의 버전)
  ✗ repo가 거대해질 수 있음(확장 도구 필요 — sparse checkout, 빌드 캐싱)
  ✗ 효율적이려면 정교한 빌드/CI 도구(Nx, Turborepo, Bazel) 필요
  ✗ 넓은 접근; CI가 똑똑해야 함(변경된 것만 빌드)
→ Google, Meta 등이 사용(무거운 도구 투자와 함께).
```

## polyrepo — 프로젝트당 하나의 repo

```text
각 프로젝트/서비스/라이브러리가 자체 repository에:
  ✓ 명확한 소유권과 경계; 독립적 버전 관리/릴리스/CI
  ✓ 더 작고 집중된 repo; 세분화된 접근 제어; 독립적 팀
  ✗ 공유 코드가 더 어려움(패키지 게시/소비; 버전 조정)
  ✗ 횡단 변경이 여러 repo에 걸침(여러 PR 조정 — 고통스러움)
  ✗ repo 간 잠재적 불일치(도구, 표준 드리프트)
→ 흔한 기본값; 독립적 서비스/팀에 적합.
```

## 선택하기

```text
MONOREPO → 긴밀히 결합된 프로젝트, 무거운 코드 공유, 프로젝트 간 원자적
  변경과 통합 도구를 원함, 확장 도구에 투자할 의향
POLYREPO → 독립적 프로젝트/팀, 명확한 경계, 독립적 릴리스 주기,
  더 단순한 repo별 필요
→ 보편적 답 없음; 조직, 결합도, 규모, 도구 투자에 달림.
```

## 왜 중요한가

monorepo vs polyrepo 전략을 이해하는 것은 광범위한 함의를 가진 중요한 선택인 **코드 조직에 대한 건전한 아키텍처 결정을 내리는 데** 가치 있는 시니어 수준의 지식이므로, 시니어/아키텍처 역할에 유용합니다.

두 접근 — **monorepo**(하나의 repository에 여러 프로젝트)와 **polyrepo**(프로젝트마다 별도의 repository) — 는 실제 트레이드오프를 가진 근본적으로 다른 조직 철학을 나타냅니다. **monorepo** 장점(쉬운 공유 코드와 리팩터링, **프로젝트 간 원자적 commit** — API와 모든 소비자를 함께 변경, 통합 도구와 표준, 단순화된 의존성 관리)은 무거운 코드 공유가 있는 긴밀히 결합된 프로젝트에 강력하지만, 큰 repository를 효율적으로 처리하려면 **확장 도구**(Nx, Turborepo, Bazel, sparse checkout, 똑똑한 CI)에 상당한 투자가 필요합니다. **polyrepo** 장점(명확한 소유권과 경계, 독립적 버전 관리와 릴리스 주기, 더 작고 집중된 repo, 세분화된 접근)은 독립적 프로젝트와 팀에 적합하지만, **공유 코드를 더 어렵게**(패키지 게시/소비, 버전 조정) 만들고 **횡단 변경을 고통스럽게**(여러 repo에 걸친 PR 조정) 만듭니다.

이 트레이드오프와 **선택하는 방법**(코드 공유가 있고 긴밀히 결합되어 도구에 투자할 의향이 있는 프로젝트에는 monorepo; 명확한 경계를 가진 독립적 프로젝트와 팀에는 polyrepo)을 이해하는 것은 시니어 수준에 기대되는 아키텍처 판단 — 보편적 답이 없고 올바른 선택이 결합도, 규모, 팀 구조, 도구 투자에 달려 있음을 인식 — 을 반영합니다.

여러 프로젝트에 걸친 코드 조직은 협업, 도구, 확장, 팀 자율성에 영향을 미치는 중요한 아키텍처 결정이고, monorepo/polyrepo 트레이드오프를 이해하는 것이 이 중대한 선택에 도움이 되므로, monorepo vs polyrepo 전략을 이해하는 것은 아키텍처 의사 결정을 위한 가치 있는 시니어 수준의 지식입니다. 이는 (하나를 독단적으로 선호하는 대신) 트레이드오프를 이해하는 것이 조직이 코드를 구조화하는 방식을 형성하는 시니어 역할에 기대되는 성숙한 판단력을 반영하는 자주 논쟁되는 주제입니다.