Monorepo vs Polyrepo: como organizar o seu código?

À medida que uma empresa acumula projetos, bibliotecas e serviços, surge uma pergunta de organização: guardamos todo o código num único repositório (monorepo) ou cada projeto no seu (polyrepo)? Pode parecer um detalhe técnico menor, mas a decisão afeta como colaboram as equipas, como se partilha o código, como se implementa e como se mantém a coerência. Não há uma resposta universal; cada estratégia tem vantagens claras consoante o tamanho da organização e a natureza dos projetos.

Neste artigo comparamos o monorepo e o polyrepo, as suas vantagens e inconvenientes, e explicamos como escolher consoante o seu caso.

O que é um monorepo

Um monorepo é um único repositório que contém o código de muitos projetos, serviços ou bibliotecas ao mesmo tempo. A sua grande vantagem é a coerência e a facilidade para partilhar: todo o código vive junto, é fácil reutilizar bibliotecas comuns, fazer uma alteração que afeta vários projetos ao mesmo tempo e manter versões e ferramentas unificadas. Usam-no muitas grandes tecnológicas. Em contrapartida, requer ferramentas adequadas para gerir o seu tamanho, e sem elas o repositório pode tornar-se lento e difícil de gerir em grande escala.

O que é um polyrepo

A abordagem polyrepo (ou multirepo) mantém cada projeto no seu próprio repositório independente. A sua grande vantagem é a autonomia e a simplicidade: cada equipa gere o seu repo com total liberdade, as permissões e as implementações estão claramente separadas, e cada repositório é pequeno e fácil de compreender. É a abordagem mais tradicional e natural. Em contrapartida, partilhar código entre projetos é mais complicado, manter a coerência entre todos custa mais, e uma alteração que afeta vários repos exige coordenar várias alterações em separado.

As diferenças-chave

Estes são os fatores onde mais se nota a diferença entre monorepo e polyrepo:

• Partilhar código: fácil em monorepo; mais custoso em polyrepo.
• Coerência: unificada em monorepo; dispersa em polyrepo.
• Autonomia das equipas: maior em polyrepo.
• Alterações transversais: simples em monorepo; coordenadas em polyrepo.
• Tamanho e ferramentas: o monorepo exige tooling para escalar.
• Isolamento: mais claro em polyrepo (permissões, implementações).

O fator da coordenação

A diferença de fundo está na coordenação. O monorepo facilita as alterações que cruzam vários projetos: uma modificação numa biblioteca comum aplica-se e testa-se com tudo o que a usa num só passo, o que evita as incompatibilidades de versões. O polyrepo, em contrapartida, isola cada projeto, o que dá independência mas transfere para as equipas a tarefa de coordenar versões e propagar alterações. A escolha depende muito de quanto os seus projetos se relacionam entre si.

O papel das ferramentas

Uma parte importante do debate deslocou-se para as ferramentas. Historicamente, o monorepo associava-se a repositórios lentos e difíceis de gerir quando cresciam, o que empurrava muitas equipas para o polyrepo. Hoje existem ferramentas específicas de gestão de monorepos que resolvem grande parte desses problemas: compilam e testam apenas o que mudou, gerem as dependências internas e mantêm o desempenho mesmo com centenas de projetos dentro. Isto tornou o monorepo muito mais viável para organizações de tamanho médio, não só para as grandes tecnológicas. Ainda assim, essas ferramentas acrescentam a sua própria complexidade e curva de aprendizagem, pelo que adotar um monorepo sem o tooling adequado costuma correr mal. A decisão, portanto, não é apenas de estratégia, mas também de se a equipa está disposta a investir nas ferramentas que a tornam sustentável.

Como escolher

Escolha um monorepo quando os seus projetos partilham muito código, quando valoriza a coerência e as alterações transversais, ou quando quer uma experiência de desenvolvimento unificada, sempre que adote as ferramentas adequadas para o gerir. Escolha polyrepo quando os seus projetos são independentes, quando as equipas necessitam de autonomia total, ou por simplicidade quando não há muito código partilhado. Não há uma opção universalmente melhor: a decisão correta depende do tamanho da sua organização e de quanto os seus projetos se entrelaçam.

Na AxiomTech organizamos o código com a estratégia adequada a cada equipa e projeto, monorepo ou polyrepo, com as ferramentas que a tornem eficiente. Se a sua base de código cresceu e tem dúvidas sobre como organizá-la, vamos conversar e aconselhamo-lo consoante o seu caso.