| ... | ... | @@ -21,19 +21,15 @@ In Gitlab _Personal Profile_ (oben rechts) -> _Edit Profile_ auswählen und in d |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
# Installation von git auf deinem Rechner
|
|
|
|
Die Installation erfolgt jeweils auf MAC, WIN und LIN wie folgt:
|
|
|
|
* **MAC:** Terminaleingabe: `brew install git`
|
|
|
|
* **WINDOWS:** Download über [https://gitforwindows.org/](https://gitforwindows.org/)
|
|
|
|
* **LINUX:** Terminaleingabe: `sudo apt install git-gui`
|
|
|
|
Zum starten der Gui: `git citool`
|
|
|
|
|
|
|
|
Weitere GUIs:
|
|
|
|
[https://git-scm.com/downloads/guis](https://git-scm.com/downloads/guis)
|
|
|
|
# Installation von git-cola auf deinem Rechner
|
|
|
|
|
|
|
|
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`
|
|
|
|
|
|
|
|
|
|
|
|
# Klonen : Das Projekt vom Server laden
|
|
|
|
Ziel ist das Klonen des Repositories "HelloWorld" auf das eigene System, um lokal auf die Inhalte zugreifen zu können. Mithilfe von git gui erfolgt dies auf allen Systeme analog. Einzig das SSL-Zertifikat und die Benutzerdaten müssen zuvor **einmalig** hinterlegt werden.
|
|
|
|
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.
|
|
|
|
|
|
|
|
## Vorbereitung (Einmalig nach Installation)
|
|
|
|
* **MAC:**
|
| ... | ... | @@ -59,17 +55,16 @@ Terminaleingabe: |
|
|
|
|
|
|
|
## Klonen des Projekts (Repository)
|
|
|
|
|
|
|
|
#### a) Starten von Git Gui und Auswahl von Clone Repository
|
|
|
|
#### a) Starte _git-cola_ und klicke auf _Klonen..._
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
#### b) Job-Spezifikation
|
|
|
|
Anschließend erfolgt die Eingabe der Repository-Adresse und des Speicherpfades. Hierzu muss ein neuer Ordner erstellt werden, was durch manuelle Eingabe von /neuerordner an den lokalen Dateipfad erfolgt (im Bild wird der neue Ordner als HelloWorld bezeichnet).
|
|
|
|
|
|
|
|
|
|
|
|
Anschließend erfolgt die Eingabe der Repository-Adresse und auswahl des Speicherpfades.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Die 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`
|
|
|
|
|
| ... | ... | @@ -77,50 +72,57 @@ Die Adresse kann auf der Repository Seite eingesehen und in die Zwischenablage k |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
#### c) Es wird nach einer Authentifizierung gefragt. Hierzu den zuvor ermittelten Benutzernamen und das festgelegte Passwort eingeben. **[[In Linux wurden die Daten 3 mal hintereinander abgefragt, ist das bei Win und Mac genauso?]]**
|
|
|
|
#### c) Es wird nach einer Authentifizierung gefragt. Hierzu den zuvor ermittelten Benutzernamen und das festgelegte Passwort eingeben.
|
|
|
|
> ID: mmustermann
|
|
|
|
> PW: 123456
|
|
|
|
|
|
|
|
Sofern die Eingabe fehlerhaft ist, kann der folgende Fehler erscheinen:
|
|
|
|
|
|
|
|
|
|
|
|
> WINDOWS: Ggf. müssen die zuvor eingegebenen und gespeicherten Zugangsdaten angepasst werden. Hierzu mittels WIN+R nach `control /name Microsoft.CredentialManager` suchen. Anschließend können unter "Windows-Anmeldeinformationen" die git Zugangsdaten angepasst werden.
|
|
|
|
#### d) Nun wurde das Projekt geklont und es muss ein neuer Branch erstellt werden.
|
|
|
|
|
|
|
|
|
|
|
|
## Erstellen von einem Branch im Projekt (Repository)
|
|
|
|
|
|
|
|
#### d) Anschließend öffnet sich die git gui Oberfläche.
|
|
|
|
|
|
|
|
Zum erstellen von einem neuen Branch klickt man auf _Branch_ **(1)** und anschließend auf _Neu_ **(2)**
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Anschließend gibt man dem neuen Branch einen Namen, z.b. Gruppe01 **(1)** und klickt auf _Branch erstellen_ **(2)**.
|
|
|
|
|
|
|
|
# [[Das Klonen ist schon erfolgt und der rest klappt zumindest auf Linux nicht]]
|
|
|
|
|
|
|
|
|
|
|
|
#### e) Das Klonen erfolgt durch Betätigung vordefinierter Buttons in folgender Reihenfolge:
|
|
|
|
1. Rescan
|
|
|
|
2. Stage Changed
|
|
|
|
3. Commit (mit Texthinweis!)
|
|
|
|
4. Push
|
|
|
|
|
|
|
|
# Push: Hochladen von Dokumenten ins Repository
|
|
|
|
Die lokal vorhandenen Branches werden unter _Branches_ **(1)** angezeigt, wo der aktuell ausgewählte Branch mit einem Stern gekennzeichnet ist.
|
|
|
|
|
|
|
|
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.
|
|
|
|
|
|
|
|
#### f) Bestätigung des Klon-Vorganges
|
|
|
|
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.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Nun sollte sich das Repository lokal im gewählten Ordner befinden.
|
|
|
|
|
|
|
|
Zum hochladen der Daten klickt man auf _Befehle_ **(1)** und anschließend auf _Veröffentlichen_ **(2)**.
|
|
|
|
|
|
|
|
# Push: Hochladen von Dokumenten ins Repository
|
|
|
|
* 1. Neues Dokument "Neue Textdatei" lokal im selbigen Verzeichnis anlegen
|
|
|
|
* 2. Einpflegen der Änderungen und Hochladen ins Repository über
|
|
|
|
1. Rescan
|
|
|
|
2. Stage Changed
|
|
|
|
3. Commit (mit Texthinweis!)
|
|
|
|
4. Push
|
|
|
|
|
|
|
|
|
|
|
|
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_.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Sollte schon ein externer Branch erstellt worden sein, so wählt man diesen zuvor aus **(1)** und klickt auf _Veröffentlichen_ **(2)**.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
# Pullen eines Projektes
|
|
|
|
Sollte das git-Repo (Projekt) unterschiede zur lokalen Kopie aufweisen, muss vor dem arbeiten am Projekt ein sog. "pull" stattfinden.
|
|
|
|
|
|
|
|
Sofern alles funktioniert, bitte die zusätzlich erstellte Datei löschen.
|
|
|
|
Dafür wählt man den Reiter _Befehle_ **(1)** aus und klickt auf _Holen..._ **(2)**
|
|
|
|
|
|
|
|
> Sofern das git-Repo unterschiede zur lokalen Kopie aufweist, muss vor dem Rescan ein sog. "pull" stattfinden. Dazu über Remote - Fetch from - origin auswählen und anschließend mittels Merge - local Merge (mit merge bestätigen) die lokale Kopie aktualisieren.
|
|
|
|
|
|
|
|
|
|
|
|
# Weiterführende Themen:
|
|
|
|
* [Workflow: lokales Projekt in GitLab anlegen](https://git-ce.rwth-aachen.de/assistance-systems/helloworld/-/wikis/Workflow:-lokales-Projekt-in-GitLab-anlegen)
|
| ... | ... | |
