RoWaWorld

Eine ältere Version des Dokuments wurde geladen! Beim Speichern wird eine neue Version des Dokuments mit diesem Inhalt erstellt.

</WRAP>

Git ist ein verteiltes Versionsverwaltungssystem für Quellcode und andere textbasierte Projektdateien.

Es ermöglicht, Änderungen nachvollziehbar zu speichern, frühere Entwicklungsstände wiederherzustellen und die Entwicklung eines Projekts in einzelne, überschaubare Schritte zu gliedern.

Git arbeitet zunächst **lokal**. Ein Dienst wie GitHub ist für die grundlegende Arbeit mit Git nicht erforderlich.

<WRAP rww-back>
[[:werkzeuge:start|←]] [[:werkzeuge:start|Werkzeuge]]
</WRAP>

----

===== Grundbegriffe =====

**Repository**

Ein Repository ist ein von Git verwaltetes Projektverzeichnis. Es enthält neben den eigentlichen Projektdateien auch die Versionshistorie.

**Working Tree**

Der Working Tree ist der aktuelle Arbeitsstand der Dateien im Projektverzeichnis.

**Staging Area**

In der Staging Area werden gezielt die Änderungen gesammelt, die in den nächsten Commit aufgenommen werden sollen.

**Commit**

Ein Commit speichert einen definierten Entwicklungsstand dauerhaft in der lokalen Git-Historie.

**Branch**

Ein Branch ist ein Entwicklungszweig. Der Hauptzweig eines neuen Projekts heißt üblicherweise ''main''.

----

===== Repository anlegen =====

Im Stammverzeichnis des Projekts:

Dadurch wird das aktuelle Verzeichnis zu einem Git-Repository.

Git legt dafür das versteckte Verzeichnis ''.git'' an.

----

===== Status prüfen =====

<code>
git status
</code>

Dieser Befehl gehört zu den wichtigsten Git-Befehlen.

Er zeigt unter anderem:

* neue, noch nicht versionierte Dateien
  * geänderte Dateien
  * gelöschte Dateien
  * für den nächsten Commit vorgemerkte Änderungen
  * den aktuellen Branch

Vor einem Commit sollte der Status grundsätzlich kontrolliert werden.

----

===== Dateien für einen Commit vormerken =====

Eine einzelne Datei:

<code>
git add dateiname
</code>

Mehrere bestimmte Dateien:

<code>
git add datei1 datei2 datei3
</code>

Alle Änderungen im aktuellen Projekt:

''git add'' erstellt noch keinen Commit. Die Änderungen werden lediglich in die Staging Area aufgenommen.

----

===== Vorgemerkte Änderungen kontrollieren =====

Eine kompakte Übersicht:

<code>
git diff --cached --stat
</code>

Die vollständigen Änderungen:

<code>
git diff --cached
</code>

Damit kann vor einem Commit geprüft werden, was tatsächlich gespeichert wird.

----

===== Commit erstellen =====

<code>
git commit -m "Beschreibung der Änderung"
</code>

Beispiel:

<code>
git commit -m "Geschaeftspartner auf Kontaktmodell umstellen"
</code>

Eine Commit-Nachricht sollte kurz und eindeutig beschreiben, welcher fachliche oder technische Entwicklungsstand gespeichert wird.

----

===== Git-Historie anzeigen =====

Ausführliche Darstellung:

Kompakte Darstellung:

<code>
git log --oneline
</code>

Beispiel:

<code>
1773c45 Objekt-Stamm mit Statusmodell implementieren
778ceb0 Datenbankkonfiguration dokumentieren
f72336e Initiale Laravel-Basis fuer RoWaBase
</code>

----

===== .gitignore =====

Mit der Datei ''.gitignore'' wird festgelegt, welche Dateien und Verzeichnisse Git nicht versionieren soll.

Bei einem Laravel-Projekt gehören beispielsweise sensible oder automatisch erzeugte Inhalte nicht ins Repository:

<code>
.env
/vendor
/node_modules
</code>

Besonders wichtig ist ''.env'', da diese Datei Passwörter und andere lokale Zugangsdaten enthalten kann.

Eine ''.env.example'' kann dagegen versioniert werden. Sie dokumentiert die benötigten Einstellungen, enthält aber keine echten Passwörter.

----

===== Typischer Arbeitsablauf =====

Ein einfacher Git-Arbeitszyklus:

<code>
git status
git add <Dateien>
git status
git diff --cached --stat
git commit -m "Beschreibung"
git status
</code>

Damit ergibt sich der Ablauf:

- Änderungen durchführen
  - Status prüfen
  - gewünschte Änderungen vormerken
  - Commit-Inhalt kontrollieren
  - Commit erstellen
  - sauberen Arbeitsstand prüfen

Nach einem erfolgreichen Commit sollte ''git status'' im Idealfall melden:

<code>
nothing to commit, working tree clean
</code>

----

===== Git und GitHub =====

Git und GitHub sind nicht dasselbe.

**Git** ist das Versionsverwaltungssystem und arbeitet auch vollständig lokal.

**GitHub** ist eine Online-Plattform, auf der Git-Repositories gespeichert, synchronisiert und gemeinsam bearbeitet werden können.

Die lokale Versionsverwaltung sollte daher unabhängig von GitHub verstanden und eingerichtet werden.

----

===== Praxis: RoWaBase =====

RoWaBase verwendet Git bereits während der Entwicklung.

Dabei werden fachlich zusammengehörige Änderungen möglichst in eigenen Commits gespeichert.

Beispiele:

<code>
Initiale Laravel-Basis fuer RoWaBase
Datenbankkonfiguration dokumentieren
Objekt-Stamm mit Statusmodell implementieren
Geschaeftspartner auf Kontaktmodell umstellen
</code>

Dadurch entsteht eine nachvollziehbare Entwicklungshistorie und ein stabiler Rückkehrpunkt nach jedem größeren Arbeitsschritt.

----

===== Merksatz =====

<WRAP info>
**Git speichert nicht einfach Dateien – Git dokumentiert Entwicklungsstände.**

Deshalb sollten Commits klein, nachvollziehbar und fachlich zusammengehörig sein.
</WRAP>

Zusammenfassung