モノレポ vs ポリレポ: どの戦略を選ぶべきか？

ある程度複雑なソフトウェアプロジェクトを進める際、MonorepoとPolyrepoの選択はチームの生産性やコードのスケーラビリティに大きな影響を与えます。本記事では両者の違い、メリット・デメリットを分析し、あなたのプロジェクトに最適な選択肢を考えます。

MonorepoとPolyrepoとは？

Monorepo

Monorepo（モノリポジトリ）は、複数のプロジェクトやサービス、パッケージのソースコードを1つのリポジトリで管理する方法です。

my-monorepo/
  packages/
    frontend/
    backend/
    shared/
  package.json
  turbo.json

Polyrepo

Polyrepo（ポリリポジトリ）は、各プロジェクトやサービス、パッケージごとに独立したリポジトリを持つ方法です。

repos/
  frontend/
    package.json
  backend/
    package.json
  shared/
    package.json

視覚的な違い

メリット・デメリット

Monorepo

メリット：

• コード共有が容易（例：共通ライブラリ）。
• 複数プロジェクトにまたがる一括リファクタリングが可能。
• 依存関係や設定の一元管理。

デメリット：

• コード量が増えるとリポジトリが重くなりがち。
• 部分的なビルドやテストのためのツール（例：Nx、Turborepo）が必要。

Polyrepo

メリット：

• 各チーム・プロジェクトが独立。
• 小規模プロジェクトの管理が容易。
• アクセス権限の細かな設定が可能。

デメリット：

• パッケージ公開なしでのコード共有が難しい。
• 複数リポジトリをまたぐリファクタリングが複雑。
• 設定の重複が発生しやすい。

実例：Turborepoを使ったMonorepo

Turborepoを使ってフロントエンドとバックエンドを含むMonorepoを作成する場合を考えます。

1. Monorepoの初期化

npx create-turbo@latest

2. 典型的な構成

my-monorepo/
  apps/
    web/        # フロントエンド Next.js
    api/        # バックエンド Node.js/Express
  packages/
    ui/         # 共通コンポーネントライブラリ
    utils/      # 共通関数
  turbo.json
  package.json

3. package.jsonのワークスペース例

{
  "private": true,
  "workspaces": [
    "apps/*",
    "packages/*"
  ]
}

4. 共通ライブラリのインポート例

packages/utils/src/formatDate.tsに関数があるとします：

// packages/utils/src/formatDate.ts
export function formatDate(date: Date): string {
  return date.toLocaleDateString('ja-JP');
}

フロントエンドで：

// apps/web/pages/index.tsx
import { formatDate } from '@myorg/utils';

export default function Home() {
  return <div>今日は {formatDate(new Date())}</div>;
}

Monorepoを選ぶべき場合

• 複数の関連プロジェクトに取り組む中〜大規模チーム。
• コード共有や大規模リファクタリングが必要な場合。
• 急成長し、ビルドやテストの最適化が求められるプロジェクト。

Polyrepoを選ぶべき場合

• 小規模または独立したプロジェクト。
• 別々の製品に取り組む独立チーム。
• 厳格なアクセス制御が必要な場合。

結論

すべての人に完璧な解決策はありません。選択はチーム規模、プロジェクトの複雑さ、コラボレーションの必要性によって異なります。重要なのはトレードオフを理解し、複雑さを管理するために適切なツールを選ぶことです。