Kokios yra monorepo ir polyrepo strategijos?

Question

Accepted Answer

**Monorepo** (viena saugykla daugeliui projektų/paslaugų) ir **polyrepo** (atskira saugykla kiekvienam projektui) yra dvi strategijos, skirtos organizuoti kodą keliuose projektuose. Kiekviena turi reikšmingus kompromisus, turinčius įtakos bendradarbiavimui, įrankiams ir masteljavimui — jų supratimas padeda priimti svarbius architektūrinius sprendimus.

## Monorepo — viena saugykla visam

```text
Many projects/services/libraries in a SINGLE repository:
  ✓ SHARED code/libraries easy to use and refactor (one place, atomic changes)
  ✓ ATOMIC commits across projects (change an API and all its consumers together)
  ✓ Unified tooling, versioning, CI; consistent standards; easy cross-project visibility
  ✓ Simplified dependency management (one version of shared code)
  ✗ Repo can get HUGE (needs scaling tooling — sparse checkout, build caching)
  ✗ Needs sophisticated build/CI tooling (Nx, Turborepo, Bazel) to be efficient
  ✗ Broad access; CI must be smart (only build what changed)
→ Used by Google, Meta, etc. (with heavy tooling investment).
```

## Polyrepo — saugykla kiekvienam projektui

```text
Each project/service/library in its OWN repository:
  ✓ Clear OWNERSHIP and boundaries; independent versioning/releases/CI
  ✓ Smaller, focused repos; granular access control; independent teams
  ✗ SHARED code is harder (publish/consume packages; version coordination)
  ✗ Cross-cutting changes span MANY repos (coordinate multiple PRs — painful)
  ✗ Potential inconsistency across repos (tooling, standards drift)
→ Common default; fits independent services/teams.
```

## Pasirinkimas

```text
MONOREPO → tightly-coupled projects, heavy code sharing, want atomic cross-project
  changes and unified tooling, willing to invest in scaling tooling
POLYREPO → independent projects/teams, clear boundaries, independent release cycles,
  simpler per-repo needs
→ No universal answer; depends on the org, coupling, scale, and tooling investment.
```

## Kodėl tai svarbu

Monorepo ir polyrepo strategijų supratimas yra vertinga aukštesnio lygio žinojimas **priimti gerus architektūrinius sprendimus dėl kodo organizavimo**, tai reikšmingas pasirinkimas, turintis plačias implikacijas, todėl jis naudingas aukštesnio lygio ir architektūriniams vaidmenims.

Du požiūriai — **monorepo** (daug projektų vienoje saugykloje) ir **polyrepo** (atskira saugykla kiekvienam projektui) — atspindi iš esmės skirtingus organizacinius principus su realiais kompromisais. **Monorepo** privalumai (lengvas bendrintas kodas ir refaktoringa, **atomiškos tarpprobleminės commits** — API keitimas ir visi jo vartotojai kartu, unifikuoti įrankiai ir standartai, supaprastinta priklausomybių valdyba) jį daro galingu tightly-coupled projektams su intensyviu kodo bendrimu, bet reikalingas reikšmingas **masteljavimo įrankių** (Nx, Turborepo, Bazel, sparse checkout, smart CI) investavimas, kad efektyviai valdyti didelę saugyklą. **Polyrepo** privalumai (aiški nuosavybė ir ribos, nepriklausomas versijų sudarymas ir leidimo ciklai, mažesnės sukoncentruotos saugyklos, granulinė prieiga) tinka nepriklausomuose projektuose ir komanose, bet **bendrintą kodą daro sunkiau** (paketų publikavimas/naudojimas, versijų koordinavimas) ir **kryžmines keitybas daro skaudžiomis** (PR koordinavimas keliose saugyklose).

Šių kompromisų supratimas ir tai, kaip **pasirinkti** (monorepo tightly-coupled, kodo bendrimu pasidalinančiuose projektuose, norinčiuose investuoti į įrankius; polyrepo nepriklausomuose projektuose ir komanose su aiškiomis ribomis) atspindi architektūrinį sprendimą, kurio tikimasi aukštesnio lygio — suvokiant, kad nėra universalaus atsakymo ir teisingas pasirinkimas priklauso nuo susieto pobūdžio, masto, komandos struktūros ir įrankių investavimo.

Kadangi kodo organizavimas keliuose projektuose yra reikšmingas architektūrinis sprendimas, turintis įtakos bendradarbiavimui, įrankiams, masteljavimui ir komandos autonomijai, ir kadangi monorepo/polyrepo kompromisų supratimas informuoja šį svarbų pasirinkimą, monorepo ir polyrepo strategijų supratimas yra vertinga aukštesnio lygio žinojimas architektūriniams sprendimams priimti, dažnai ginčijamas klausimas, kuriame kompromisų supratimas (o ne dogmatiškas vienos palankumas) atspindi brandų sprendimą, tikėtiną aukštesnio lygio vaidmenyse, kurie formuoja, kaip organizacija struktūrizuoja savo kodą.