Monorepo vs Polyrepo: Bạn Nên Chọn Chiến Lược Nào?

Khi làm việc trên các dự án phần mềm phức tạp, sự lựa chọn giữa monorepo và polyrepo có thể ảnh hưởng đáng kể đến năng suất của nhóm và khả năng mở rộng mã nguồn. Trong bài viết này, chúng tôi phân tích sự khác biệt, ưu và nhược điểm của từng cách tiếp cận, và giúp bạn hiểu đâu là lựa chọn phù hợp.

Monorepo và Polyrepo là gì?

Monorepo

Một monorepo (kho lưu trữ đơn) là một kho lưu trữ duy nhất chứa mã nguồn của nhiều dự án, dịch vụ hoặc gói, thường liên quan đến nhau.

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

Polyrepo

Một polyrepo (nhiều kho lưu trữ) có nghĩa là mỗi dự án, dịch vụ hoặc gói có kho lưu trữ riêng biệt.

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

Sự khác biệt trực quan

Ưu và nhược điểm

Monorepo

Ưu điểm:

• Dễ dàng chia sẻ mã nguồn hơn (ví dụ: thư viện dùng chung).
• Tái cấu trúc nguyên tử trên nhiều dự án.
• Quản lý tập trung các phụ thuộc và cấu hình.

Nhược điểm:

• Có thể trở nên nặng khi codebase phát triển.
• Cần công cụ để quản lý build/test từng phần (ví dụ: Nx, Turborepo).

Polyrepo

Ưu điểm:

• Mỗi nhóm/dự án đều độc lập.
• Dễ quản lý hơn cho các dự án nhỏ.
• Cho phép chính sách truy cập chi tiết.

Nhược điểm:

• Khó chia sẻ mã nguồn mà không xuất bản gói.
• Tái cấu trúc xuyên kho lưu trữ phức tạp hơn.
• Có thể trùng lặp cấu hình.

Ví dụ thực tế: Monorepo với Turborepo

Giả sử bạn muốn tạo một monorepo với frontend và backend sử dụng Turborepo.

1. Khởi tạo monorepo

npx create-turbo@latest

2. Cấu trúc điển hình

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. Ví dụ workspace trong package.json

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

4. Ví dụ import thư viện dùng chung

Giả sử bạn có một hàm trong packages/utils/src/formatDate.ts:

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

Trong frontend:

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

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

Khi nào nên chọn Monorepo?

• Nhóm vừa và lớn làm việc trên nhiều dự án liên quan.
• Cần chia sẻ mã nguồn và thực hiện tái cấu trúc quy mô lớn.
• Dự án phát triển nhanh và cần build/test tối ưu.

Khi nào nên chọn Polyrepo?

• Dự án nhỏ hoặc độc lập.
• Các nhóm riêng biệt làm việc trên các sản phẩm khác nhau.
• Chính sách truy cập rất hạn chế.

Kết luận

Không có giải pháp hoàn hảo cho tất cả mọi người. Sự lựa chọn phụ thuộc vào quy mô nhóm, độ phức tạp của dự án và nhu cầu hợp tác. Điều quan trọng là nhận thức được các đánh đổi và chọn đúng công cụ để quản lý độ phức tạp.