Mikä on Monorepo – Edut ja Haasteet Suurille Tiimeille

Monorepo on ohjelmistokehityksen strategia, jossa useiden projektien koodi säilytetään yhdessä versiohallintarepositoriossa. Tämä lähestymistapa eroaa perinteisestä polyrepo-mallista, jossa jokaisella projektilla on oma erillinen repositorionsa.

Käytännön ovat omaksuneet monet teknologiajätit, kuten Google, Meta, Microsoft ja Uber, jotka hallitsevat massiivisia koodimääriä ja päivittäisiä muutoksia skaalautuvilla rakenteilla. Artikkelissa käsitellään monorepon rakennetta, työkaluja ja käytännön esimerkkejä.

Monorepoon siirtyminen vaatii huolellista suunnittelua, mutta se voi tuoda merkittäviä etuja suurille tiimeille ja toisiinsa sidoksissa oleville projekteille.

Mikä on monorepo?

Keskeiset havainnot monorepoista

• Yksinkertaistettu koodinhallinta ja yhtenäinen riippuvuuksien hallinta
• Välitön palaute muutoksista – backend-muutos rikkoo frontend-testit heti
• Ei tarvetta erillisille julkaisupaketeille kirjastoille
• AI-agenttien käyttö helpottuu kontekstin saatavuuden ansiosta
• Virheen korjaus koskee kaikkia käyttäjiä kerralla
• Konteksti virtaa vapaasti projektien välillä
• Skaalausvaatimuksia syntyy erityisesti isoissa build-järjestelmissä

Monorepo ja polyrepo vertailussa

Monorepo vs. polyrepo

Monorepossa kaikki koodi sijaitsee yhdessä repossa, mikä helpottaa koodin uudelleenkäyttöä ja riippuvuuksien hallintaa. Työkalut voidaan yhtenäistää ja kehitysympäristö pysyy yhdenmukaisena kaikille projekteille.

Milloin valita monorepo?

Monorepo soveltuu erityisesti tilanteisiin, joissa projektit ovat tiiviisti sidoksissa toisiinsa. Suuret organisaatiot, joissa useat tiimit työskentelevät jaetuilla kirjastoilla, hyötyvät yhtenäisestä koodikannasta. Kontekstin säilyminen projektirajojen yli on merkittävä etu monimutkaisissa arkkitehtuureissa.

Milloin polyrepo toimii paremmin?

Pienet tiimit ja toisistaan riippumattomat projektit voivat hyötyä polyrepo-mallista. Jokaisen projektin itsenäisyys mahdollistaa nopean kehityksen ilman laajojen build-järjestelmien hallinnointia.

Mikä on monorepo-rakenne?

Monorepon rakenne on tyypillisesti hierarkkinen. Juurikansio sisältää aliprojektit, jaetun koodin ja konfiguraatiotiedostot. Monorepo-työkalujen dokumentaatio kuvaa tyypillistä rakennetta seuraavasti: root → apps/ → packages/ → tools/.

Tyypillinen kansiorakenne

• /frontend – Käyttöliittymäsovellukset ja komponentit
• /backend – Palvelinpuolen logiikka ja API:t
• /shared-libs – Uudelleenkäytettävät kirjastot
• /tools – Sisäiset kehitystyökalut
• /config – Jaetut konfiguraatiotiedostot

Git-workfloweja käytetään ominaisuuksien lisäykseen, ja rakenneprosessi voidaan toteuttaa yhtenäisenä. Tämä sopii myös mikropalveluarkkitehtuureille, joissa jokainen palvelu on oma aliprojektinsa.

Monorepo-esimerkkejä

Useat tunnetut avoimen lähdekoodin projektit hyödyntävät monorepo-rakennetta. Wikipedia mainitsee esimerkkeinä muun muassa Babelin ja Nx-workspacen.

Googlen monorepo

Google on yksi suurimmista monorepo-käyttäjistä. Yrityksen Piper-järjestelmä mahdollistaa tuhansien kehittäjien työskentelyn samassa repositoriossa. Koodikanta sisältää kaikki yrityksen sisäiset projektit ja kirjastot.

Meta ja Microsoft

Meta (entinen Facebook) ja Microsoft ovat myös omaksuneet monorepo-lähestymistavan. Meta käyttää Bazel-rakennusjärjestelmää hallitakseen laajaa koodikantaansa tehokkaasti.

Avoimen lähdekoodin projektit

Babel-kääntäjä ja Nx-työtilat edustavat avoimen lähdekoodin monirepoja. Nämä projektit demonstroivat, miten useita npm-paketteja voidaan hallita yhdestä repositoriosta käsin.

Monerepo-työkalut ja vaihtoehdot

Rakennusjärjestelmät

Nx on suosittu työkalu monerepojen hallintaan. Se tarjoaa tehokkaat build-komennot, riippuvuusanalyysin ja välimuistituksen nopeuttamaan kehitystä.

Bazel, Lerna ja Turborepo ovat muita tunnettuja vaihtoehtoja. Nx ja Turborepo ovat erityisesti saaneet suosiota viime vuosina niiden modernin arkkitehtuurin ansiosta.

Versionhallintajärjestelmät

Perforce (P4) skaalautuu petatavuihin ja tuhansille käyttäjille rajattomilla tiedostoilla. Tämä tekee siitä sopivan valinnan erittäin suuriin monerepoihin.

Vaihtoehtoiset lähestymistavat

• Polyrepo – Perinteinen malli, jossa jokaisella projektilla on oma repo
• Synteettinen monerepo – Yhdistää repot riippuvuuskaavioon ilman koodin siirtoa
• Hybridi-mallit – Yhdistelmä edellisiä lähestymistapoja

Monerepo ja monoliitti

Monerepo ei ole sama kuin monoliittinen sovellus. Perforce selventää eron: monerepo on massiivinen koodikanta, joka sisältää itsenäisiä projekteja, kun taas monoliitti on yksi palvelu tai palvelukokonaisuus yhdelle tietojoukolle.

Jos haluat lukea aiheesta lisaa, voit katsoa Talletusbonukset.

Monoliitti voi sisältää aliprojekteja, mutta se on arkkitehtuurisesti yhtenäinen sovellus. Monerepo puolestaan mahdollistaa useiden itsenäisten palveluiden hallinnan samasta repositoriosta käsin.

Monerepon kehityshistoria

1. 2000-luvun alku – Termi “jaettu koodikanta” otettiin käyttöön decentralisoitujen versionhallintajärjestelmien yhteydessä
2. 2010-luku – Facebook, Microsoft ja muut suuret toimijat omaksuivat lähestymistavan laajasti
3. 2015–2017 – Nx ja muut modernit työkalut syntyivät vastaamaan tarpeita
4. 2020-luku – Turborepo ja synteettiset monerepot laajensivat käyttömahdollisuuksia

Mitä tiedetään ja mitä ei

Lähteet ja määritelmät

Monerepo (monolithic repository) stores the code for a number of projects in the same repository.

— Wikipedia

A monorepo is a single repository containing multiple distinct projects, with well-defined relationships.

— monorepo.tools

Monorepos store many projects in one repository.

— Perforce

Yhteenveto

Monerepo on tehokas strategia suurille organisaatioille, joissa projektit ovat tiiviisti sidoksissa toisiinsa. Se yksinkertaistaa koodinhallintaa, nopeuttaa iterointia ja parantaa kontekstin säilymistä tiimien välillä. Pienille tiimeille polyrepo-malli voi kuitenkin olla joustavampi vaihtoehto. MIDI-näppäimistö ja muut tekniset ratkaisut hyötyvät monirepositorioiden tarjoamasta yhtenäisyydestä.

Oikean työkalun valinta riippuu organisaation koosta, projektien riippuvuuksista ja tiimin kokemuksesta. Skaalautuvuuden ja joustavuuden tasapainottaminen on keskeistä.

Usein kysytyt kysymykset