Git-Tutorial: Die ersten Schritte mit dem Versionskontrollsystem

Die gemeinsame Entwicklung von Software-Projekten findet nicht nur innerhalb von Firmen statt: Auch im Open-Source-Sektor sind – je nach Projektgröße – mehrere hunderte bis tausende Freiwillige und Ehrenamtliche an der Instandhaltung, Optimierung, Weiterentwicklung oder Modifizierung eines Programms beteiligt. Ohne ein passendes System zur Aufzeichnung und Kontrolle der zahlreichen Änderungen durch die verschiedenen Entwickler wären derartige Projekte kaum zu realisieren.

Eine der beliebtesten Lösungen zur Versionsverwaltung ist das lizenzfreie Tool Git, das einfach zu lernen und gänzlich kostenfrei nutzbar ist. In diesem Tutorial vermitteln wir Ihnen alle wichtigen Git-Grundlagen, die Sie für den Einstieg in das Versionsverwaltungsprogramm benötigen.

Git ist ein verteiltes Versionsverwaltungssystem, das 2005 von Linux-Schöpfer Linus Thorvalds entwickelt und unter der freien GNU-GPLv2-Lizenz veröffentlicht wurde. Die Besonderheit des Tools besteht darin, dass zwar ein zentrales Repository für jedes Projekt existiert, alle beteiligten Nutzer sich aber eine lokale Arbeitskopie dieses Verzeichnisses auf das eigene Arbeitsgerät herunterladen. Jede dieser Kopien stellt ein vollständiges Back-up des Repositorys dar, weshalb eine durchgehende Netzwerkverbindung für den grundlegenden Arbeitsprozess nicht erforderlich ist. Zudem dienen die Kopien als Absicherung, falls das Haupt-Verzeichnis ausfallen sollte oder beschädigt ist. Vorgenommene Änderungen können jederzeit mit allen anderen Projektteilnehmern ausgetauscht und – sofern relevant – in das Repository aufgenommen werden.

Wer das Software-Management mit Git lernen möchte, der sollte sich im ersten Schritt mit der Software und ihrer Benutzeroberfläche vertraut machen. Git ist für Windows, Unix/Linux und macOS verfügbar, wobei sich die verschiedenen Versionen hinsichtlich ihrer Bedienung leicht voneinander unterscheiden. Nach der jeweiligen Standardinstallation können Sie das Tool plattformunabhängig entweder über die Kommandozeile oder über ein grafisches Benutzer-Interface steuern.

Binäre Installationsdateien, Anleitungen für Paketmanager-Installationen (Unix-Systeme) sowie einsatzfertige portable Editionen für die einzelnen Systeme finden Sie auf der offiziellen Homepage des Git-Projekts. Laden Sie sich einfach das gewünschte Paket herunter bzw. greifen Sie auf das passende Paket in Ihrer Paket-Verwaltung zurück und folgen Sie anschließend den Anweisungen des Installationsassistenten. Bei einer portablen Edition entfällt der Installationsschritt selbstverständlich.

Sobald Git auf dem eigenen System installiert ist, können Sie das Versionsverwaltungssystem für das Management Ihrer Projekte verwenden. Wie bei jeglicher Software gilt es aber zunächst, die elementaren Funktionen und Befehle zu verstehen, um den maximalen Nutzen aus der Anwendung ziehen zu können. Im Rahmen unseres großen Git-Tutorials für Einsteiger erläutern wir die wichtigsten Schritte der Git-Einrichtung und -Bedienung über die Kommandozeile, sodass Sie im Anschluss problemlos Ihr eigenes Repository einrichten und verwalten können.

Das Git-Respository ist das zentrale Verzeichnis eines verwalteten Projekts und somit auch die zentrale Anlaufstelle für alle Teilnehmer, über die die komplette Versionskontrolle reguliert wird. Ihr erster Schritt in Git besteht dementsprechend darin, ein solches Hauptverzeichnis zu erstellen – oder zu klonen (in Form einer Arbeitskopie), sofern Sie sich einem Projekt anschließen, dessen gemeinsame Entwicklung bereits mithilfe von Git kontrolliert wird.

Wollen Sie die Versionskontrolle neu einrichten oder haben Sie das Tool zunächst einfach nur installiert, um die Arbeitsweise mit Git zu lernen, steht zunächst die Neuerstellung eines Repositorys an. Zu diesem Zweck wechseln Sie per „cd“ (change directory) in das gewünschte lokale Verzeichnis auf Ihrem Gerät:

Dort führen Sie nun den folgenden Befehl aus, um ein .git-Verzeichnis zu erzeugen:

Existiert das Git-Repository für Ihr Projekt bereits, benötigen Sie lediglich die Web- bzw. Netzwerkadresse zu diesem Verzeichnis, um mit dem Kommando „git clone“ eine Arbeitskopie auf Ihrem Rechner zu erzeugen:

Zu den wichtigsten Git-Grundlagen zählt eine gute Organisation des eigenen Arbeitsverzeichnisses. Über dieses schlagen Sie nicht nur eigene Änderungen und Neuerungen an einem Projekt vor, die anschließend per Commit („Freischaltung“) übernommen werden, sondern beziehen auch Informationen über die Aktivitäten anderer Nutzer. Die Aktualität Ihrer Arbeitskopie können Sie über folgende Eingabe überprüfen:

Um eine eigene, neue Datei zur Versionsverwaltung hinzuzufügen oder eine überarbeitete Datei für den nächsten Commit anzumelden, wenden Sie den Befehl „git add“ auf diese Datei an (diese muss sich hierfür im Arbeitsverzeichnis befinden). In unserem Git-Tutorial fügen wir exemplarisch ein Textdokument mit dem Namen „Test“ hinzu:

Sämtliche Änderungen, die Sie (wie im vorherigen Abschnitt beschrieben) für die Versionsverwaltung angemeldet haben, müssen immer per Commit bestätigt werden, damit sie in den HEAD aufgenommen werden. Beim HEAD handelt es sich um eine Art Index, der auf den letzten wirksam gewordenen Commit in Ihrer aktuellen Git-Arbeitsumgebung (auch als „Branch“ bezeichnet) verweist. Das Kommando für diesen Schritt lautet:

Wie der Screenshot zeigt, erhalten Sie nach der Ausführung von „git commit“ eine zusammenfassende Meldung zu dem Commit: In den voranstehenden eckigen Klammern steht zum einen der Name der Branch (Projektzweig; hier „master“, da unser Arbeitsverzeichnis gleichzeitig auch das Hauptverzeichnis ist), in den die Änderungen übertragen wurden, zum anderen die SHA-1-Prüfsumme des Commits (hier „c0fdc90“). Es folgen der frei gewählte Kommentar (hier „Test“) und konkrete Informationen über die vorgenommenen Anpassungen.

Wenn Sie Änderungen in Form eines Commits übernommen haben, können Sie den Inhalt nachträglich jederzeit überarbeiten oder ihn gänzlich zurücknehmen. Ein typischer Fall, bei dem Anpassungen notwendig sind, ist beispielsweise der, dass Sie den Commit zu früh generiert und einige wichtige Dateien bzw. Anpassungen vergessen haben. In diesem Fall gilt es, die neuen bzw. angepassten Dateien nachträglich per „git add“ bereitzustellen und die Eintragung ins Haupt-Repository wiederholen. Hierfür hängen Sie dem Standardbefehl die Option --amend an:

Wollen Sie den zuletzt generierten Commit hingegen wieder zurücknehmen, gelingt dies mit folgendem Git-Kommando:

Durch dieses Kommando wird der zuletzt in den HEAD aufgenommene Commit zurückgenommen. Die darin enthaltenen Dateien werden dabei wieder in den Status als „geplante Änderungen für den nächsten Commit“ zurückgesetzt. Sollen die Arbeitsdaten hingegen gänzlich gelöscht werden, verwenden Sie anstelle des voranstehenden Kommandos folgenden Befehl:

Das Projektmanagement mit Git zu lernen, lohnt sich insbesondere aufgrund der elementaren Versionierungs-Features. Ein großes Plus des Open-Source-Systems besteht darin, dass Sie sich jederzeit anzeigen lassen können, welche Änderungen zuletzt am Repository vorgenommen worden sind. Der hierfür benötigte Git-Befehl lautet:

Das log-Kommando lässt sich außerdem mithilfe verschiedener Parameter modifizieren. Einige nützliche Optionen sind in der nachfolgenden Tabelle aufgeführt:

Bis hierhin haben wir in diesem Git-Tutorial aufgezeigt, wie Sie Änderungen als Commit im HEAD des lokalen Verzeichnisses speichern. Damit diese aber auch in das Haupt-Repository aufgenommen werden, ist die Eingabe folgenden Befehls erforderlich:

Durch ihn überträgt Git automatisch alle erstellten Commits, die bisher nur in der Arbeitskopie vorhanden waren, in das Hauptverzeichnis, das auch die Bezeichnung „master“ hat. Ersetzen Sie diesen Namen in dem aufgeführten Code durch den eines anderen Branches (Projektzweigs), werden die Dateien stattdessen direkt dorthin gesendet.

Wie viele andere Versionskontrollsysteme verfügt auch Git über eine Tagging-Funktion, mit der sich ausgewählte Punkte in der Historie eines Repositorys als wichtig markieren lassen. Typischerweise werden solche Tags dazu verwendet, Releases einer Software wie Version 1.0, 2.0 usw. zu kennzeichnen, damit diese auch bei großen Projekten jederzeit leicht abrufbar bleiben. Git unterstützt dabei zwei Arten von Tags:

• Annotierte Tags („annotated“) werden als eigenständige Objekte in der Datenbank gespeichert, inklusive eigener Prüfsumme, Tagging-Meldung, Datum, Name und Mail-Adresse des Tag-Erstellers sowie optionaler GNU-Privacy-Guard-Signatur (GPG-Signatur).
• Nicht-annotierte Tags („lightweight“) fungieren – ähnlich wie Branches – ausschließlich als Verweis auf einen Commit. Dieser Typ bietet sich dann an, wenn Sie lediglich temporäre Tags benötigen oder die erweiterten Informationen nicht speichern wollen.

Annotierte Tags erstellen Sie in Git, indem Sie den Befehl „git tag -a“ auf den gewünschten Commit anwenden. Hängen Sie außerdem den Parameter „-m“ an, können Sie – in gerade Anführungszeichen gesetzt – auch direkt in der Kommandozeile die gewünschte Tagging-Meldung formulieren. In diesem Git-Tutorial haben wir den Commit „Test“ generiert, den wir zu diesem Zweck auch mit einem Tag inklusive der Meldung „example tag“ verknüpfen:

Für nicht-annotierte Tags gehen Sie ähnlich vor: Allerdings wenden Sie ausschließlich den Grundbefehl „git tag“ auf den gewünschten Commit an und verzichten auf weitere Parameter. Für unser Git-Tutorial-Beispiel würde dies folgendes Kommando bedeuten:

Sobald Tags für Ihr Repository existieren, können Sie sich diese mit dem bereits bekannten „git tag“ und den optionalen Parametern „-l“ bzw. „--list“ anzeigen lassen:

Um einen Tag aus dem lokalen Arbeitsverzeichnis zu löschen, wenden Sie die Befehlskette „git tag -d“ auf diesen an. Unseren Verweis auf „Test“ entfernt man also folgendermaßen:

Auch Tags müssen Sie im Übrigen wie Commits manuell in das Hauptverzeichnis übertragen. Dafür werden der Tag-Name sowie das Kommando „git push origin“ benötigt. Statt des Tag-Namens können Sie aber auch den Parameter „--tags“ anhängen, wodurch alle generierten Tags im Repository aufgenommen werden:

Die in diesem Git-Tutorial bereits erwähnten Branches stellen im Prinzip nichts Anderes als einzelne Arbeitsversionen des Haupt-Respositorys dar, das selbst als Branch – mit dem Namen „master“ – eingestuft wird. Mit diesen Arbeitszweigen bietet Git die perfekte Grundlage dafür, Features und Funktionen isoliert voneinander zu entwickeln und erst zu einem späteren Zeitpunkt zusammenzuführen. Letzteres bezeichnet man auch als „mergen“ (von engl. merge „verschmelzen“).

Einen neuen Branch zu erstellen, ist nicht schwer: Sie benötigen lediglich die Anweisung „git branch“ und hängen dieser die gewünschte Bezeichnung für den Zweig an. Einen Beispiel-Branch mit dem Namen „test_branch“ erstellen Sie beispielsweise auf folgende Weise:

Anschließend können Sie jederzeit mit der Anweisung „git checkout“ in diesen Branch wechseln:

Wollen Sie Branches zusammenführen, gelingt dies mit dem Kommando „git merge“. Wechseln Sie zunächst via „checkout“ in das Verzeichnis, das einen anderen Zweig aufnehmen soll und führen Sie dort dann den genannten Befehl inklusive des Namens des aufzunehmenden Branchs aus. Unsere Arbeitsversion „test_branch“ lässt sich beispielsweise folgendermaßen in das Haupt-Repository mergen:

Haben Sie Arbeitszweige zusammengeführt und benötigen daher einen bestimmten Branch nicht mehr, können Sie diesen ganz einfach löschen. Zu diesem Zweck wenden Sie die Befehlsfolge „git branch -d“ auf den nicht mehr benötigten Versionszweig an. Unser Git-Tutorial-Beispiel „test_branch“ lässt sich durch folgende Eingabe entfernen: