MonoRepo vs. MultiRepo

MonoRepo vs. MultiRepo

모노레포 (Monorepo) 와 멀티레포 (Multirepo) 는 소프트웨어 개발에서 코드베이스를 관리하는 대표적인 두 가지 전략이다. MonoRepo는 여러 프로젝트를 하나의 저장소에서 관리하는 방식으로, 코드 공유와 일관된 개발 환경을 제공한다. 반면, MultiRepo는 각 프로젝트를 별도의 저장소에서 관리하여 독립성과 유연성을 강조한다.

이 두 접근 방식은 코드 공유, 종속성 관리, 빌드 시스템, 팀 협업, 확장성 등의 측면에서 서로 다른 장단점을 가지고 있다. 프로젝트의 규모, 팀 구조, 회사 문화, 기술 스택 등 다양한 요소에 따라 적합한 방식이 달라질 수 있으며, 최근에는 두 방식의 장점을 결합한 하이브리드 접근법이나 각 방식의 단점을 보완하는 도구들도 등장하고 있다.

정의 및 기능

특징

핵심 원칙

목적 및 필요성 비교

개발 워크플로우 비교

팀 구조 적합성 비교

주요 원리

MonoRepo 주요 원리

MonoRepo 의 핵심 원리는 " 단일 진실 소스 (Single Source of Truth)" 와 " 통합 개발 환경 (Unified Development Environment)" 이다.

이는 다음과 같은 원리로 구현된다:

1. 원자적 변경 (Atomic Changes):
   • 여러 프로젝트에 걸친 변경사항을 단일 커밋으로 처리
   • 모든 의존 프로젝트가 항상 동기화된 상태 유지
2. 단일 버전 (Single Version):
   • 모든 내부 의존성이 항상 최신 버전 사용
   • 버전 불일치 문제 원천 차단
3. 투명한 의존성 (Transparent Dependencies):
   • 모든 프로젝트 간 의존성이 명확하게 가시화됨
   • 의존성 그래프가 자동으로 빌드 시스템에 의해 관리
4. 전역 리팩토링 (Global Refactoring):
   • 전체 코드베이스에 걸친 변경을 안전하게 적용 가능
   • 모든 의존 프로젝트에 대한 영향 즉시 확인
5. 공유 리소스 (Shared Resources):
   • 공통 코드, 설정, 도구를 모든 프로젝트가 공유
   • 중복 없이 표준화된 개발 환경 제공

MultiRepo 주요 원리

MultiRepo 의 핵심 원리는 " 분리된 관심사 (Separation of Concerns)" 와 " 독립적 진화 (Independent Evolution)" 이다.

이는 다음과 같은 원리로 구현된다:

1. 독립적 버전 관리 (Independent Versioning):
   • 각 프로젝트가 자체 버전 관리 체계를 가짐
   • SemVer 등을 통한 명확한 버전 의존성 표현
2. 느슨한 결합 (Loose Coupling):
   • 프로젝트 간 의존성을 명시적 인터페이스로 제한
   • API 계약을 통한 상호작용
3. 자율성 (Autonomy):
   • 팀이 독립적인 기술 스택 및 도구 선택 가능
   • 개별 프로젝트의 특성에 맞는 최적화 가능
4. 분산 책임 (Distributed Responsibility):
   • 각 팀이 자신의 코드에 대한 온전한 책임 부여
   • 독립적인 품질 관리 및 배포 결정권
5. 선택적 공유 (Selective Sharing):
   • 재사용이 필요한 코드만 패키지로 추출하여 공유
   • 명시적 의존성 선언을 통한 투명한 사용

MonoRepo vs. MultiRepo 아키텍처 다이어그램

MonoRepo 구성 예시

• 구성 요소:

  • 공통 라이브러리
  • 여러 애플리케이션
  • 통합된 CI/CD 파이프라인
  • 중앙 집중식 버전 관리

• 특징:

  • 코드 공유와 재사용이 용이
  • 일관된 개발 환경 유지
  • 대규모 프로젝트 관리에 적합

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13

/monorepo
├── apps
│   ├── service-a
│   └── service-b
├── libs
│   ├── shared-ui
│   └── auth-utils
├── tools
│   └── custom-scripts
├── .gitignore
├── nx.json
├── workspace.json
└── package.json

• apps/: 각 서비스 애플리케이션
• libs/: 공통 라이브러리 (재사용 가능)
• tools/: 프로젝트 전체에 쓰이는 도구 모음

MultiRepo 구성 예시

• 구성 요소:

  • 프로젝트별 독립된 저장소
  • 개별 CI/CD 파이프라인
  • 독립적인 버전 관리

• 특징:

  • 프로젝트 간 독립성 확보
  • 유연한 관리와 보안 강화
  • 작은 규모의 팀이나 프로젝트에 적합

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

/ ── service-a-repo
     ├── src/
     └── package.json

/ ── service-b-repo
     ├── src/
     └── package.json

/ ── shared-ui-repo
     ├── components/
     └── package.json

• 저장소 분리로 인해 각 repo 별 CI/CD, 권한 설정이 별도 운영됨
• 의존성/버전 통합은 별도 자동화 필요

장단점 비교

모노레포 (Monorepo)

멀티레포 (Multirepo)

실무 적용 예시

Google, Meta 사례 기반 구조 선택 전략

Google 의 모노레포 전략

Google 은 세계에서 가장 큰 모노레포 중 하나를 운영하고 있으며, 다음과 같은 전략적 선택을 기반으로 한다:

1. 코드 가시성과 재사용:
   • Google 은 모든 코드가 회사 내에서 투명하게 공유되어야 한다는 문화적 가치를 중요시한다.
   • 내부 라이브러리의 광범위한 재사용을 통해 개발 효율성을 높인다.
2. 통합 도구 체인:
   • Bazel 빌드 시스템을 개발하여 대규모 코드베이스의 빌드 시간을 최적화했다.
   • 코드 검색, 코드 리뷰, 테스트 도구 등이 모두 통합된 환경을 제공한다.
3. 표준화된 개발 환경:
   • 모든 개발자가 동일한 도구와 프로세스를 사용하도록 표준화하여 생산성을 향상시킨다.
   • 새로운 직원이 빠르게 적응할 수 있는 일관된 환경을 제공한다.
4. 증분 테스트 및 빌드:
   • 변경된 코드와 그 영향을 받는 부분만 선택적으로 테스트하고 빌드하는 시스템을 구축했다.
   • 자동화된 테스트와 의존성 분석을 통해 품질을 유지한다.

Meta(Facebook) 의 모노레포 전략

Meta 는 Buck 빌드 시스템을 중심으로 대규모 모노레포를 구축했다:

1. 관련 코드 그룹화:
   • 관련된 서비스와 프로젝트를 논리적으로 그룹화하여 코드 구조를 관리한다.
   • 공통 인프라와 라이브러리를 공유하여 일관성을 유지한다.
2. 지속적 통합과 검증:
   • 모든 커밋이 전체 코드베이스의 안정성에 미치는 영향을 즉시 확인한다.
   • 지속적인 테스트와 검증으로 품질 저하를 방지한다.
3. 팀 경계 유연화:
   • 팀 간 경계를 유연하게 하여 협업과 지식 공유를 촉진한다.
   • 개발자가 다양한 영역의 코드에 기여할 수 있는 문화를 조성한다.
4. 확장 가능한 인프라:
   • 분산 빌드 시스템과 캐싱을 통해 빌드 성능을 최적화한다.
   • 대규모 개발자 팀을 지원하기 위한 도구와 인프라를 지속적으로 개선한다.

구조 선택 전략 비교

적합한 상황

• 모노레포 (Monorepo) 가 적합한 경우

  • 프로젝트 간 강한 의존성, 코드 공유가 많을 때
  • 작은~중간 규모의 팀, 통합된 개발/배포 환경이 필요할 때
  • 대규모 리팩터링, 통합 테스트가 빈번할 때

• 멀티레포 (Multirepo) 가 적합한 경우

  • 각 서비스/라이브러리별로 독립적인 개발/배포/버전 관리가 필요할 때
  • 대규모 조직, 여러 팀이 자율적으로 작업할 때
  • 접근 제어, 보안 이슈가 중요한 경우

활용 예시

시나리오: 대규모 조직에서 여러 팀이 다양한 서비스를 개발하는 경우

• MonoRepo 활용:

  • 공통 라이브러리와 모듈을 중앙에서 관리하여 코드 재사용을 극대화
  • 일관된 개발 환경과 통합된 CI/CD 파이프라인을 통해 개발 효율성 향상

• MultiRepo 활용:

  • 각 팀이 독립된 저장소를 운영하여 개발의 유연성과 독립성 확보
  • 프로젝트별로 맞춤형 CI/CD 파이프라인을 구성하여 특화된 개발 환경 제공

모노레포 vs. 멀티레포 선택 기준

프로젝트 특성에 따른 선택 기준:

운영 기준 및 고려사항

모노레포 효과적 운영을 위한 기준:

1. 빌드 시스템 투자:
   • 증분 빌드 및 테스트를 지원하는 고급 빌드 시스템 도입
   • 빌드 캐싱 및 분산 빌드 인프라 구축
2. 코드 구조화:
   • 명확한 모듈 경계와 의존성 관리 정책 수립
   • 공유 코드와 서비스별 코드의 구분 명확화
3. 접근 제어 메커니즘:
   • 코드 소유권 및 리뷰 정책 확립
   • 필요한 경우 디렉토리 수준의 접근 제어 구현
4. 확장성 계획:
   • 저장소 크기 증가에 따른 성능 최적화 전략 수립
   • Git 가상 파일 시스템 (VFS) 등 대규모 저장소 관리 도구 활용

멀티레포 효과적 운영을 위한 기준:

1. 의존성 관리:
   • 강력한 내부 패키지 레지스트리 구축
   • 의존성 버전 관리 및 호환성 테스트 자동화
2. 코드 공유 전략:
   • 공통 라이브러리 추출 및 패키지화 프로세스 확립
   • 내부 오픈소스 문화 및 기여 절차 수립
3. 통합 도구:
   • 여러 저장소 검색 및 탐색 도구 구축
   • 프로젝트 간 일관된 CI/CD 파이프라인 템플릿 제공
4. 조정 메커니즘:
   • 서비스 간 의존성 변경 알림 시스템 구축
   • 다중 저장소 작업을 위한 메타 도구 활용

실무에서 효과적으로 적용하기 위한 고려사항 및 주의할 점

하이브리드 (Hybrid) 접근

필요에 따라 모노레포와 멀티레포를 혼합하는 하이브리드 구조도 가능하다.
예를 들어, 공통 라이브러리/유틸리티는 모노레포로, 각각의 마이크로서비스는 멀티레포로 관리할 수 있다.

Bazel/Nx 모노레포 도구

Bazel 특징 및 기능

Bazel 은 Google 이 개발한 오픈소스 빌드 도구로, 대규모 모노레포를 효율적으로 관리하기 위해 설계되었다:

1. 핵심 기능:
   • 언어 불가지론적 빌드 시스템: 다양한 언어와 프레임워크 지원
   • 증분 빌드: 변경된 부분과 그 의존성만 빌드
   • 재현 가능한 빌드: 동일한 입력에 대해 항상 동일한 출력 보장
   • 분산 캐싱: 팀 간 빌드 결과 공유로 중복 작업 방지
2. 사용 사례:
   • 복잡한 다중 언어 프로젝트
   • 엄격한 확정성과 재현성이 필요한 환경
   • 대규모 엔터프라이즈 코드베이스
3. 장단점:
   • 장점: 뛰어난 성능과 확장성, 견고한 의존성 관리
   • 단점: 가파른 학습 곡선, 복잡한 설정, 생태계 제한

Nx 특징 및 기능

Nx 는 Nrwl 에서 개발한 모노레포 도구로, 특히 JavaScript/TypeScript 생태계에 최적화되어 있다:

1. 핵심 기능:
   • 영향 분석: 변경 영향을 받는 프로젝트만 빌드/테스트
   • 코드 생성기: 일관된 코드 생성 및 구조 제공
   • 스마트 빌드 캐싱: 로컬 및 분산 캐싱 지원
   • 시각화 도구: 프로젝트 구조 및 의존성 시각화
2. 사용 사례:
   • Angular, React, Vue 등 프론트엔드 중심 프로젝트
   • 풀스택 JavaScript/TypeScript 애플리케이션
   • 중소규모 모노레포 관리
3. 장단점:
   • 장점: 쉬운 설정, 풍부한 생태계, 개발자 경험 중시
   • 단점: JavaScript 생태계 중심, 대규모 모노레포에서 한계

도구 비교

Polyrepo 권한 관리 전략

멀티레포 (폴리레포) 환경에서의 효과적인 권한 관리 전략:

1. 계층적 접근 제어:
   • 팀 기반 권한 모델: 팀 단위로 저장소 접근 권한 관리
   • 역할 기반 접근 제어 (RBAC): 개발자, 리뷰어, 관리자 등 역할별 권한 할당
   • 저장소별 세밀한 권한 설정: 읽기, 쓰기, 관리 권한 분리
2. 중앙화된 ID 관리:
   • 단일 ID 제공자 (IdP) 연동: SAML, OAuth 등을 통한 중앙 인증
   • 자동화된 사용자 프로비저닝: HR 시스템과 연동한 자동 계정 관리
   • 다중 인증 (MFA) 적용: 중요 저장소에 대한 추가 보안 계층
3. 코드 소유권 관리:
   • CODEOWNERS 파일 활용: 각 코드 영역별 책임자 명시
   • 필수 리뷰어 설정: 특정 영역 변경 시 전문가 리뷰 필수화
   • 자동화된 리뷰 할당: 코드 소유권에 기반한 자동 리뷰어 지정
4. 효율적인 다중 저장소 관리:
   • 저장소 템플릿 활용: 일관된 구조와 기본 권한 설정 적용
   • 권한 변경 감사: 모든 접근 권한 변경 기록 및 검토
   • API 기반 권한 관리: 스크립트 및 자동화를 통한 대량 권한 관리
5. 안전한 CI/CD 파이프라인:
   • 파이프라인 별 최소 권한 원칙: 필요한 접근 권한만 부여
   • 시크릿 및 자격 증명 안전한 관리: 중앙화된 시크릿 저장소 활용
   • 빌드 환경 분리: 개발 환경과 빌드/배포 환경의 권한 분리

멀티레포 권한 관리 도구 및 플랫폼:

최신 동향

주목해야 할 기술

앞으로의 전망

추가 학습 내용

용어 정리

참고 및 출처

• Google 개발자 블로그 - Monorepo 관리 전략
• Meta Engineering 블로그 - 대규모 코드베이스 운영 방식
• Microsoft Engineering - One Engineering System
• Netflix 기술 블로그 - Microservices at Netflix
• Bazel 공식 사이트
• Nx 공식 사이트
• Lerna 공식 문서
• GitHub Docs - Managing monorepos
• Atlassian 블로그 - Monorepo vs. Multi-repo
• NX Monorepo 소개
• Turborepo 공식 문서
• Google의 단일 저장소 분석
• Microsoft의 대규모 Git 저장소 관리
• Spotify의 저장소 전략 사례 연구
• Bazel 빌드 시스템 문서
• pnpm 워크스페이스 가이드
• Meta/Facebook의 Buck 빌드 시스템
• Yarn 워크스페이스 문서
• Lerna 모노레포 관리 도구
• GitHub의 저장소 최적화 가이드
• Atlassian의 모노레포 vs 멀티레포 가이드