Monorepo vs Polyrepo: Strategi Mana Yang Perlu Anda Pilih?

Apabila bekerja pada projek perisian yang kompleks, pilihan antara monorepo dan polyrepo boleh memberi kesan yang ketara terhadap produktiviti pasukan anda dan kebolehskalaan kod. Dalam artikel ini, kami menganalisis perbezaan, kebaikan dan keburukan setiap pendekatan, dan membantu anda memahami mana yang sesuai untuk anda.

Apakah Monorepo dan Polyrepo?

Monorepo

Sebuah monorepo (repositori monolitik) ialah satu repositori tunggal yang mengandungi kod sumber untuk pelbagai projek, perkhidmatan, atau pakej, yang sering berkaitan antara satu sama lain.

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

Polyrepo

Sebuah polyrepo (pelbagai repositori) bermaksud setiap projek, perkhidmatan, atau pakej mempunyai repositori tersendiri yang berasingan.

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

Perbezaan Visual

Kebaikan dan Keburukan

Monorepo

Kelebihan:

• Memudahkan perkongsian kod (cth., pustaka kongsi).
• Pemfaktoran semula atomik merentasi pelbagai projek.
• Pengurusan berpusat bagi kebergantungan dan konfigurasi.

Kelemahan:

• Boleh menjadi berat apabila pangkalan kod berkembang.
• Memerlukan alat untuk menguruskan binaan/ujian separa (cth., Nx, Turborepo).

Polyrepo

Kelebihan:

• Setiap pasukan/projek adalah bebas.
• Lebih mudah untuk diuruskan bagi projek kecil.
• Membolehkan polisi akses yang terperinci.

Kelemahan:

• Lebih sukar untuk berkongsi kod tanpa menerbitkan pakej.
• Pemfaktoran semula merentas repositori lebih kompleks.
• Kemungkinan pertindihan konfigurasi.

Contoh Praktikal: Monorepo dengan Turborepo

Katakan anda ingin mencipta monorepo dengan frontend dan backend menggunakan Turborepo.

1. Mulakan monorepo

npx create-turbo@latest

2. Struktur biasa

my-monorepo/
  apps/
    web/        # frontend Next.js
    api/        # backend Node.js/Express
  packages/
    ui/         # pustaka komponen kongsi
    utils/      # fungsi kongsi
  turbo.json
  package.json

3. Contoh workspace dalam package.json

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

4. Contoh import pustaka kongsi

Katakan anda mempunyai fungsi dalam packages/utils/src/formatDate.ts:

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

Dalam frontend:

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

export default function Home() {
  return <div>Hari ini ialah {formatDate(new Date())}</div>;
}

Bila Memilih Monorepo?

• Pasukan sederhana hingga besar yang bekerja pada pelbagai projek berkaitan.
• Perlu berkongsi kod dan melakukan pemfaktoran semula berskala besar.
• Projek yang berkembang pesat dan memerlukan binaan/ujian yang dioptimumkan.

Bila Memilih Polyrepo?

• Projek kecil atau bebas.
• Pasukan berasingan yang bekerja pada produk berbeza.
• Polisi akses yang sangat ketat.

Kesimpulan

Tiada penyelesaian sempurna untuk semua orang. Pilihan bergantung pada saiz pasukan, kerumitan projek, dan keperluan kerjasama. Yang penting ialah menyedari pertukaran dan memilih alat yang betul untuk menguruskan kerumitan.