Submódulos Git e pacotes partilhados em equipa

Submódulos Git são úteis para repositórios partilhados com ciclo de vida próprio. Isso inclui design systems, ferramentas internas, modelos ou pacotes sem um fluxo de publicação separado.

um projeto usa outra revisão do código partilhado que o seguinte
as atualizações ficam difíceis de seguir no projeto principal
faltam subdiretórios importantes depois do clone
a entrega pára porque o módulo falta na automação

Preparar um projeto existente com submódulos

bash

Este passo traz o conteúdo em falta do submódulo diretamente durante o clone ou depois para o projeto.

Adicionar um repositório partilhado como submódulo

bash

Isto define onde o submódulo fica no projeto e que branch serve de referência. O projeto principal guarda sempre um commit concreto do submódulo.

as alterações mantêm-se rastreáveis
as atualizações acontecem de forma consciente e controlada
o projeto principal precisa de adotar explicitamente cada novo estado

Manter os estados do submódulo na equipa

bash

Este fluxo mantém projeto principal e submódulo no mesmo estado e torna as alterações rastreáveis na equipa.

Carregar submódulos na automação

bash

Casos de uso para submódulos

Os submódulos encaixam em repositórios partilhados com ciclo de vida próprio e uma separação clara do projeto principal.

ferramentas internas
modelos e esqueletos
coleções partilhadas de configuração
design systems ou recursos privados com ciclo de vida próprio

Benefício no trabalho diário da equipa

Estados claros do submódulo tornam dependências partilhadas rastreáveis e mantêm uma relação verificável entre projeto principal e repositório filho.