# Repository

## Was es ist

Ein Repository, im Gespräch fast immer zu Repo verkürzt, ist der Ort, an dem eine Versionsverwaltung die vollständige Geschichte eines Projekts aufbewahrt: jeden aufgezeichneten Zustand jeder Datei, wer welche Änderung aus welchem Grund vorgenommen hat und die Namen, die in diese Geschichte führen. Die Arbeitsdateien, die Sie bearbeiten, zeigen einen Ausschnitt davon; das Repository ist alles hinter diesem Ausschnitt.

Git definiert den Begriff im eigenen Glossar recht genau: „Eine Sammlung von Referenzen zusammen mit einer Objektdatenbank, die alle von den Referenzen erreichbaren Objekte enthält.“ Beide Teile verdienen eine Erklärung. Die Objektdatenbank enthält die Inhalte. Jede Version einer Datei, jede Verzeichnisauflistung und jeder Commit werden als Objekte gespeichert und durch einen Hash ihres jeweiligen Inhalts benannt. Das Git-Buch beschreibt dies als inhaltsadressiertes Dateisystem: einen Schlüssel-Wert-Speicher, dessen Schlüssel aus dem Wert berechnet wird. Zwei identische Dateien sind ein einziges Objekt, und jede noch so kleine Änderung erzeugt einen neuen Namen. Die Referenzen sind die menschliche Seite: Branches und Tags, kurze Namen, die jeweils auf einen Commit zeigen und einen Einstieg ermöglichen.

Die meisten Repositories, in denen gearbeitet wird, haben einen zugehörigen Arbeitsbaum. Die Dateien im Editor liegen im Projektverzeichnis, das Repository selbst daneben in einem verborgenen Verzeichnis namens `.git`. Ein Bare-Repository hat überhaupt keinen Arbeitsbaum. Sein Verzeichnisname endet üblicherweise auf `.git`, und es enthält nur die Historie. So bewahrt ein Server ein Repository auf, weil dort niemand Dateien bearbeitet: Änderungen werden dorthin gepusht und von dort abgerufen. Das Git-Glossar sagt es ausdrücklich: Wer öffentliche Repositories veröffentlicht, stellt sie meist als Bare-Repositories bereit. Das Git-Buch zeigt, wie sich mit `git clone --bare my_project my_project.git` eines aus einem vorhandenen Projekt erzeugen lässt.

Beim Klonen zeigt sich der Entwurf von Git. Ein Klon erhält fast alle Daten des Servers: Standardmäßig lädt er jede Version jeder Datei aus der gesamten Projektgeschichte herunter. Jeder Klon ist deshalb ein vollständiges Repository und kann den Server ersetzen, wenn dieser verloren geht. Die Ausnahmen sind klein, aber wichtig, und das Git-Buch nennt sie: Serverseitige Hooks und ähnliche Einstellungen bleiben zurück.

Zwei Varianten kommen oft vor. Ein flaches Repository, das beim Klonen mit `--depth` entsteht, enthält nur die jüngeren Commits. Laut Glossar werden die älteren Eltern-Commits „wegkauterisiert“; später lässt sich die Historie durch einen Fetch vertiefen. Ein Submodul ist ein Repository innerhalb eines anderen, mit eigener Historie, das das äußere Repository auf genau einen Commit festlegt.

## Warum es wichtig ist

Ein Repository ist das Gedächtnis eines Projekts. Wenn eine Codezeile falsch aussieht, zeigt ihre Historie, wann sie hinzugekommen ist, in welchem Commit und mit welcher Erklärung. Das funktioniert nur so gut wie die geschriebenen Commits. Deshalb geben Teams, denen ihre Historie wichtig ist, Regeln für Commit-Nachrichten vor und setzen sie mit Hooks durch, statt auf guten Willen zu vertrauen.

Es ist auch die Einheit, auf der die meisten Werkzeuge arbeiten. Zugriffsrechte werden je Repository vergeben, Hooks laufen je Repository, und Continuous Integration beginnt meist bei einem Repository. Wer die Grenze eines Repositorys zieht, grenzt damit auch ab, welchen Bereich eine einzelne Begutachtung, eine Prüfung und eine Berechtigung jeweils abdecken.

Repositories behalten, was sie bekommen. Ein Commit, der eine Datei löscht, fügt einen neuen Zustand hinzu. Alle früheren Zustände bleiben, wo sie waren, in jedem Klon, der sie bereits enthält. Diese Beständigkeit ist der Zweck einer Versionsverwaltung, und sie wirkt in beide Richtungen: Eine alte Version lässt sich wiederherstellen, aber ebenso ein versehentlich eingechecktes Passwort.

Schließlich kann ein Repository weit mehr als Anwendungscode enthalten. Infrastrukturdefinitionen, Dokumentation und Konfiguration gewinnen dasselbe: eine Historie, einen Review-Schritt und einen Weg, einen bekannten Zustand wiederaufzubauen. Ein Server, dessen Einrichtung im Repository beschrieben ist, kann von jemandem neu aufgebaut werden, der ihn noch nie gesehen hat.

## Wie es in der Praxis aussieht

Vier Repositories, die eine Person über achtzehn Monate aufgebaut hat, teilen einen Commit-Standard: ein konventionelles Präfix für die Änderungsart, einen Geltungsbereich, eine Betreffzeile unterhalb einer festen Längengrenze, keine Emojis und keine Attributionszeilen am Nachrichtenende. In jedem Repository, in dem Arbeit entsteht, lehnt ein Commit-Message-Hook jeden Verstoß ab. So ist der Standard eine Eigenschaft des Repositorys und nicht der Person, die committet. Die Historie zeigt anschließend, worin die Arbeit bestand. Zum dokumentierten Implementierungsstand vom Juli 2026 enthielt die Historie des größten Repositorys 156 Feature-Commits, 133 Fehlerkorrekturen, 128 Dokumentationsänderungen, 81 Wartungsarbeiten, 26 Refactorings, 20 Stiländerungen, 5 Performance-Änderungen und 3 Teständerungen. Der Hook endet vor der Qualitätsfrage: Er prüft das Format, nicht den Inhalt.

Für die eigene Infrastruktur des Unternehmens, die bereitgestellten öffentlich zugänglichen Dienste und die Konfiguration weiterer Komponenten lautete der Auftrag, sie in einem Repository zu beschreiben, statt sie nur im Kopf zu behalten. Die aufgezeichnete Implementierung umfasste 12.065 YAML-Zeilen, verteilt auf 19 Playbooks und 34 Rollen. Diese Zahlen beschreiben den damaligen Stand, nicht das heutige Repository. Auch die Automatisierung für Backups und E-Mail ist dort konfiguriert; ihre betriebliche Aktivierung ist ein eigener Schritt. Die Infrastruktur lässt sich aus dem Repository reproduzieren: Ein Host gehört zu einer Gruppe für seine Infrastrukturebene, deren Variablen seine auszuführenden Rollen festlegen, und ein bereits konvergierter Host meldet null Änderungen. Jede Änderung dauert länger als eine direkte Bearbeitung auf dem Server. Später wurde der Konvergenz ein Play mit Vorabprüfungen vorgeschaltet.

Ein Repository behält auch, was hineingeraten ist, während die Aufmerksamkeit anderswo lag. Arbeit für ein anderes Unternehmen wurde durch eine Umstrukturierung des Repositorys mitgeschleppt. Dazu gehörte ein provisorisches Protokoll mit noch gültigen Zugangsdaten im Klartext, das während des größten Teils der Repository-Historie unbemerkt an allen Kontrollen vorbeikam und im Baum blieb. Nichts davon wurde ausgeführt, und genau deshalb überlebte es. Die Antwort war eine Regel zum Geltungsbereich ganz oben in den Repository-Anweisungen: die Infrastruktur genau eines Unternehmens und nichts anderes. Hinzu kam eine Quarantäne statt einer Löschung. So bleibt die Historie lesbar, während Secret-Scanner, Vault-Kontrolle und Emoji-Prüfung die Dateien in Quarantäne weiterhin lesen.

## Wo es schiefgeht
* Ein einmal eingechecktes Geheimnis überlebt seine Löschung. Wird die Datei im nächsten Commit entfernt, bleibt sie im vorigen und in jedem seither erstellten Klon erhalten. Behandeln Sie die Zugangsdaten als öffentlich: Tauschen Sie sie zuerst aus und entscheiden Sie dann, ob ein Umschreiben der Historie die Störungen für alle mit einer Kopie rechtfertigt.
* Ein Push trifft auf einen ausgecheckten Branch. Ein Push in ein Repository mit Arbeitsbaum, dessen aktueller Branch aktualisiert werden soll, würde dessen Arbeitsbaum und Historie auseinanderlaufen lassen. Git verweigert einen solchen Push deshalb standardmäßig über `receive.denyCurrentBranch`. Ein Repository, in das gepusht wird, sollte ein Bare-Repository sein.
* Ein flacher Klon beantwortet Fragen zur Historie mit einem Ausschnitt. Ein mit `--depth` erstellter Klon enthält nur jüngere Commits. Deshalb sehen `git log`, `git blame` und jedes Skript, das eine Version aus dem letzten Git-Tag ableitet, nur diesen Teil. Build- und Release-Jobs, die die Vergangenheit benötigen, sollten die vollständige Historie abrufen.
* Ein lokaler Hook endet beim nächsten Klon. Clientseitige Hooks liegen in `.git/hooks`, und das Git-Buch stellt klar, dass ein Klon sie nicht kopiert. Eine nur dort durchgesetzte Regel endet an dem Tag, an dem jemand frisch klont. Versionieren Sie die Hook-Skripte im Repository und lassen Sie `core.hooksPath` auf sie zeigen, oder erzwingen Sie die Regel serverseitig mit `pre-receive`.
* Große Binärdateien blähen jeden Klon dauerhaft auf. Weil ein Klon jede Version jeder Datei enthält, bleibt jede ersetzte Fassung einer großen Binärdatei in der Historie. Jeder neue Klon lädt sie alle herunter.
* Dateien, die nirgends ausgeführt werden, liest niemand. Eine deaktivierte Aufgabe, ein veraltetes Inventar oder ein provisorisches Protokoll liegt weiterhin in jedem Klon. Kein Test, Build oder Deployment berührt es, also entgeht es der Überprüfung. Der Inhalt eines Repositorys sollte zu den Verantwortlichkeiten des Projekts passen. Alles andere sollte entfernt oder so abgesondert werden, dass die Kontrollen es weiterhin sehen.

## Weiterführende Lektüre
* gitglossary: Repository — Gits eigene Definition, neben Bare-Repository, Arbeitsbaum, flachem Repository und Submodul.
* Ein Git-Repository anlegen — Die beiden Wege, in einem Verzeichnis neu anzufangen oder zu klonen, und was ein Klon herunterlädt.
* Git-Objekte — Wie die Objektdatenbank Inhalte unter deren Hash speichert.
* gitrepository-layout — Wozu jede Datei und jedes Verzeichnis innerhalb eines Repositorys dient.
* Git auf einem Server einrichten — Ein vorhandenes Repository in ein Bare-Repository umwandeln und teilen.
* Git-Hooks — Client- und serverseitige Hooks und warum ein Klon die clientseitigen zurücklässt.

=> /de/portfolio/held-4-repositories-to-one-history-standard/ Vier Repositories, die eine Person über achtzehn Monate aufgebaut hat
=> /de/portfolio/servers-you-can-rebuild-from-scratch/ in einem Repository zu beschreiben, statt sie nur im Kopf zu behalten
=> /de/portfolio/wrote-a-scope-rule-after-a-credential-leak/ Arbeit für ein anderes Unternehmen wurde durch eine Umstrukturierung des Repositorys mitgeschleppt
=> https://git-scm.com/docs/gitglossary#def_repository gitglossary: Repository
=> https://git-scm.com/book/en/v2/Git-Basics-Getting-a-Git-Repository Ein Git-Repository anlegen
=> https://git-scm.com/book/en/v2/Git-Internals-Git-Objects Git-Objekte
=> https://git-scm.com/docs/gitrepository-layout gitrepository-layout
=> https://git-scm.com/book/en/v2/Git-on-the-Server-Getting-Git-on-a-Server Git auf einem Server einrichten
=> https://git-scm.com/book/en/v2/Customizing-Git-Git-Hooks Git-Hooks

=> https://engineer.company/de/glossary/repository/ Diese Seite im Web
