Bearbeiten von „Git“

=Git und Versionsverwaltungssysteme (VCS)=

==Git==

* Software zur Versionsverwaltung für Software-Projekte
* arbeitsteilige Softwareprojekte
* verschiedene Code-Bestandteile pro Entwickler 
* automatisierte Zusammenführung

==Versionsverwaltungssysteme==

* prinzipiell ließe sich Git komplett ohne ein Web-Interface oder zentralen Server verwenden
* "GitHub" (und auch "GitLab", "Bitbucket", ...) ist ein Versionsverwaltungssystem (VCS) hostet kostenlos die OpenSource-Projekte der Entwickler
* reichert den Funktionsumfang von Git auch zusätzlich an
* Dank grafischer Darstellung im Browser lässt sich der Entwicklungsprozess von Software-Projekten anschaulich darstellen
* Außerdem kann ein Großteil der Features, zum Beispiel das „Forken“ eines Projekts, auch durch einen Mausklick ausgeführt werden und benötigt keinen Kommandozeilen-Befehl mehr
* Änderungen von allen Autoren werden gespeichert 
* über Client-Applikationen für Git, hauptsächlich Kommandozeilen-Tools, können Entwickler ihre Änderungen an einem Projekt zentral einreichen
* GitHub stellt diese Änderungen ausführlich auf der zugehörigen Webseite dar. 
* Außerdem speichert Git jede Version des Software-Projekts
* mit Git könnt ihr immer auf die vorherige Version zugreifen
* Community-Features wie Repository oder einem Entwickler folgen
* Wiki-Funktionen für jedes Projekt
* Support-System, um auftretende Probleme bei Nutzern direkt und übersichtlich bearbeiten zu können

=Grundlegende Begriffe bzw. Elemente=

==Repository==

* kann bei GitHub einfach als „Projekt“ verstanden werden
* Dateien für ein Software-Projekt werden in einem Repository abgelegt

==Branch==

* Innerhalb eines Repositories kann es mehrere Versionen einer Software geben. Zum Beispiel eine experimentelle Beta-Version und eine stabile Version für den Produktiv-Einsatz. 
* Jede Version stellt dabei einen Branch („Ast“) des Repositories dar. 

==Commit==

* „Commit“ nennt sich der Vorgang, wenn eine neue Version eines Branches bei der Versionsverwaltung eingereicht wird. Das heißt, nachdem der Entwickler einen Vorgang an einer Software abgeschlossen hat, „committed“ er die Änderungen.

==Pull Request==

Hat ein Entwickler einen Bug gefixt oder eine neue Funktion eingebaut, möchte er, dass seine Änderung in das ursprüngliche Projekt einfließt. Deswegen stellt er einen „Pull Request“ an den Administrator des jeweiligen Projekts. Dieser kann sich die Änderungen dann ansehen und entscheiden, ob er den Pull durchführen möchte, oder nicht. 

==Fork==

Da alle öffentlichen Git-Projekte unter OpenSource-Lizenz stehen, kann auch jeder einen eigenen Ableger eines Repositories, einen sogenannten „Fork“, starten. Dort kann jeder privat vor sich hin entwickeln und seine Version am Ende wieder dem ursprünglichen Projekt zuführen (Pull Request stellen) – oder aber einfach eine eigenständige Variante verbreiten.

=Grundlegende Befehle=

==Shellbefehle==

* [[Shellbefehle]] im Allgemeinen, um z. B. Ordner anzulegen, Verzeichnisse zu wechseln etc.

==Git-spezifische Befehle==

<pre>
git --version
</pre>
auf dem Rechner installierte Version prüfen

<pre>
git clone
</pre>
Projekt wird von GitLab auf lokalen Ordner kopiert (einmalig am Anfang)

<pre>
git log
</pre>
= history (schließen mit "q")

<pre>
git status
</pre>
= ?

<pre>
git add Datei
</pre>
= Änderung einer Datei vormerken (geänderte Datei wird grün)

<pre>
git add .
</pre>
= Änderung aller Dateien vormerken (geänderte Datei wird grün)

<pre>
git reset
</pre>
= alle vorgemerkten Änderungen/Dateien (git add) wieder entfernen

<pre>
git reset [FILE]
</pre>
= bestimmte vorgemerkten Änderungen/Datei (git add) wieder entfernen

<pre>
git commit
</pre>
= ?

<pre>
-m "Erklärung"
</pre>
= Kommentar zum commit

<pre>
git merge
</pre>
= ?

<pre>
git push
</pre>
= Änderung auf den Server schieben

<pre>
git pull
</pre>
= Aktuelle Version vom Server holen (um damit zu arbeiten)

<pre>
git diff master [local-file-path]
</pre>
= Unterschied zu file im Repo anschauen

=Grundlegende, wichtige Workflows=

==Neues Git Repository anlegen==

===Lokales Verzeichnis anlegen===

<code>
mkdir ORDNERNAME
</code>

===Ins neue Verzeichnis wechseln===

<code>
cd ORDNERNAME
</code>

===Verzeichnis initialiseren===

<code>
git init
</code>

===TBD===

<code>
touch README.md
</code>

===TBD===

<code>
git add README.md
</code>

===TBD===

<code>
git commit -m "first commit"
</code>

===TBD===

<code>
git remote add origin git@gitlab.i-fabrik.net:sebastian/typo3testpage.git
</code>

===TBD===

<code>
git push -u origin master
</code>

==Lokales Verzeichnis in bestehendes entferntes Git-Repository laden==

===Voraussetzung(en)===

* Repository existiert auf GitLab

===Zu lokalem Projektordner wechseln===

<code>
cd BESTEHENDER_ORDNER
</code>

===Lokales Verzeichnis initialisieren===

<code>
git init
</code>

===TBD===

<code>
git remote add origin git@gitlab.i-fabrik.net:sebastian/typo3testpage.git
</code>

===Alle Dateien zum INDEX hinzufügen===

<code>
git add .
</code>

===Alle Dateien zum HEAD hinzufügen===

<code>
git commit -m "KOMMENTAR"
</code>

===Dateien zum entfernten Repository senden===

* Änderungen sind jetzt im HEAD
* nun, Änderungen zum entfernten Repository senden

<code>
git push -u origin master
</code>

==Dateien erzeugen==

<code>
touch file_A
touch file_B
touch file_C
</code>

==Dateien zum Repo hinzufügen und committen==

<code>
git add file_*
git commit -m "version 1"
</code>

==Repo auf Github erzeugen und Dateien ins remote Repo uploaden==

<code>
git remote add origin git@github.com:GwenDragon/test.git
git push -u origin master
</code>

==Datei aus lokalem Repo löschen==

<code>
git rm file_A
</code>

==lokale Änderung committen und an remote Repo melden==

<code>
git commit -m "version 2"
git push -u origin master
</code>

==Geänderte Dateien von Lokal zum Repository pushen==

1) Änderung einer Datei vormerken

<code>
git add DATEINAME
</code>

2) Vormerkung überprüfen

<code>
git status (vorgemerkte Datei ist grün ansehen)
</code>

3) Commit vorbereiten 

<code>
git commit  -m "Erklärung" (Kommentar zum commit)
</code>

4) Änderung zum Server übertragen

<code>
git push
</code>

== Neuen "Feature"-Branch erstellen und Änderungen hinzufügen ==

1) Neuen Branch anlegen

<code>
git branch BRANCHNAME
</code>

2) Zum neuen Branch wechseln

<code>
git checkout
</code>

3) Änderungen zum neuen Branch hinzufügen

<code>
git push -u origin BRANCHNAME
</code>

=="Feature"-Branch mit "Master"-Branch mergen==

1) Zum Master-Branch wechseln

<code>
git checkout master
<code>

2) Branch zum Merge vormerken

<code>
git merge feature
</code>

3) Vormerkung überprüfen

<code>
git status (vorgemerkte Datei ist grün ansehen)
</code>

4) Commit vorbereiten 

<code>
git commit  -m "Erklärung" (Kommentar zum commit)
</code>

5) Änderung zum Server übertragen

<code>
git push
</code>

=Tutorials=

* https://www.youtube.com/watch?v=YRSxGDXSj5w (Allgemeine Einführung zum Verständnis)
* https://svij.org/blog/2014/10/25/git-fur-einsteiger-teil-1/
* https://www.atlassian.com/git/tutorials/comparing-workflows
* https://rogerdudler.github.io/git-guide/index.de.html
* Quelle: https://git-scm.com/book/de/v2/Git-Branching-Einfaches-Branching-und-Merging



[[Kategorie:Web-Entwicklung]]