Skip to content

Changes

Page history
home aktualisieren authored by Tom Tiltmann's avatar Tom Tiltmann
Hide whitespace changes
Inline Side-by-side
home.md
View page @ 701b6d1c
Dieser Wiki Artikel soll dir den allgemeinen Umgang mit git als Dateiablage mit Versionsverwaltung vermitteln. Zum Einstieg empfiehlt es sich die die Kapitel nacheinander und mit eigenem Rechner auszuprobieren. Dieser Wiki Artikel soll dir den allgemeinen Umgang mit git als Dateiablage mit Versionsverwaltung vermitteln. Zum Einstieg empfiehlt es sich die die Kapitel nacheinander und mit eigenem Rechner auszuprobieren.
[[_TOC_]] [[_TOC_]]
# **Rollen in einem Git-Repository** # **Rollen in einem Git-Repository**
<details>
<summary>Die 5 Rollen in einem Respository</summary> <details>
<summary>Die 5 Rollen in einem Respository</summary>
* **Owner** - Besitzer der Repository. Er besitzt alle Rechte und hat keine Einschränkungen in der Verwaltung eines Repositories.
* **Maintainer** - Pflegt die Repository und kann die Rollenverteilung der Mitglieder verwalten. * **Owner** - Besitzer der Repository. Er besitzt alle Rechte und hat keine Einschränkungen in der Verwaltung eines Repositories.
* **Developer** - Kann Programmcode in das Repository hinzufügen (Push). * **Maintainer** - Pflegt die Repository und kann die Rollenverteilung der Mitglieder verwalten.
* **Reporter** - Kann das Repository durchforsten und vorhandene Issues an die Developer verteilen. * **Developer** - Kann Programmcode in das Repository hinzufügen (Push).
* **Guest** - Hat die wenigsten rechte. Als Gast kann man lediglich sich das Repository anschauen und klonen * **Reporter** - Kann das Repository durchforsten und vorhandene Issues an die Developer verteilen.
* **Guest** - Hat die wenigsten rechte. Als Gast kann man lediglich sich das Repository anschauen und klonen
Eine genauere Auflistung aller Rechte ist unter folgendem Link zu finden:
`https://docs.gitlab.com/ee/user/permissions.html#project-members-permissions` Eine genauere Auflistung aller Rechte ist unter folgendem Link zu finden: `https://docs.gitlab.com/ee/user/permissions.html#project-members-permissions`
</details> </details>
# **Begriffserklärung**
# **Begriffserklärung**
<details> <details>
<summary>Wichtige Begriffe</summary> <summary>Wichtige Begriffe</summary>
* **Repository** - Ist ein verwaltetes Verzeichnis zur Speicherung und Beschreibung digitaler Objekte für ein digitales Archiv (Projekt). * **Repository** - Ist ein verwaltetes Verzeichnis zur Speicherung und Beschreibung digitaler Objekte für ein digitales Archiv (Projekt).
* **Branch** - Entwicklungszweig eines Projektes, wichtig für die gleichzeitige Entwicklung eines Projektes. Wird ein Branch zum Hauptzweig des Repositories zurück geführt so wird dies als Merge bezeichnet. * **Branch** - Entwicklungszweig eines Projektes, wichtig für die gleichzeitige Entwicklung eines Projektes. Wird ein Branch zum Hauptzweig des Repositories zurück geführt so wird dies als Merge bezeichnet.
* **Index** - Auflistung der aktuell bereitgestellten veränderten Dateien. * **Index** - Auflistung der aktuell bereitgestellten veränderten Dateien.
* **Snapshot** - Abbild der aktuell bereitgestellten Änderungen * **Snapshot** - Abbild der aktuell bereitgestellten Änderungen
**Git-Befehle** **Git-Befehle**
* **Clone** - Legt eine lokale kopie eines existierenden Git-Repository an.
* **Pull** - Wird verwendet, um Inhalte aus einem Remote-Repository herunterzuladen und das lokale Repository zu aktualisieren. * **Clone** - Legt eine lokale kopie eines existierenden Git-Repository an.
* **Add** - Fügt die veränderten Dateien zum sogenannten Index hinzu. * **Pull** - Wird verwendet, um Inhalte aus einem Remote-Repository herunterzuladen und das lokale Repository zu aktualisieren.
* **Commit** - Erfasst einen Snapshot (Abbild) der aktuell bereitgestellten Änderungen, die Dateien im Index, des Projekts. * **Add** - Fügt die veränderten Dateien zum sogenannten Index hinzu.
* **Push** - Lädt Inhalte aus dem Snapshot in ein Remote-Repository hoch. * **Commit** - Erfasst einen Snapshot (Abbild) der aktuell bereitgestellten Änderungen, die Dateien im Index, des Projekts.
* **Push** - Lädt Inhalte aus dem Snapshot in ein Remote-Repository hoch.
![Gitlab_Aufbau](uploads/34b2bd2fd064f4c4d12b632da42e6f9c/Gitlab_Aufbau.png) ![Gitlab_Aufbau](uploads/34b2bd2fd064f4c4d12b632da42e6f9c/Gitlab_Aufbau.png)
</details>
</details>
# **Passwort für den HTTPS Zugriff erstellen**
# **Passwort für den HTTPS Zugriff erstellen** <details>
<details> <summary>Passwort</summary>
<summary>Passwort</summary>
**a)** In Gitlab _Personal Profile_ (oben rechts) -\> _Edit Profile_ auswählen und in der linken Leiste auf _Password_ klicken
**a)** In Gitlab _Personal Profile_ (oben rechts) -> _Edit Profile_ auswählen und in der linken Leiste auf _Password_ klicken
![Bild1](uploads/2dc13c40d30a71a348538eba40ab25d7/Bild1.png)
![Bild1](uploads/2dc13c40d30a71a348538eba40ab25d7/Bild1.png)
**b)** Passwort einstellen
**b)** Passwort einstellen
Im _Password_ Tab ein Passwort eingeben **(1)** (einfachheitshalber das Passwort für die CampusID eingeben) und _Save Password_ klicken **(2)**. Nach erfolgtem Passwort wechsel wird man ausgeloggt und muss sich mit dem neuen Passwort einloggen.
Im _Password_ Tab ein Passwort eingeben **(1)** (einfachheitshalber das Passwort für die CampusID eingeben) und _Save Password_ klicken **(2)**. Nach erfolgtem Passwort wechsel wird man ausgeloggt und muss sich mit dem neuen Passwort einloggen.
![Bild2](uploads/c9a335cec797b0f9107d471fda5b0687/Bild2.png)
![Bild2](uploads/c9a335cec797b0f9107d471fda5b0687/Bild2.png)
</details>
</details>
# **Ermitteln des eigenen Benutzernamens**
# **Ermitteln des eigenen Benutzernamens** <details>
<details> <summary>Benutzername</summary>
<summary>Benutzername</summary>
In Gitlab _Personal Profile_ (oben rechts) findet man den eigenen Benutzernamen. Der Benutzername wird später benötigt und sollte nicht geändert werden.
In Gitlab _Personal Profile_ (oben rechts) findet man den eigenen Benutzernamen. Der Benutzername wird später benötigt und sollte nicht geändert werden.
![Git_Username](uploads/6d13bffcff1911e19971922b038ee3e0/Git_Username.png)
![Git_Username](uploads/6d13bffcff1911e19971922b038ee3e0/Git_Username.png)
</details>
</details>
# **Finden der Repository-Adresse**
# **Finden der Repository-Adresse**
<details> <details>
<summary>Kopieren der Repository-Adresse</summary> <summary>Kopieren der Repository-Adresse</summary>
Die Repository-Adresse kann auf der Repository Seite eingesehen und in die Zwischenablage kopiert werden. Dafür klickt man auf _Clone_ **(1)** und kopiert den https link **(2)**. Diese lautet in diesem Fall `https://git-ce.rwth-aachen.de/assistance-systems/helloworld.git` Die Repository-Adresse kann auf der Repository Seite eingesehen und in die Zwischenablage kopiert werden. Dafür klickt man auf _Clone_ **(1)** und kopiert den https link **(2)**. Diese lautet in diesem Fall `https://git-ce.rwth-aachen.de/assistance-systems/helloworld.git`
![Image3](uploads/f302b0ff83268e1e406ffef12f96d3ba/Image3.png) ![Image3](uploads/f302b0ff83268e1e406ffef12f96d3ba/Image3.png)
</details> </details>
# **Installation von Git** # **Installation von Git**
<details>
<summary>Installation von Git.</summary> <details>
<summary>Installation von Git.</summary>
**MacOS:**
Suche und öffne das Terminal in der Programmübersicht oder die Suchleiste (cmd+Leertaste). Anschließend führe folgenden Befehl aus: **MacOS:** Suche und öffne das Terminal in der Programmübersicht oder die Suchleiste (cmd+Leertaste). Anschließend führe folgenden Befehl aus:
`git` `git`
Es öffnet sich ein Pop-Up-Fenster, welches eine Abfrage nach der Installation der Command Line Developer Tools fragt. Bestätige diese über Installieren. Es öffnet sich ein Pop-Up-Fenster, welches eine Abfrage nach der Installation der Command Line Developer Tools fragt. Bestätige diese über Installieren.
**Ubuntu:** Um Git auf Ubuntu zu installieren öffnet man das Terminal (STRG+ALT+T) und führt folgende Befehle aus:
**Ubuntu:** Um Git auf Ubuntu zu installieren öffnet man das Terminal (STRG+ALT+T) und führt folgende Befehle aus: `sudo update`
`sudo update` `sudo apt install git`
`sudo apt install git` **Windows:** Um Git auf Windows zu installieren downloadet man die Installationsdatei von `https://gitforwindows.org/` und führt diese aus. Während der Installation sollten alle Voreinstellungen von git beibehalten werden.
## _Vorbereitung (Einmalig nach Installation)_
**Windows:** Um Git auf Windows zu installieren downloadet man die Installationsdatei von `https://gitforwindows.org/` und führt diese aus. Während der Installation sollten alle Voreinstellungen von git beibehalten werden.
Für _user.name_ sollte man den zuvor ermittelten Benutzernamen und für _user.email_ die TH-Köln E-Mail Adresse wählen.
## _Vorbereitung (Einmalig nach Installation)_
**Terminaleingabe (MAC/WINDOWS/LINUX):**
Für _user.name_ sollte man den zuvor ermittelten Benutzernamen und für _user.email_ die TH-Köln E-Mail Adresse wählen.
`git config --global http.sslVerify false`
**Terminaleingabe (MAC/WINDOWS/LINUX):**
`git config --global user.email "max.mustermann@smail.th-koeln.de"`
`git config --global http.sslVerify false`
`git config --global user.name "max.mustermann"`
`git config --global user.email "max.mustermann@smail.th-koeln.de"`
Beispiel: ![image](uploads/1dab16deb8d2910d23a430d951ff40a4/image.png)
`git config --global user.name "max.mustermann"`
**Zusätzlich für WINDOWS:**
Beispiel:
![image](uploads/1dab16deb8d2910d23a430d951ff40a4/image.png) Um das Git-Terminal zu starten klickt man mit der rechten Maustaste auf eine freie Stelle in einem Ordner und wählt _Git Bash Here_ aus.
**Zusätzlich für WINDOWS:** ## _Hinzufügen eines SSH Keys (optional)_
Um das Git-Terminal zu starten klickt man mit der rechten Maustaste auf eine freie Stelle in einem Ordner und wählt _Git Bash Here_ aus. Die Authentifizierung beim GitLab Server kann entweder mit Username und Passwort oder mit Hilfe eines SSH Keys durchgeführt werden. Möchte man die Authentifizierung mit einem SSH KEY durchführen, so muss zuerst ein Schlüsselpaar bestehend aus einem privaten und einem öffentlichen Schlüssel erzeugt werden. Im Folgenden wird dafür der Verschlüsselungsalgorithmus EdDSA verwendet. Alternativ kann auch RSA verwendet werden.
## _Hinzufügen eines SSH Keys (optional)_ **Terminaleingabe (MAC/WINDOWS/LINUX):**
Die Authentifizierung beim GitLab Server kann entweder mit Username und Passwort oder mit Hilfe eines SSH Keys durchgeführt werden. Möchte man die Authentifizierung mit einem SSH KEY durchführen, so muss zuerst ein Schlüsselpaar bestehend aus einem privaten und einem öffentlichen Schlüssel erzeugt werden. Im Folgenden wird dafür der Verschlüsselungsalgorithmus EdDSA verwendet. Alternativ kann auch RSA verwendet werden. `ssh-keygen -t ed25519 -C "<Kommentar>"`
Anschließend erscheint der folgende Output:
**Terminaleingabe (MAC/WINDOWS/LINUX):**
```
`ssh-keygen -t ed25519 -C "<Kommentar>"` Generating public/private ed25519 key pair.
Enter file in which to save the key (/home/<user>/.ssh/id_ed25519):
Anschließend erscheint der folgende Output: ```
``` Hier kann nun ein Speicherort für die Schlüssel angegeben werden. Durch Drücken der `Enter`-Taste ohne eine Eingabe wird der vorgeschlagene Speicherort verwendet.
Generating public/private ed25519 key pair.
Enter file in which to save the key (/home/<user>/.ssh/id_ed25519): Anschließend kommt noch die Frage, ob man ein Passwort (passphrase) für den privaten Schlüssel anlegen möchte.
```
```
Hier kann nun ein Speicherort für die Schlüssel angegeben werden. Durch Drücken der `Enter`-Taste ohne eine Eingabe wird der vorgeschlagene Speicherort verwendet. Enter passphrase (empty for no passphrase):
Enter same passphrase again:
Anschließend kommt noch die Frage, ob man ein Passwort (passphrase) für den privaten Schlüssel anlegen möchte. ```
``` Dies dient dazu, dass der Schlüssel selbst noch einmal mit einem Passwort geschützt ist, sodass der alleinige Besitz der Datei nicht zur Authentifizierung ausreicht. Mit einem Passwort handelt es sich dann um eine 2-Faktor-Authentifizierung.Anschließend muss der öffentliche Schlüssel bei GitLab hinterlegt werden. Hierzu muss der Inhalt der Datei des öffentlichen Schlüssels kopiert und bei GitLab hinzugefügt werden.
Enter passphrase (empty for no passphrase):
Enter same passphrase again: **macOS:** `tr -d '\n' < ~/.ssh/id_ed25519.pub | pbcopy`
```
**Linux** (benötigt `xclip` Paket): `xclip -sel clip < ~/.ssh/id_ed25519.pub`
Dies dient dazu, dass der Schlüssel selbst noch einmal mit einem Passwort geschützt ist, sodass der alleinige Besitz der Datei nicht zur Authentifizierung ausreicht. Mit einem Passwort handelt es sich dann um eine 2-Faktor-Authentifizierung. **Git Bash bei Windows:** `cat ~/.ssh/id_ed25519.pub | clip`
Anschließend muss der öffentliche Schlüssel bei GitLab hinterlegt werden. Hierzu muss der Inhalt der Datei des öffentlichen Schlüssels kopiert und bei GitLab hinzugefügt werden. Nach der Ausführen des entsprechenden Befehls befindet sich der öffentliche Schlüssel in der Zwischenablage.
Nun muss man sich bei GitLab einloggen und oben rechts auf den Avatar klicken. Anschließend klickt man auf **Preferences**. Dann klickt man auf der linken Leiste auf **SSH Keys**. In die **Key** Box kopiert man nun den Inhalt aus der Zwischenablage (`Strg` + `V`) und drückt anschließend auf **Add key**.
**macOS:**
```tr -d '\n' < ~/.ssh/id_ed25519.pub | pbcopy``` </details>
**Linux** (benötigt `xclip` Paket): # **Benutzen von Terminalbefehlen**
```xclip -sel clip < ~/.ssh/id_ed25519.pub```
## Pfadeinstellungen
**Git Bash bei Windows:**
```cat ~/.ssh/id_ed25519.pub | clip``` <details>
<summary>Pfadeinstellungen</summary>
Nach der Ausführen des entsprechenden Befehls befindet sich der öffentliche Schlüssel in der Zwischenablage. Die folgenden Befehle können nur ausgeführt werden, wenn der angezeigte Pfad im Terminal das Hauptverzeichnis des lokalen Repositories ist. Um im Terminal den Pfad zu wechseln gibt man folgenden Befehl ein, wobei der Zielpfad ist, zu dem man wechseln möchte:
Nun muss man sich bei GitLab einloggen und oben rechts auf den Avatar klicken. Anschließend klickt man auf **Preferences**. Dann klickt man auf der linken Leiste auf **SSH Keys**. In die **Key** Box kopiert man nun den Inhalt aus der Zwischenablage (`Strg` + `V`) und drückt anschließend auf **Add key**. `cd <Pfad>`
Für den Befehl `Clone` ist das ein beliebiger Ordner auf dem PC. Für die restlichen Befehle ist das anschließend der Ordner mit dem Namen des **remote-repositories**, der beim Klonen erstellt wurde.
</details> **Beispiel:** So kann das bspw. ein Ordner auf dem Desktop sein, in dem das geklonte Projekt gespeichert wird:
# **Benutzen von Terminalbefehlen** `/Users/<users>/Desktop/Local_repository`
Nach dem Klonen wird dann mit
## Pfadeinstellungen
<details> `cd helloworld`
<summary>Pfadeinstellungen</summary>
in den Ordner gewechselt, in dem auch ein untergeordneter **branch** erstellt werden kann.
</details>
Die folgenden Befehle können nur ausgeführt werden, wenn der angezeigte Pfad im Terminal das Hauptverzeichnis des lokalen Repositories ist. Um im Terminal den Pfad zu wechseln gibt man folgenden Befehl ein, wobei <Pfad> der Zielpfad ist, zu dem man wechseln möchte:
## Klonen der Repository (Projekt)
`cd <Pfad>`
<details>
Für den Befehl `Clone` ist das ein beliebiger Ordner auf dem PC. <summary>Klonen.</summary>
Für die restlichen Befehle ist das anschließend der Ordner mit dem Namen des **remote-repositories**, der beim Klonen erstellt wurde. Um ein Projekt zu Klonen, erstellt man ein Neuen Ordner für das Projekt, startet das Git-Terminal und wechselt in den Pfad des eben erstellten Ordners.Dann wird folgender Befehl im Terminal eingegeben:
**Beispiel:** `git clone <Repository-Adresse>`
So kann das bspw. ein Ordner auf dem Desktop sein, in dem das geklonte Projekt gespeichert wird:
In unserem Fall lautet die Repository-Adresse:
`/Users/<users>/Desktop/Local_repository`
`https://git-ce.rwth-aachen.de/assistance-systems/helloworld.git`
Nach dem Klonen wird dann mit
Der Befehl zum Klonen von diesem Repository lautet demnach:
`cd helloworld`
`git clone https://git-ce.rwth-aachen.de/assistance-systems/helloworld.git`
in den Ordner gewechselt, in dem auch ein untergeordneter **branch** erstellt werden kann.
</details> Nach erfolgreicher Eingabe von Benutzernamen und Passwort wird das Repository geklont.
</details>
## Erstellen von einem Branch
## Klonen der Repository (Projekt)
<details> <details>
<summary>Klonen.</summary> <summary>Branch erstellen</summary>
Um den neuen lokalen Branch (hier: Test) zu erstellen und in diesen Branch zu wechseln, gibt man folgenden Befehl ein:
Um ein Projekt zu Klonen, erstellt man ein Neuen Ordner für das Projekt, startet das Git-Terminal und wechselt in den Pfad des eben erstellten Ordners.
`git checkout -b Test`
Dann wird folgender Befehl im Terminal eingegeben:
> Mit dem checkout-Befehl ist es möglich jederzeit zwischen den verschiedenen Branches zu wechseln.
`git clone <Repository-Adresse>`
Nun wird mit dem push-Befehl der Branch _Test_ zum GitLab-Projekt (auf dem Server) hinzugefügt:
In unserem Fall lautet die Repository-Adresse:
`git push origin Test`
`https://git-ce.rwth-aachen.de/assistance-systems/helloworld.git`
</details>
Der Befehl zum Klonen von diesem Repository lautet demnach:
## Pushen von Daten
`git clone https://git-ce.rwth-aachen.de/assistance-systems/helloworld.git`
<details>
Nach erfolgreicher Eingabe von Benutzernamen und Passwort wird das Repository geklont. <summary>Pushen</summary>
</details>
**a)** Wenn Änderungen im lokalen Repository vorgenommen wurden, dann sollten diese zum Index mit folgendem Befehl hinzugefügt werden:
`git add .`
## Erstellen von einem Branch
<details> **b)** Nun kann ein Commit einschließlich einer Kurzbeschreibung der Änderung mit folgendem Befehl durchgeführt werden:
<summary>Branch erstellen</summary>
`git commit -m "Hier steht ein Kommentar"`
Um den neuen lokalen Branch (hier: Test) zu erstellen und in diesen Branch zu wechseln, gibt man folgenden Befehl ein: > Dadurch wird nicht das Repository auf GitLab aktualisiert, sondern nur das lokale Repository.
`git checkout -b Test` **c)** Nun können die Änderungen mit folgendem Befehl zum Remote-Repository hinzugefügt werden:
> Mit dem checkout-Befehl ist es möglich jederzeit zwischen den verschiedenen Branches zu wechseln. `git push <REMOTE> <BRANCHNAME>`
Nun wird mit dem push-Befehl der Branch _Test_ zum GitLab-Projekt (auf dem Server) hinzugefügt: > ist der Name des remote Servers. Wenn ein Projekt geklont wird, dann ist der von git vergebene Standardname `origin`.
`git push origin Test` In unserem Beispiel lautet der Befehl somit:
</details> `git push origin Test`
</details>
## Pushen von Daten ## Pullen von Daten
<details>
<summary>Pushen</summary> <details>
<summary>Pullen</summary>
**a)** Wenn Änderungen im lokalen Repository vorgenommen wurden, dann sollten diese zum Index mit folgendem Befehl hinzugefügt werden: Um Änderungen an einem remote Repository zu downloaden und mit dem lokalen Repository zu synchronisieren wird folgender Befehl ausgeführt:
`git add .` `git pull <PFAD> <BRANCHNAME>`
**b)** Nun kann ein Commit einschließlich einer Kurzbeschreibung der Änderung mit folgendem Befehl durchgeführt werden: > **Pfad** ist die Repository-Adresse. In unserem Beispiel lautet diese: `https://git-ce.rwth-aachen.de/assistance-systems/helloworld.git`
`git commit -m "Hier steht ein Kommentar"` Für unser Beispiel lautet der Befehl somit:
> Dadurch wird nicht das Repository auf GitLab aktualisiert, sondern nur das lokale Repository. `git pull https://git-ce.rwth-aachen.de/assistance-systems/helloworld.git Test`
**c)** Nun können die Änderungen mit folgendem Befehl zum Remote-Repository hinzugefügt werden: </details>
`git push <REMOTE> <BRANCHNAME>` # **Alternative: GUI**
> <REMOTE> ist der Name des remote Servers. Wenn ein Projekt geklont wird, dann ist der von git vergebene Standardname `origin`. <details>
<summary>Installation & Benutzung einer GUI.</summary>
In unserem Beispiel lautet der Befehl somit:
<details>
`git push origin Test` <summary>Installation von git-cola auf deinem Rechner</summary>
Für die installation der GUI _git-cola_ befolgt man die Anleitung für das jeweilige Betriebssystem auf folgender Seite: `http://git-cola.github.io/downloads.html`
</details>
</details>
## Pullen von Daten
<details> <details>
<summary>Pullen</summary> <summary>Klonen des Projekts (Repository)</summary>
Um Änderungen an einem remote Repository zu downloaden und mit dem lokalen Repository zu synchronisieren wird folgender Befehl ausgeführt: Ziel ist das Klonen des Repositories "HelloWorld" auf das eigene System, um lokal auf die Inhalte zugreifen zu können. Mithilfe von git-cola erfolgt dies auf allen Systeme analog. Einzig das SSL-Zertifikat und die Benutzerdaten müssen zuvor **einmalig** hinterlegt werden.
`git pull <PFAD> <BRANCHNAME>` **a)** Starte _git-cola_ und klicke auf _Klonen..._
> **Pfad** ist die Repository-Adresse. In unserem Beispiel lautet diese: `https://git-ce.rwth-aachen.de/assistance-systems/helloworld.git` ![image1](uploads/4eca54345da114ca469dc773e35bf9e8/image1.png)
Für unser Beispiel lautet der Befehl somit: **b)** Job-Spezifikation Anschließend erfolgt die Eingabe der Repository-Adresse und auswahl des Speicherpfades.
`git pull https://git-ce.rwth-aachen.de/assistance-systems/helloworld.git Test` ![image2](uploads/1724b7d4b55722bc80bde41e1181aa20/image2.png)
**c)** Es wird nach einer Authentifizierung gefragt. Hierzu den zuvor ermittelten Benutzernamen und das festgelegte Passwort eingeben.
</details>
> ID: mmustermann PW: 123456
# **Alternative: GUI** **d)** Nun wurde das Projekt geklont und es muss ein neuer Branch erstellt werden.
<details>
<summary>Installation & Benutzung einer GUI.</summary> </details>
<details>
<summary>Installation von git-cola auf deinem Rechner</summary> <details>
<summary>Erstellen von einem Branch</summary>
Für die installation der GUI _git-cola_ befolgt man die Anleitung für das jeweilige Betriebssystem auf folgender Seite:
`http://git-cola.github.io/downloads.html` Zum erstellen von einem neuen Branch klickt man auf _Branch_ **(1)** und anschließend auf _Neu_ **(2)**
</details>
![image3](uploads/8c1b76aae15637cc619400bd837dcc57/image3.png)
<details>
<summary>Klonen des Projekts (Repository)</summary> Anschließend gibt man dem neuen Branch einen Namen, z.b. Gruppe01 **(1)** und klickt auf _Branch erstellen_ **(2)**.
Ziel ist das Klonen des Repositories "HelloWorld" auf das eigene System, um lokal auf die Inhalte zugreifen zu können. Mithilfe von git-cola erfolgt dies auf allen Systeme analog. Einzig das SSL-Zertifikat und die Benutzerdaten müssen zuvor **einmalig** hinterlegt werden. ![image4](uploads/539e164e10fff6378213817da483bef0/image4.png)
**a)** Starte _git-cola_ und klicke auf _Klonen..._ </details>
![image1](uploads/4eca54345da114ca469dc773e35bf9e8/image1.png)
<details>
**b)** Job-Spezifikation <summary>Pushen des Projekts</summary>
Anschließend erfolgt die Eingabe der Repository-Adresse und auswahl des Speicherpfades.
Die lokal vorhandenen Branches werden unter _Branches_ **(1)** angezeigt, wo der aktuell ausgewählte Branch mit einem Stern gekennzeichnet ist.
![image2](uploads/1724b7d4b55722bc80bde41e1181aa20/image2.png)
Geänderte bzw. hinzugefügte Daten im geklonten Projekt Ordner werden im Hauptfesnter unter Zustand **(2)** angezeigt. Durch Doppeltklick auf die geänderten bzw. hinzugefügten Daten merkt diese für den Upload (Push) vor. Dies wird durch einen grünes Dreieck gekennzeichnet.
**c)** Es wird nach einer Authentifizierung gefragt. Hierzu den zuvor ermittelten Benutzernamen und das festgelegte Passwort eingeben.
> ID: mmustermann Um Daten uploaden (pushen) zu können, muss unter _Commit_ **(3)** einen kommentar eingeben werden (ggf. kann auch eine ausführliche Beschreibung hinzugefügt werden). Anschließend klickt man auf _Commit aufnehmen_. Dabei verschwinden die Daten aus dem Bereich Zustand **(2)**, was aber kein Grund zur sorge ist.
> PW: 123456
![image5](uploads/3a0eeff8420561ed8051dd5379b2ef09/image5.png)
**d)** Nun wurde das Projekt geklont und es muss ein neuer Branch erstellt werden.
</details> ![image6](uploads/86e5ce345d109d75e10320873b4e89bf/image6.png)
Zum hochladen der Daten klickt man auf _Befehle_ **(1)** und anschließend auf _Veröffentlichen_ **(2)**.
<details>
<summary>Erstellen von einem Branch</summary> ![image7](uploads/93b030cca67fde34abc94156e948f616/image7.png)
Zum erstellen von einem neuen Branch klickt man auf _Branch_ **(1)** und anschließend auf _Neu_ **(2)** Anschließend klickt man im nächsten Fenster auf _Veröffentlichen_, wenn man noch keinen Branch veröffentlicht hat. Daraufhin erscheint eine Meldung, dass der Branch noch nicht existiert und ob dieser erstellt werden soll, dies bestätigt man mit klick auf _Externen Branch erstellen_.
![image3](uploads/8c1b76aae15637cc619400bd837dcc57/image3.png) ![image8](uploads/b8fdd1d6920820b95cbaf93640dba011/image8.png)
Anschließend gibt man dem neuen Branch einen Namen, z.b. Gruppe01 **(1)** und klickt auf _Branch erstellen_ **(2)**. ![image9](uploads/e4464d4537015eac822527a47e55ab7b/image9.png)
![image4](uploads/539e164e10fff6378213817da483bef0/image4.png) Sollte schon ein externer Branch erstellt worden sein, so wählt man diesen zuvor aus **(1)** und klickt auf _Veröffentlichen_ **(2)**.
</details>
![image10](uploads/048fd8292b00ac4f67745680e56bae35/image10.png)
<details> </details>
<summary>Pushen des Projekts</summary>
Die lokal vorhandenen Branches werden unter _Branches_ **(1)** angezeigt, wo der aktuell ausgewählte Branch mit einem Stern gekennzeichnet ist. <details>
<summary>Pullen eines Projektes</summary>
Geänderte bzw. hinzugefügte Daten im geklonten Projekt Ordner werden im Hauptfesnter unter Zustand **(2)** angezeigt. Durch Doppeltklick auf die geänderten bzw. hinzugefügten Daten merkt diese für den Upload (Push) vor. Dies wird durch einen grünes Dreieck gekennzeichnet. Sollte das git-Repo (Projekt) unterschiede zur lokalen Kopie aufweisen, muss vor dem arbeiten am Projekt ein sog. "pull" stattfinden.
Um Daten uploaden (pushen) zu können, muss unter _Commit_ **(3)** einen kommentar eingeben werden (ggf. kann auch eine ausführliche Beschreibung hinzugefügt werden). Anschließend klickt man auf _Commit aufnehmen_. Dabei verschwinden die Daten aus dem Bereich Zustand **(2)**, was aber kein Grund zur sorge ist. Dafür wählt man den Reiter _Befehle_ **(1)** aus und klickt auf _Holen und zusammenführen_ **(2)**.
![image5](uploads/3a0eeff8420561ed8051dd5379b2ef09/image5.png) ![image11](uploads/3a03cb849ca413bbf5cfd739052936ba/image11.png)
![image6](uploads/86e5ce345d109d75e10320873b4e89bf/image6.png) Anschließend wählt man den Branch aus von dem man den sog. Pull machen möchte **(1)** und klickt auf _Holen und zusammenführen_ **(2)**.
Zum hochladen der Daten klickt man auf _Befehle_ **(1)** und anschließend auf _Veröffentlichen_ **(2)**. ![image12](uploads/cd89fa34ca36781ed636a4efa02a388d/image12.png)
![image7](uploads/93b030cca67fde34abc94156e948f616/image7.png) </details>
Anschließend klickt man im nächsten Fenster auf _Veröffentlichen_, wenn man noch keinen Branch veröffentlicht hat. Daraufhin erscheint eine Meldung, dass der Branch noch nicht existiert und ob dieser erstellt werden soll, dies bestätigt man mit klick auf _Externen Branch erstellen_. </details>
![image8](uploads/b8fdd1d6920820b95cbaf93640dba011/image8.png) # **Weiterführende Themen:**
![image9](uploads/e4464d4537015eac822527a47e55ab7b/image9.png) ## Lokales Projekt in GitLab anlegen
Sollte schon ein externer Branch erstellt worden sein, so wählt man diesen zuvor aus **(1)** und klickt auf _Veröffentlichen_ **(2)**. * [Workflow: lokales Projekt in GitLab anlegen](https://git-ce.rwth-aachen.de/assistance-systems/helloworld/-/wikis/Workflow:-lokales-Projekt-in-GitLab-anlegen)
![image10](uploads/048fd8292b00ac4f67745680e56bae35/image10.png) ## Integration der Git Funktionen im Finder (Mac!)
</details>
* [Integration der Git Funktionen im Finder (Mac!)](https://git-ce.rwth-aachen.de/assistance-systems/helloworld/-/wikis/Integration-der-Git-Funktionen-im-Finder-\(Mac!\))
<details> ## Readme für Projekt und Abschlussarbeiten
<summary>Pullen eines Projektes</summary>
* [Readme für Projekt und Abschlussarbeiten](https://git-ce.rwth-aachen.de/assistance-systems/helloworld/-/wikis/Anlegen-des-Wikis-f%C3%BCr-Projekt-und-Abschlussarbeiten)
Sollte das git-Repo (Projekt) unterschiede zur lokalen Kopie aufweisen, muss vor dem arbeiten am Projekt ein sog. "pull" stattfinden.
## Quelltext konventionen
Dafür wählt man den Reiter _Befehle_ **(1)** aus und klickt auf _Holen und zusammenführen_ **(2)**.
* [Quelltextkonventionen (C++)](https://git-ce.rwth-aachen.de/assistance-systems/tools/helloworld/-/wikis/Quelltextkonventionen-\(C++\))
![image11](uploads/3a03cb849ca413bbf5cfd739052936ba/image11.png) \ No newline at end of file
Anschließend wählt man den Branch aus von dem man den sog. Pull machen möchte **(1)** und klickt auf _Holen und zusammenführen_ **(2)**.
![image12](uploads/cd89fa34ca36781ed636a4efa02a388d/image12.png)
</details>
</details>
# **Weiterführende Themen:**
## Lokales Projekt in GitLab anlegen
* [Workflow: lokales Projekt in GitLab anlegen](https://git-ce.rwth-aachen.de/assistance-systems/helloworld/-/wikis/Workflow:-lokales-Projekt-in-GitLab-anlegen)
## Integration der Git Funktionen im Finder (Mac!)
* [Integration der Git Funktionen im Finder (Mac!)](https://git-ce.rwth-aachen.de/assistance-systems/helloworld/-/wikis/Integration-der-Git-Funktionen-im-Finder-(Mac!))
## Readme für Projekt und Abschlussarbeiten
* [Readme für Projekt und Abschlussarbeiten](https://git-ce.rwth-aachen.de/assistance-systems/helloworld/-/wikis/Anlegen-des-Wikis-f%C3%BCr-Projekt-und-Abschlussarbeiten)
## Quelltext konventionen
* [Quelltext konventionen](https://git-ce.rwth-aachen.de/assistance-systems/tools/helloworld/-/wikis/Quelltext-konventionen)
\ No newline at end of file