Funktion
GitLab mit dem Zuuna-Board verbinden (auch selbst gehostet)
GitLab.com oder die eigene Instanz im Firmennetz: Adresse, Projektpfad und ein Token, das nicht gespeichert wird. So läuft die Verbindung.
Die GitLab-Integration verbindet ein Projekt mit einer Gruppe in Zuuna — bei GitLab.com genauso wie bei einer selbst gehosteten Instanz. Du gibst die Adresse deiner Instanz an, den Projektpfad und ein persönliches Zugriffstoken; damit richtet Zuuna den Webhook ein.
Einrichten
Auf der Code-Seite der Gruppe brauchst du drei Angaben: die Adresse deiner Instanz (also gitlab.com oder deine eigene), den Projektpfad in der Form namespace/projekt — Untergruppen sind erlaubt — und ein persönliches Zugriffstoken. Zuuna legt damit den Webhook an und verwirft das Token danach. Gespeichert wird es nicht.
Wenn die Instanz nicht von außen erreichbar ist
Das ist der übliche Fall im Firmennetz, und er ist vorgesehen. Kann Zuuna den Webhook nicht selbst anlegen, bekommst du die URL und das Secret angezeigt und trägst den Hook in GitLab von Hand ein. Die Verbindung entsteht dann von deiner Seite aus — Zuuna muss deine Instanz nie erreichen.
Danach
Commits, Branches, Merge Requests und Pipeline-Status erscheinen auf der Karte, deren ID im Commit oder Branch steht. Verwechsle die Anbindung nicht mit der Anmeldung über GitLab: Das ist eine getrennte Funktion, die nichts mit dem Board zu tun hat.
Tarif
Git auf dem Board gehört zum Developer-Tarif, zusammen mit Releases, dem Code-Graph, der REST-API und Webhooks.
Häufige Fragen
Wird mein Zugriffstoken gespeichert?
Nein. Es wird einmal benutzt, um den Webhook einzurichten, und danach verworfen. Gespeichert werden nur die Zuordnung von Projekt zu Gruppe und das Webhook-Secret, und das verschlüsselt.
Welche Rechte braucht das Token?
Es muss ausreichen, um im Projekt einen Webhook anzulegen. Reicht es nicht, schlägt nur die automatische Einrichtung fehl — du bekommst dann URL und Secret zum manuellen Eintragen und kannst trotzdem verbinden.
Funktionieren Untergruppen?
Ja. Der Projektpfad darf mehrere Ebenen haben, also auch die Form gruppe/untergruppe/projekt.