## Gitlab

GitLab ist eine umfangreiche Webanwendung zur Versionsverwaltung für Softwareprojekte auf Basis von Git die auch Wiki-Funktionen und Issue Tracking bietet. Das Transferportal der HFT-Stuttgart betreibt eine eigene GitLab-Instanz für die Hochschule für Technik Stuttgart und ihre Kooperationspartner unter einer Open-Access-Lizenz.

Zugriff auf Gitlab

## Hilfestellung zu Gitlab

### Möchten Sie die Projektinhalte ansehen oder herunterladen?

Dann klicken Sie auf diesen Link zu den Gitlab-Projekten um die Liste aller im Gitlab erfassten Projekte zu sehen. Vor dort können Sie dann auf die einzelnen Projekte zugreifen. Ein Anmelden am Portal ist dazu nicht nötig.

### Möchten Sie zu einem Projekt beitragen?

Sie können mittels Issues dem Projekteigentümer eine Rückmeldung geben bzw. einen Fehler melden. Darüberhinaus können Sie sich auch aktiv beteiligen. Dazu müssen Sie im Portal als Nutzer registriert sein.

Wenn Sie noch kein Benutzerkonto haben, klicken Sie bitte oben auf den Link Benutzerkonto und folgen Sie dem System durch die Registrierungsprozedur.

Haben Sie ein Benutzerkonto, befolgen Sie bitte folgende Schritte:

1. Folgen Sie dem Link zu den Gitlab-Projekten, um zum Gitlab zu gelangen.
2. Melden Sie sich bei Gitlab an, indem Sie im Gitlab auf den Link Sign-In klicken.
3. Sie werden dann auf eine Anmeldeseite von unserem Portal geführt. Geben Sie dort bitte ihre Benutzerdaten vom Portal ein.
4. Nach erfolgreichem Anmelden werden Sie zum Gitlab zurückgeführt.
5. Navigieren Sie dann zum Projekt Ihrer Wahl.
6. Abhängig davon wie der Projekteigentümer das Projekt konfiguriert hat, können Sie entweder direkt loslegen, oder Sie müssen zunächst noch beim Projekteigentümer Zugang zum Projekt anfragen, indem Sie im Gitlab bei der entsprechende Projektseite auf den Link Request Access klicken.

### Möchten Sie selbst ein Projekt anlegen, um es der Öffentlichkeit bereitzustellen?

Vorraussetzung dazu ist, dass Sie aktives oder ehemaliges Mitglied der Hochschule für Technik sind, d.h. eine (noch) gültige HFT-Emailadresse haben, und zudem im Portal als Nutzer registriert sein.

Wenn Sie noch kein Benutzerkonto haben, klicken Sie bitte oben auf den Link Benutzerkonto und folgen Sie dem System durch die Registrierungsprozedur.

Haben Sie ein Benutzerkonto, befolgen Sie bitte folgende Schritte:

1. Folgen Sie dem Link zu den Gitlab-Projekten, um zum Gitlab zu gelangen.
2. Melden Sie sich bei Gitlab an, indem Sie im Gitlab auf den Link Sign-In klicken.
3. Sie werden dann auf eine Anmeldeseite von unserem Portal geführt. Geben Sie dort bitte ihre Benutzerdaten vom Portal ein.
4. Nach erfolgreichem Anmelden werden Sie zum Gitlab zurückgeführt.
5. Erstellen Sie dann in Gitlab ein neues Projekt durch Klicken auf den grünen New Project-Knopf und anschließendem Befolgen der Eingabemaske von Gitlab.
6. Um eine optimale Sichtbarkeit des Projekts zu ermöglichen, MUSS jedes Projekt eine kurze Projektbeschreibung und ein Bild/Logo haben.

- Um dem Projekt eine Projektbeschreibung hinzuzufügen, füllen Sie bitte beim Anlegen des Projekts das Feld Project description aus.
- Um ein Bild/Logo hinzuzufügen, gehen Sie bitte in Ihrem Projekt auf "Settings --> General" und laden Sie das Bild/Logo unter Project avatar hoch.

Weitere Hilfestellung zum Anlegen von Projekten in Gitlab finden Sie in der Gitlab-Dokumentation.

Hinweis: Um Inhalte zum Gitlab "pushen" zu können, verwendet die Gitlab-Instanz unseres Portals die s.g. "SSH Keys". Weitere Informationen dazu finden Sie in der Gitlab-Dokumentation zu SSH Keys.