Installation for Gitlab / MEXLE Gitlab

Installation der Software auf Ihrem Rechner

  1. 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
  2. Installieren Sie das Git (alle mit „Ok“ bzw „Weiter“ bestätigen)
  3. 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.
  4. Installieren Sie das TortoiseGit (alle Hinweise mit „Ok“ bestätigen)

Anmeldung beim MEXLE GitLab

  1. Melden Sie sich bei GitLab mit den Hochschul-Credentials an: https://git.mexle.org/
  2. Gehen Sie zu User settings » Preferences » Password:
    z.B. über folgenden Link: https://git.mexle.org/-/user_settings/password/edit
    microcontrollertechnik:usersettings.svg
  3. 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

Die Abfolge ist wie folgt:

  1. Erst müssen Sie sich in GitLab anmelden
  2. Dann müssen Sie einem Betreuer per Mail bescheid geben (Prof. Fischer, Ralf Ziegler) , damit dieser Sie zum Projekt zuordnet
  3. Erst dann sind einem Projekt zugewiesen und können die folgenden Punkte durchführen.
  1. Gehen Sie in den (Windows) Explorer und legen Sie einen neuen Ordner für die Vorlesung an, z.B. Mikrocontroller oder Elektronik Labor
  2. Klicken Sie mit der rechten Maustaste auf den Ordner, um in das Kontextmenü zu kommen.
    Wählen Sie dort Git Clone… aus.
    microcontrollertechnik:kontextmenugitlab.svg
  3. Im erscheinenden GitClone Fenster sollten Sie Folgendes eingeben:
    1. 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
    2. als Directory sollte der ausgewählte Ordner eingetragen sein
    3. Klicken Sie nun auf Ok
      microcontrollertechnik:gitclone.svg
  4. 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.
  5. 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.

  1. Rechtsklick auf den übergeordneten Ordner » Git Commit -> „main“ …
    microcontrollertechnik:gitcommit.svg
  2. Falls eine Fehlermeldung erscheint, siehe nächstes Kapitel
  3. Im folgenden Fenster ist nun einiges einzutragen:
    1. Tragen Sie unbedingt einen Text unter Message ein, ansonsten ist kein Upload möglich!
      Schreiben sie einen Text, welcher die Änderungen beschreibt.
    2. 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 .
    3. Zum Commit an den Server wählen Sie am Button unten ▼ aus und dort Commit & Push
      microcontrollertechnik:gitcommit2.svg
    4. Bestätigen Sie nun den Commit über Druck auf den Button Commit & Push
  4. Überprüfen Sie, ob der Commit erfolgreich war durch einen Blick auf die Homepage des Projekts.

Hinweise und Mögliche Fehler

  1. Für Abhschlussarbeiten und studentischen Projekte:
    1. 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/....
    2. In diesem Fall müssen Sie im Hochschulnetz befinden (z.B. per eduVPN).
    3. Fragen Sie bei mir (Tim Fischer) nach, welches Git Repository für Sie das passende ist.
  2. 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:
    1. Rechtsklick im Explorer auf den entsprechenden Ordner (z.B. 24WS) » Open Git Bash here » Es öffnet sich eine Text-Konsole
    2. 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