Um die Abläufe und die Funktionsweise zu erproben, wollen wir zunächst ein Verzeichnis unter Versionskontrolle stellen, in dem wir ein Tagebuch anlegen. Wir erstellen also ein Verzeichnis tagebuch
und initialisieren dort ein Git-Repository:
frank@pike:~$ mkdir tagebuch frank@pike:~$ cd tagebuch/ frank@pike:~/tagebuch$ git init Leeres Git-Repository in /home/frank/tagebuch/.git/ initialisiert
Nun steht das Verzeichnis tagebuch
unter Versionskontrolle. Das lokale Git-Repository befindet sich im Unterverzeichnis .git
:
$ ls -la insgesamt 132 drwxr-xr-x 3 frank frank 4096 24. Okt 13:32 . drwxr-xr-x 21 frank frank 122880 24. Okt 13:32 .. drwxr-xr-x 7 frank frank 4096 24. Okt 13:32 .git
Mit dem Befehl git status
kann man sich den aktuellen Status des Repos anzeigen lassen:
frank@pike:~/tagebuch$ git status Auf Branch main Noch keine Commits nichts zu committen (erstellen/kopieren Sie Dateien und benutzen Sie "git add" zum Versionieren)
Lege mit einem Texteditor1) eine Datei aufstehen.txt
an. Du kannst in diese Datei z.B. hineinschreiben, wie du geschlafen hast und wann du aufgestanden bist. Das folgende Beispiel verwendet den Editor nano
unter Linux, du kannst aber auch Notepad++ unter Windows oder Kate unter LInux verwenden, diese Editoren haben eine GUI. Wichtig ist, dass du die Datei im Verzeichnis tagebuch
abspeicherst.
frank@pike:~/tagebuch$ nano aufstehen.txt frank@pike:~/tagebuch$ cat aufstehen.txt Ich habe gut geschlafen. Um 6:20 bin ich aufgestanden.
Unser Tagebuch enthält nun einen Eintrag in aufstehen.txt
. Wir wollen jetzt den Zustand des Tagebuchs an dieser Stelle so in unserer Versionsverwaltung festhalten, dass wir ihn später wieder verwenden können.
Um den git-Workflow zu verstehen, muss man drei Begriffe unterscheiden: Das Arbeitsverzeichnis ("Working Directory") den Index ("Staging Area") und das eigentliche Repository.
git init
unter Versionskontrolle gestellt hat mit allen seinen Dateien und Unterverzeichnissen, so wie man es auf der Festplatte vorfindet. Das "spezielle" Verzeichnis .git
wird dabei ignoriert, es dient der internen Verwaltung der Abläufe durch git.git commit
durchgeführt. Nach einem Commit ist der Index stets leer, da ja alle Änderungen, die dort vorgemerkt waren, in den Snapshot überführt wurden.
Neue Dateien befinden sich zunächst "nur" im Arbeitsverzeichnis und werden von git ignoriert. Mit git status
kann man das überprüfen, solche Dateien tauchen dort in der Liste der "Unversionierten Dateien" auf, für unser Tagebuch sieht das so aus:
git status Auf Branch main Noch keine Commits Unversionierte Dateien: (benutzen Sie "git add <Datei>...", um die Änderungen zum Commit vorzumerken) aufstehen.txt nichts zum Commit vorgemerkt, aber es gibt unversionierte Dateien (benutzen Sie "git add" zum Versionieren)
Mit dem Befehl git add
wird eine Datei im Index vorgemerkt - das kann man sich vorstellen wie ein Einkaufswagen, in dem neue Dateien und Änderungen gesammelt werden, bis man zu einem Punkt kommt, den man sich "merken" möchte. Im Folgenden habe ich die einzige Datei aufstehen.txt
zum Index hinzugefügt:
frank@pike:~/tagebuch$ git add aufstehen.txt frank@pike:~/tagebuch$ git status Auf Branch main Noch keine Commits Zum Commit vorgemerkte Änderungen: (benutzen Sie "git rm --cached <Datei>..." zum Entfernen aus der Staging-Area) neue Datei: aufstehen.txt
Wenn man mit den im Index vorgemerkten Änderungen zufrieden ist, macht man einen "Commit"2).
Mit dem Befehl git commit -m "Erster Commit"
legt man einen Commit mit einer Commit-Message an (Paramter -m
). Wenn man die Commit-Message nicht mit -m
angibt, öffnet sich ein Editor, in dem man diese bearbeiten muss.
frank@pike:~/tagebuch$ git commit -m "Aufstehen!" [main (Root-Commit) 9ee8f8b] Aufstehen! 1 file changed, 2 insertions(+) create mode 100644 aufstehen.txt
Wenn man den Status des Arbeitsverzeichnisses jetzt erneut abfragt, erhält man folgende Ausgabe:
frank@pike:~/tagebuch$ git status Auf Branch main nichts zu committen, Arbeitsverzeichnis unverändert
Man erkennt, dass der Index wieder leer ist ("nichts zum Commit vorgemerkt").
Nun kann man weitere Änderungen im Tagebuch vornehmen und sich an allen wichtigen Stellen den Zustand der Dateien in einem Commit merken.
fruehstueck.txt
fest, was es zum Frühstück gab.git status
, dass es die Datei jetzt gibt, sie aber nicht unter Versionskontrolle steht.fruehstuck.txt
mit dem Befehl git add fuehstuck.txt
zum Index hinzu.-m
.Wir haben nur einen zweiten Commit erstellt:
fruehstueck.txt
zum Commit vorgemerkt und anschließend mit git commit
"commited", ein Commit beinhaltet jedoch stets den Zustand aller unter Versionskontrolle stehender Dateien im Arbeitsverzeichnis, also in diesem Fall ist in unserem zweiten Commit auch die (unveränderte) Datei aufstehen.txt
enthalten!
Man kann sich einen Commit also wie im Bild dargestellt als Archivbox vorstellen, in dem jeweils der Zustand aller versionierten Dateien festgehalten ist. Ein Commit wird durch einen Hexadezimalen "Hashwert" identifiziert, das ist gewissermaßen die eindeutige Nummer eines Commits, z.B. 2c70b75
.
Mit dem Befehl git log
kann man sich die Commits auflisten lassen:
frank@pike:~/tagebuch$ git log commit 2c70b7517bcf0217c62b93336de038f166225c6a (HEAD -> main) Author: Frank Schiebel <codeberg@ua25.de> Date: Sun Oct 29 20:32:50 2023 +0100 Fruestück commit 9ee8f8bfdd6c532fee7d693c9d4431e22f455f0d Author: Frank Schiebel <codeberg@ua25.de> Date: Sun Oct 29 20:14:11 2023 +0100 Aufstehen!
Man erkennt hier auch, dass die eigentlichen Commit-Hashes sehr viel länger sind, als das Beispiel oben vermuten lässt, für die Identifizierung eines Commits reichen die ersten 7 Stellen des Hashes aus.
mittagessen.txt
hinzu, zunächst ohne diese zu versionieren.fruehstueck.txt
ab, so dass die Schokolade dort vermerkt ist.git status
den Zustand deines Repositorys.Dein Repo sollte ungefähr so aussehen:
frank@pike:~/tagebuch$ vi mittagessen.txt frank@pike:~/tagebuch$ vi fruehstueck.txt frank@pike:~/tagebuch$ git status Auf Branch main Änderungen, die nicht zum Commit vorgemerkt sind: (benutzen Sie "git add <Datei>...", um die Änderungen zum Commit vorzumerken) (benutzen Sie "git restore <Datei>...", um die Änderungen im Arbeitsverzeichnis zu verwerfen) geändert: fruehstueck.txt Unversionierte Dateien: (benutzen Sie "git add <Datei>...", um die Änderungen zum Commit vorzumerken) mittagessen.txt keine Änderungen zum Commit vorgemerkt (benutzen Sie "git add" und/oder "git commit -a")
Wir haben jetzt zwei Dinge geändert:
fruehstueck.txt
haben wir eine Änderung vorgenommen.mittagessen.txt
haben wir neu hinzugefügt.Filename | Filesize | Last modified |
---|---|---|
02-erstes-repo.odp | 1.2 MiB | 28.04.2021 20:18 |
02-erstes-repo.pdf | 431.1 KiB | 28.04.2021 20:18 |
2023-10-29_19-56.png | 32.5 KiB | 29.10.2023 19:57 |
2023-10-29_20-02.png | 33.0 KiB | 29.10.2023 20:02 |
commit.drawio.png | 35.3 KiB | 29.10.2023 20:22 |
git_add.drawio.png | 39.9 KiB | 29.10.2023 20:12 |
gitstagingcommit.png | 61.2 KiB | 28.04.2021 15:14 |
zweitercommit.drawio.png | 63.2 KiB | 29.10.2023 20:41 |