Skip to content
Snippets Groups Projects

Changes

Page history
  • New page
  • Templates
    • Update home authored by Orhan-Timo Altan's avatar Orhan-Timo Altan
    Show whitespace changes
    Inline Side-by-side
    Showing
    with 85 additions and 74 deletions
    home.md
    View page @ b29e4b53
    ......@@ -42,15 +42,26 @@ Im _Password_ Tab ein Passwort eingeben **(1)** (einfachheitshalber das Passwort
    ![Bild2](uploads/c9a335cec797b0f9107d471fda5b0687/Bild2.png)
    # Ermitteln des eigenen Benutzernamens
    In Gitlab _Personal Profile_ (oben rechts) -> _Edit Profile_ auswählen und in der linken Leiste auf _Account_ **(1)** klicken und im Bereich _Change Username_ den eigenen Benutzernamen notieren **(2)**. Der Benutzername wird später benötigt und sollte nicht geändert werden.
    ![Image2](uploads/7301732d0acb122d8b56f90e800c856d/Image2.png)
    # Finden der Repository-Adresse
    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)
    # Installation von Git
    Da bei Mac und Linux Betriebssystemen git schon vorinstalliert ist, muss lediglich auf Windows Rechnern git installiert werden.
    Da bei MacOS und Linux Betriebssystemen git schon vorinstalliert ist, muss lediglich auf Windows Rechnern git installiert werden.
    Dafür downloadet man die Installationsdatei von `https://gitforwindows.org/` und führt diese aus. Während der Installation sollten alle Voreinstellungen von git beibehalten werden.
    ......@@ -80,84 +91,120 @@ Terminaleingabe:
    > * git config --global user.email "max.mustermann@th-koeln.de"
    > * git config --global user.name "mmustermann"
    # 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`
    # Benutzen von Terminalbefehlen
    ## Klonen der Repository (Projekt)
    # Klonen des Projekts (Repository)
    Um ein Projekt zu klonen, erstellt man ein Neuen Ordner für das Projekt, startet das Git-Terminal (der im Terminal angezeigte Pfad, sollte der vom neu erstellten Ordner sein) und gibt folgenden Befehl ein `git clone Repository-Adresse`
    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.
    > **Anmerkung:** 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.
    ## Mittels GUI
    In unserem Fall lautet die Repository-Adresse `https://git-ce.rwth-aachen.de/assistance-systems/helloworld.git`
    #### a) Starte _git-cola_ und klicke auf _Klonen..._
    > In unserem Fall lautet der Befehl zum klonen von diesem Repository: `git clone https://git-ce.rwth-aachen.de/assistance-systems/helloworld.git`
    ![image1](uploads/4eca54345da114ca469dc773e35bf9e8/image1.png)
    Nach erfolgreicher Eingebe von Benutzernamen und Passwort wird das Repository geklont.
    #### b) Job-Spezifikation
    Anschließend erfolgt die Eingabe der Repository-Adresse und auswahl des Speicherpfades.
    ![image2](uploads/1724b7d4b55722bc80bde41e1181aa20/image2.png)
    ## Erstellen von einem Branch
    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`
    > **Anmerkung:** 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 mit <Pfad> der Zielpfad ist zu dem man wechseln möchte: `cd <Pfad>`
    ![Image3](uploads/f302b0ff83268e1e406ffef12f96d3ba/Image3.png)
    Um den neuen lokalen Branch (hier: Test) zu erstellen und in diesen Branch zu wechseln, gibt man folgenden Befehl ein:
    #### c) Es wird nach einer Authentifizierung gefragt. Hierzu den zuvor ermittelten Benutzernamen und das festgelegte Passwort eingeben.
    > ID: mmustermann
    > PW: 123456
    `git checkout -b Test`
    #### d) Nun wurde das Projekt geklont und es muss ein neuer Branch erstellt werden.
    > Mit dem checkout-Befehl ist es möglich jederzeit zwischen den verschiedenen Branches zu wechseln.
    Nun wird mit dem Befehl _git push_ der Branch _Test_ zum GitLab-Projekt (auf dem Server) hinzugefügt:
    ## Alternativ mittels Terminalbefehle
    `git push origin Test`
    Um ein Projekt zu klonen, erstellt man ein Neuen Ordner für das Projekt, startet das Git-Terminal und gibt folgenden Befehl ein `git clone Repository-Adresse`
    > **Erinnerung:** 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.
    ## Pushen von Daten
    > **Anmerkung:** Die folgenden Befehle können nur ausgeführt werden, wenn der angezeigte Pfad im Terminal das Hauptverzeichnis des lokalen Repositories ist.
    In unserem Fall lautet die Repository-Adresse `https://git-ce.rwth-aachen.de/assistance-systems/helloworld.git`
    #### a) Wenn Änderungen im lokalen Repository vorgenommen wurden, dann sollten diese zum Index mit folgendem Terminalbefehl hinzugefügt werden:
    Somit lautet der Befehl um dieses Repository zu klonen `git clone https://git-ce.rwth-aachen.de/assistance-systems/helloworld.git`
    `git add .`
    Nach erfolgreicher Eingebe von Benutzernamen und Passwort wird das Repository geklont.
    #### b) Nun kann ein Commit einschließlich einer Kurzbeschreibung der Änderung mit folgendem Terminalbefehl durchgeführt werden:
    `git commit -m "Hier steht ein Kommentar"`
    > Dadurch wird nicht das Repository auf GitLab aktualisiert, sondern nur das lokale Repository.
    # Erstellen von einem Branch
    #### c) Nun können die Änderungen mit folgendem Befehl zum Remote-Repository hinzugefügt werden:
    ## Mittels GUI
    `git push REMOTE BRANCHNAME`
    Zum erstellen von einem neuen Branch klickt man auf _Branch_ **(1)** und anschließend auf _Neu_ **(2)**
    > REMOTE ist der Name des remote Servers. Wenn ein Projekt geklont wird, dann ist der von git vergebene Standardname origin.
    ![image3](uploads/8c1b76aae15637cc619400bd837dcc57/image3.png)
    In unserem Beispiel lautet der Befehl somit:
    Anschließend gibt man dem neuen Branch einen Namen, z.b. Gruppe01 **(1)** und klickt auf _Branch erstellen_ **(2)**.
    `git push origin Test`
    ![image4](uploads/539e164e10fff6378213817da483bef0/image4.png)
    ## Alternativ mittels Terminalbefehle
    ## Pullen von Daten
    > **Anmerkung:** Die folgenden Befehle können nur ausgeführt werden, wenn der angezeigte Pfad im Terminal das Hauptverzeichnis des lokalen Repositories ist.
    Folgender Befehl wird im Terminal eingegeben, um den neuen lokalen Branch (hier: Test) zu erstellen und in diesen Branch zu wechseln:
    Um Änderungen an einem remote Repository zu downloaden und mit dem lokalen Repository zu synchronisieren wird folgender Befehl ausgeführt:
    `git checkout -b Test`
    `git pull PFAD BRANCHNAME`
    > Mit dem checkout-Befehl ist es möglich jederzeit zwischen den verschiedenen Branches zu wechseln.
    > PFAD ist die Repository-Adresse, in unserem Beispiel lautet diese `https://git-ce.rwth-aachen.de/assistance-systems/helloworld.git`
    Für unser Beispiel lautet der Befehl:
    `git pull https://git-ce.rwth-aachen.de/assistance-systems/helloworld.git Test`
    Nun wird mit folgendem Befehl der Branch _Test_ zum GitLab-Projekt hinzugefügt:
    `git push origin Test`
    # Pushen des Projekts
    # 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 des Projekts (Repository)
    ## Mittels GUI
    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.
    #### a) Starte _git-cola_ und klicke auf _Klonen..._
    ![image1](uploads/4eca54345da114ca469dc773e35bf9e8/image1.png)
    #### b) Job-Spezifikation
    Anschließend erfolgt die Eingabe der Repository-Adresse und auswahl des Speicherpfades.
    ![image2](uploads/1724b7d4b55722bc80bde41e1181aa20/image2.png)
    #### c) Es wird nach einer Authentifizierung gefragt. Hierzu den zuvor ermittelten Benutzernamen und das festgelegte Passwort eingeben.
    > ID: mmustermann
    > PW: 123456
    #### d) Nun wurde das Projekt geklont und es muss ein neuer Branch erstellt werden.
    # Erstellen von einem Branch
    Zum erstellen von einem neuen Branch klickt man auf _Branch_ **(1)** und anschließend auf _Neu_ **(2)**
    ![image3](uploads/8c1b76aae15637cc619400bd837dcc57/image3.png)
    Anschließend gibt man dem neuen Branch einen Namen, z.b. Gruppe01 **(1)** und klickt auf _Branch erstellen_ **(2)**.
    ![image4](uploads/539e164e10fff6378213817da483bef0/image4.png)
    # Pushen des Projekts
    Die lokal vorhandenen Branches werden unter _Branches_ **(1)** angezeigt, wo der aktuell ausgewählte Branch mit einem Stern gekennzeichnet ist.
    ......@@ -184,36 +231,11 @@ Sollte schon ein externer Branch erstellt worden sein, so wählt man diesen zuvo
    ![image10](uploads/048fd8292b00ac4f67745680e56bae35/image10.png)
    ## Alternativ mittels Terminalbefehle
    > **Anmerkung:** Die folgenden Befehle können nur ausgeführt werden, wenn der angezeigte Pfad im Terminal das Hauptverzeichnis des lokalen Repositories ist.
    #### a) Wenn Änderungen im lokalen Repository vorgenommen wurden, dann sollten diese zum Index mit folgendem Terminalbefehl hinzugefügt werden:
    `git add .`
    #### b) Nun kann ein Commit einschließlich einer Kurzbeschreibung der Änderung mit folgendem Terminalbefehl durchgeführt werden:
    `git commit -m "Hier steht ein Kommentar"`
    > Dadurch wird nicht das Repository auf GitLab aktualisiert, sondern nur das lokale Repository.
    #### c) Nun können die Änderungen mit folgendem Terminalbefehl zum Remote-Repository hinzugefügt werden:
    `git push REMOTE BRANCHNAME`
    > REMOTE ist der Name des remote Servers. Wenn ein Projekt geklont wird, dann ist der von git vergebene Standardname origin.
    In unserem Beispiel lautet der Befehl somit:
    `git push origin Test`
    # Pullen eines Projektes
    ## Mittels GUI
    Sollte das git-Repo (Projekt) unterschiede zur lokalen Kopie aufweisen, muss vor dem arbeiten am Projekt ein sog. "pull" stattfinden.
    Dafür wählt man den Reiter _Befehle_ **(1)** aus und klickt auf _Holen und zusammenführen_ **(2)**.
    ......@@ -225,18 +247,7 @@ Anschließend wählt man den Branch aus von dem man den sog. Pull machen möchte
    ![image12](uploads/cd89fa34ca36781ed636a4efa02a388d/image12.png)
    ## Alternativ mittels Terminalbefehle
    > **Anmerkung:** Die folgenden Befehle können nur ausgeführt werden, wenn der angezeigte Pfad im Terminal das Hauptverzeichnis des lokalen Repositories ist.
    Um Änderungen aus einem remote Repository zu downloaden und mit dem lokalen Repository zu synchronisieren wird folgender Terminalbefehl ausgeführt:
    `git pull PFAD BRANCHNAME`
    > PFAD ist die Repository-Adresse, für dieses Beispiel lautet diese `https://git-ce.rwth-aachen.de/assistance-systems/helloworld.git`
    Für unser Beispiel lautet der Befehl:
    `git pull https://git-ce.rwth-aachen.de/assistance-systems/helloworld.git Test`
    # Weiterführende Themen:
    ......