Git Versionskontrolle

Git Versionskontrolle#

Um Commits und Dateien in Ihrem Git-Repository mit Allegra zu verknüpfen, müssen Sie beim Commit in Ihrem Commit-Kommentar eine Referenz auf betroffene Vorgänge in der Form „#<Vorgangsnr.>, also z.B. „ #4711 “ eingeben. Um ein Versionskontrollsystem zu integrieren, muss ein entsprechendes Plug-In im Verzeichnis $ALLEGRA_HOME/plugins installiert sein. Für das jeweilige Projekt bzw. den Bereich muss die Funktion “Versionskontrolle” aktiviert sein (Verwaltung > Bereiche > <Bereich> > Versionskontrolle). In dieser Ansicht können Sie alle notwendigen Einstellungen zur Anbindung an ein Git-Repository vornehmen.

Verbindungstyp#

Das Git-Repository kann über drei Protokolle erreicht werden:

  • ssh : das Git Repository wird über das secure shell (ssh)-Protokoll erreicht

  • file : möglich, wenn der Allegra-Server direkten Zugriff auf die Dateien des Git-Repositories hat

  • gitlab : das Repository wird durch GitLab verwaltet

Repository-Pfad#

Der absolute Pfad zum Repository, wird nur bei file-Protokoll benötigt.

Server-Name und Server-Port#

Die URL und der Git-Port zum Repository-Server

GitLab Projekt-ID#

In GitLab hat jedes Projekt eine Identifikationsnummer. Sie können diese Nummer benutzen um ein Allegra Projekt einem GitLab-Projekt zuzuordnen.

Vorgangsnummer-Muster#

Allegra verknüpft solche Commits die in ihrer Commit-Message Allegra-Vorgangsnummern referenzieren. Vorgangsnummern werden dabei anhand des hier festgelegten regulären Ausdrucks erkannt.

Authentifizierungs-Methoden#

Das System unterstützt die folgenden Authentifizierungs-Methoden:

  • Anonymous : Nur für direkten Zugang über das file-Protokoll

  • Kennwort: Sie benutzen Benutzername und Kennwort

  • Public/private key: Sie benutzen ein Schlüsselpaar

  • Token: Sie verwenden einen von GitLab erzeugten Access Token.

Integrierter Repository-Browser#

Das System verfügt über einen integrierten Repository-Browser. Sie können darauf über die Cockpit-Kachel „Versionsverwaltung“ und beim Bearbeiten eines Vorgangs zugreifen.

Aktualisierung von Allegra durch Git#

Allegra kann seine Versionskontroll-Daten auf zwei Arten mit einem Git-Repository synchronisieren:

  1. Über einen zeitgesteuerten automatischer Prozess alle x Minuten, wobei x in der Datei $ALLEGRA_HOME/quartz-jobs.xml angepasst werden kann.

  2. Über einen Rest-Endpunkt. Wenn das System dort eine POST-Anforderung erhält, aktualisiert es alle Versionskontrolldaten. Die URL ist: {Allegra Server URL}/rest/vcPlugin/fetchLogs. Sie können diese Endpoint-URL in Hook-Skripten Ihres Git- oder GitLab-Servers verwenden.

Inhalt