Introduksjon til Git Submodules

Hva er Git Submodules? De lar deg bygge inn ett Git-repositorium i et annet som en underkatalog. Det er som å ha et separat prosjekt inne i hovedprosjektet, samtidig som det fortsatt administreres uavhengig.

Se for deg at prosjektet ditt trenger et bestemt bibliotek eller en komponent som utvikles og vedlikeholdes separat. I stedet for å kopiere koden kan du bruke en submodul.

• Leverandørkode: Inkluder tredjepartsbiblioteker.
• Delte komponenter: Gjenbrukbar kode på tvers av flere prosjekter.
• Plugin-systemer: Gjør deler av en større applikasjon modulære.

En submodul er ikke bare en mappe med filer. Den er en peker til en bestemt commit i et annet Git-repositorium. Hovedprosjektet sporer hvilken commit i submodulen det skal bruke.

Det betyr at hovedprosjektet ikke administrerer innholdet i submodulen direkte, men heller referansen til det.

Git lagrer submoduler som en spesialoppføring i indeksen til hovedrepositoriet. Den registrerer submodulens sti, URL-en til det eksterne repositoriet og den spesifikke commit-hashen den peker på.

Når du kloner et prosjekt med submoduler, ser du først tomme kataloger frem til du initialiserer og oppdaterer dem.

Hver submodul er sitt eget selvstendige Git-repositorium. Du kan klone det, bytte gren, opprette commits og pushe dem, alt uavhengig av hovedrepositoriet.

Denne isolasjonen er viktig for å administrere eksterne avhengigheter uten å slå sammen historikken deres med hovedprosjektet.

Submoduler egner seg godt til:

• Stabile avhengigheter: Når du trenger en bestemt versjon av et eksternt bibliotek og ikke vil at det skal endres uventet.
• Store komponenter: Dele opp et monolittisk prosjekt i mindre, håndterbare deler som versjoneres uavhengig.
• Bidrag til åpen kildekode: Integrere eksterne verktøy eller rammeverk uten å vedlikeholde kildekoden deres direkte.

De er spesielt nyttige når:

• Du må spore en bestemt versjon av en avhengighet, ikke bare den nyeste.
• Avhengigheten administreres av et annet team eller prosjekt.
• Du vil holde avhengighetens historikk atskilt fra hovedprosjektets historikk.

Når du legger til en submodul, oppretter Git en egen konfigurasjonsfil i roten av hovedrepositoriet: .gitmodules.

Denne filen lagrer koblingen mellom submodulens lokale sti og den eksterne URL-en. Den er versjonskontrollert, slik at alle som kloner prosjektet, kjenner til submodulene.

Selv om submoduler er nyttige, finnes det alternativer. Et kjent alternativ er Git Subtree.

Submoduler holder avhengighetens historikk atskilt, mens Git Subtree integrerer avhengighetens historikk direkte i hovedrepositoriet. Vi utforsker Subtree i en senere leksjon!

Vi har introdusert Git-submoduler og sett på dem som en måte å bygge inn uavhengige Git-repositorier i hovedprosjektet på.

• De sporer bestemte commits i eksterne repositorier.
• De løser utfordringer knyttet til delt kode og stabile avhengigheter.
• De konfigureres via filen .gitmodules.

Deretter lærer vi hvordan du legger til og kloner submoduler.