Monorepo vs Polyrepo: Какую стратегию выбрать?

При работе над сложными программными проектами выбор между monorepo и polyrepo может существенно повлиять на продуктивность вашей команды и масштабируемость кода. В этой статье мы анализируем различия, плюсы и минусы каждого подхода и помогаем вам понять, какой из них подходит именно вам.

Что такое Monorepo и Polyrepo?

Monorepo

Monorepo (монолитный репозиторий) — это единый репозиторий, содержащий исходный код нескольких проектов, сервисов или пакетов, часто связанных между собой.

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

Преимущества:

• Каждая команда/проект независимы.
• Проще управлять для небольших проектов.
• Позволяет настраивать гранулярные политики доступа.

Недостатки:

• Сложнее делиться кодом без публикации пакетов.
• Кросс-репозиторный рефакторинг более сложен.
• Возможное дублирование конфигураций.

Практический пример: Monorepo с Turborepo

Предположим, вы хотите создать monorepo с frontend и backend с использованием Turborepo.

1. Инициализация monorepo

npx create-turbo@latest

2. Типичная структура

my-monorepo/
  apps/
    web/        # frontend Next.js
    api/        # backend Node.js/Express
  packages/
    ui/         # shared component library
    utils/      # shared functions
  turbo.json
  package.json

3. Пример workspace в 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('en-US');
}

Во frontend:

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

export default function Home() {
  return <div>Today is {formatDate(new Date())}</div>;
}

Когда выбирать Monorepo?

• Средние и крупные команды, работающие над несколькими связанными проектами.
• Необходимость совместного использования кода и масштабного рефакторинга.
• Проекты, которые быстро растут и требуют оптимизированных сборок/тестов.

Когда выбирать Polyrepo?

• Небольшие или независимые проекты.
• Отдельные команды, работающие над разными продуктами.
• Очень строгие политики доступа.

Заключение

Идеального решения для всех не существует. Выбор зависит от размера команды, сложности проекта и потребностей в сотрудничестве. Важно осознавать компромиссы и выбирать правильные инструменты для управления сложностью.