microcontrollertechnik:gitlab_installation [MEXLE Wiki]

Diese Seite ist nicht editierbar. Sie können den Quelltext sehen, jedoch nicht verändern. Kontaktieren Sie den Administrator, wenn Sie glauben, dass hier ein Fehler vorliegt.
====== Installation for Gitlab / MEXLE Gitlab ======

==== Installation der Software auf Ihrem Rechner ====

  - Laden Sie Git von folgender Seiter herunter: https://git-scm.com/download/win >> "Standalone Installer"\\ Git bietet die Möglichkeit mit dem GitLab Server der Hochschule oder mit GitHub in Kontakt zu treten
  - Installieren Sie das Git (alle mit "Ok" bzw "Weiter" bestätigen)
  - Laden Sie TortoiseGit von folgender Seite herunter: https://tortoisegit.org/download/ \\ totroiseGit bindet den Explorer direkt an die Services des Git an. Damit ist Git direkt in den Explorer eingebunden.
  - Installieren Sie das TortoiseGit (alle Hinweise mit "Ok" bestätigen)

==== Anmeldung beim MEXLE GitLab ====

  - Melden Sie sich bei GitLab mit den Hochschul-Credentials an: https://git.mexle.org/
  - Gehen Sie zu ''User settings'' >> ''Preferences'' >> ''Password'': \\ z.B. über folgenden Link: https://git.mexle.org/-/user_settings/password/edit \\ {{drawio>microcontrollertechnik:UserSettings.svg}}
  - Geben Sie ein Passwort mit mindestens 16 Zeichen ein und merken Sie sich dieses Passwort. Dieses Passwort ermöglicht die Authentifizierung auf GitLab. \\ Bitte nutzen Sie ein neues Passwort!  

==== Installation der Software auf Ihrem Rechner ====

<WRAP alert>
Die Abfolge ist wie folgt:
  - Erst müssen Sie sich in **GitLab anmelden**
  - Dann müssen Sie einem **Betreuer per Mail bescheid geben** (Prof. Fischer, Ralf Ziegler) , damit dieser Sie zum Projekt zuordnet
  - **Erst dann sind einem Projekt zugewiesen** und können die folgenden Punkte durchführen.
</WRAP>

  - Gehen Sie in den (Windows) Explorer und legen Sie einen neuen Ordner für die Vorlesung an, z.B. ''Mikrocontroller'' oder ''Elektronik Labor'' 
  - Klicken Sie mit der rechten Maustaste auf den Ordner, um in das Kontextmenü zu kommen. \\ Wählen Sie dort ''Git Clone...'' aus. \\ {{drawio>microcontrollertechnik:KontextmenuGitlab.svg}}
  - Im erscheinenden GitClone Fenster sollten Sie Folgendes eingeben: 
    - als URL: ''%%https://git.mexle.org/[Fach]/[Semester].git%%'' \\ also z.B. ''%%https://git.mexle.org/mikrocontroller/25ss.git%%'' oder ''%%https://git.mexle.org/elektronik/25ss.git%%'' für das Wintersemester 2024 
    - als Directory sollte der ausgewählte Ordner eingetragen sein
    - Klicken Sie nun auf ''Ok'' \\ {{drawio>microcontrollertechnik:GitClone.svg}}
  - Im Anschluss sollten Sie eine Fehlermeldung erhalten, da noch das Passwort fehlt. \\ Hier ist nun das vorher gewählte Passwort einzugeben. \\ Dies müssen Sie auch nur einmalig machen.
  - Der Download sollte nun klappen und es sollten alle Ordner heruntergeladen werden 

==== Upload / Commit von Dateien ====

Das Hochladen und Ändern von Dateien bei Git wird als "Commit" bezeichnet. Diese Nomenklatur wird auch im Folgenden genutzt. \\
Im Folgenden wird ein Upload beschrieben; über einen Commit können aber auch Dateien gelöscht werden.

  - Rechtsklick auf den übergeordneten Ordner >> ''Git Commit -> "main" ...''\\ {{drawio>microcontrollertechnik:GitCommit.svg}}
  - Falls eine Fehlermeldung erscheint, siehe nächstes Kapitel
  - Im folgenden Fenster ist nun einiges einzutragen:
    - Tragen Sie unbedingt einen Text unter ''Message'' ein, ansonsten ist kein Upload möglich! \\ Schreiben sie einen Text, welcher die Änderungen beschreibt.
    - Im unteren Teil sind die zu ändernden Dateien zu markieren. \\ Entweder Sie wählen die Dateien einzeln aus, oder Sie wählen z.B. ''All'' .
    - Zum Commit an den Server wählen Sie am Button unten ''▼'' aus und dort ''Commit & Push'' \\ {{drawio>microcontrollertechnik:GitCommit2.svg}}
    - Bestätigen Sie nun den Commit über Druck auf den Button ''Commit & Push''
  - Überprüfen Sie, ob der Commit erfolgreich war durch einen Blick auf die Homepage des Projekts.

===== Hinweise und Mögliche Fehler =====
  - Für Abhschlussarbeiten und studentischen Projekte:
    - Da diese häufig mehr als 100 MB hochladen, sollten Sie **__nicht__** ''%%https://git.mexle.org/...%%'' nutzen, sondern: \\ ''**http**%%://%%**git.mexle.te-hs-heilbronn.de**%%/...%%''. 
    - In diesem Fall müssen Sie im Hochschulnetz befinden (z.B. per eduVPN).
    - Fragen Sie bei mir (Tim Fischer) nach, welches Git Repository für Sie das passende ist.
  - ''fatal: detected dubious ownership in repository at [...] is on a filesystem that does not record ownership'' \\ Das Problem ist, das der Ordner auf einem Laufwerk liegt, welches keine Benutzerzuordnung erlaubt (z.B. ein USB-Stick) . \\ Die Lösung wird gleich mitgeliefert: 
    - Rechtsklick im Explorer auf den entsprechenden Ordner (z.B. 24WS) >> ''Open Git Bash here'' >> Es öffnet sich eine Text-Konsole
    - Fügen Sie Folgendes ein ''git config --global --add safe.directory D:/GitLab/elektronik/25SS'' (ändern Sie ggf. ''elektronik'' in ''mikrocontroller'' und das Semester) und bestätigen Sie mit Return