Introduktion til Git-submodules

Hvad er Git Submodules? De giver dig mulighed for at indlejre ét Git-repository i et andet som en undermappe. Det svarer til at have et separat projekt inde i dit hovedprojekt, men stadig administreret uafhængigt.

Forestil dig, at dit projekt har brug for et bestemt bibliotek eller en bestemt komponent, som udvikles og vedligeholdes separat. I stedet for at kopiere koden kan du bruge et submodule.

• Leverandørkode: Inkludér tredjepartsbiblioteker.
• Delte komponenter: Genbrugelig kode på tværs af flere projekter.
• Plug-in-systemer: Gør dele af en større applikation modulære.

Et submodule er ikke bare en mappe med filer. Det er en pegepind til en bestemt commit i et andet Git-repository. Dit hovedprojekt holder styr på, hvilken commit fra submodulet det skal bruge.

Det betyder, at dit hovedprojekt ikke administrerer indholdet i submodulet direkte, men i stedet dets reference.

Git gemmer submodules som en særlig post i hovedrepositoryets indeks. Det registrerer submodulets sti, URL'en til dets fjernrepository og den specifikke commit-hash, som det peger på i øjeblikket.

Når du kloner et projekt med submodules, ser du først tomme mapper, indtil du initialiserer og opdaterer dem.

Hvert submodule er sit eget selvstændige Git-repository. Du kan klone det, skifte branch, committe ændringer og pushe dem, alt sammen uafhængigt af det overordnede repository.

Denne adskillelse er vigtig, når du vil administrere eksterne afhængigheder uden at flette deres historik ind i dit hovedprojekt.

Submodules er fremragende til:

• Stabile afhængigheder: Når du har brug for en bestemt version af et eksternt bibliotek og ikke ønsker, at det ændrer sig uventet.
• Store komponenter: Opdeling af et monolitisk projekt i mindre, håndterbare dele, der versionsstyres uafhængigt.
• Bidrag til open source: Integration af eksterne værktøjer eller frameworks uden selv at vedligeholde deres kildekode.

De er især nyttige, når:

• Du har brug for at følge en bestemt version af en afhængighed og ikke bare den nyeste.
• Afhængigheden administreres af et andet team eller projekt.
• Du vil holde afhængighedens historik adskilt fra dit hovedprojekts historik.

Når du tilføjer et submodule, opretter Git en særlig konfigurationsfil i roden af dit hovedrepository: .gitmodules.

Denne fil gemmer sammenhængen mellem submodulets lokale sti og dets fjern-URL. Den versionsstyres, så alle, der kloner dit projekt, kender dets submodules.

Selvom submodules er gode, findes der alternativer. En bemærkelsesværdig mulighed er Git Subtree.

Submodules holder afhængighedens historik adskilt, mens Git Subtree integrerer afhængighedens historik direkte i dit hovedrepository. Vi udforsker Subtree i en senere lektion!

Vi har introduceret Git-submodules og set dem som en måde at indlejre selvstændige Git-repositories i dit hovedprojekt på.

• De følger bestemte commits i eksterne repositories.
• De løser problemer med delt kode og stabile afhængigheder.
• De konfigureres via filen .gitmodules.

Dernæst lærer du, hvordan du tilføjer og kloner submodules.