Git-Untermodule und gemeinsame Pakete

Git-Untermodule eignen sich für gemeinsame Repositories mit eigenem Lebenszyklus. Dazu zählen etwa Design-Systeme, interne Werkzeuge, Vorlagen oder Pakete ohne separate Veröffentlichung.

Typische Reibungspunkte:

ein Projekt nutzt eine andere Fassung des gemeinsamen Codes als das nächste
Aktualisierungen bleiben im Hauptprojekt schwer nachvollziehbar
beim Klonen fehlen wichtige Unterverzeichnisse
die Auslieferung stoppt, weil das Modul in der Automatisierung fehlt

Bestehendes Projekt mit Untermodulen einrichten

bash

Dieser Schritt lädt die fehlenden Untermodul-Inhalte direkt beim Klonen oder nachträglich in das Projekt.

Gemeinsames Repository als Untermodul einbinden

bash

Damit steht fest, wo das Untermodul im Projekt liegt und welcher Zweig als Bezug dient. Das Hauptprojekt speichert dabei immer einen konkreten Commit-Stand des Untermoduls.

Dadurch entsteht eine klare, aber pflegeintensive Struktur:

Änderungen bleiben nachvollziehbar
Aktualisierungen laufen bewusst und gesteuert
das Hauptprojekt muss jeden neuen Stand bewusst übernehmen

Untermodul-Stände im Team pflegen

bash

Dieser Ablauf hält Hauptprojekt und Untermodul auf demselben Stand und macht Änderungen im Team nachvollziehbar.

Untermodule in der Automatisierung laden

Git so konfigurieren, dass Untermodule automatisch geladen werden
Builds reproduzierbar machen (Lockfiles, Node/PNPM-Version pinnen)
In Release-Pipelines bewusst entscheiden: Untermodul auf neuesten Stand bringen mit eigenem Commit im Hauptprojekt oder Versions-Tags nutzen

In der Praxis ist vor allem dieser Befehl entscheidend:

bash

Dieser Schritt sorgt dafür, dass die Untermodul-Inhalte in Auslieferung und Prüfung vollständig vorliegen.

Einsatzfälle für Untermodule

Untermodule passen zu gemeinsamen Repositories mit eigenem Lebenszyklus und klarer Trennung vom Hauptprojekt.

Typische Fälle sind:

interne Werkzeuge
Vorlagen und Gerüste
gemeinsame Konfigurationssammlungen
private Design-Systeme oder Ressourcen mit eigenem Lebenszyklus

Bei regulär veröffentlichten Paketen bietet eine Paketverwaltung meist die klarere Struktur.

Nutzen für den Teamalltag

Klare Untermodul-Stände machen gemeinsame Abhängigkeiten nachvollziehbar und halten Hauptprojekt und Teilrepository in einer überprüfbaren Beziehung.