GitLab-Integration: Issues importieren und Repositories anbinden

Spedy unterstützt ab sofort den vollständigen Import von GitLab-Projekten und die Anbindung von GitLab-Repositories an Boards. Damit können Teams, die auf GitLab arbeiten, ihre Issues nach Spedy migrieren und gleichzeitig Code-Aktivitäten direkt an Tickets nachverfolgen.

GitLab-Projekte importieren

Unter Einstellungen → Integrationen → GitLab findest du die neue GitLab-Integration. Nach dem Verbinden kannst du ganze GitLab-Projekte als neue Boards importieren — mit allen Issues, Kommentaren und Zuweisungen.

So funktioniert der Import

Der Import läuft in vier Schritten:

1. GitLab verbinden — Gib die URL deiner GitLab-Instanz und ein Personal Access Token mit api-Scope ein. Spedy validiert die Zugangsdaten und zeigt den verbundenen Nutzer an. Funktioniert mit gitlab.com und selbst gehosteten Instanzen.

2. Projekt wählen — Du siehst eine durchsuchbare Liste aller GitLab-Projekte, auf die du Zugriff hast. Für jedes Projekt werden Name, Pfad, Beschreibung und die Anzahl offener Issues angezeigt. Du kannst den Namen des Ziel-Boards anpassen.

3. Status zuordnen — GitLab kennt zwei Grundzustände: „offen" und „geschlossen". Ordne sie den Spedy-Status deines Boards zu. Optional kannst du auch Labels als zusätzliche Status-Hinweise nutzen — z. B. „opened:doing" einem bestimmten Status zuweisen.

4. Nutzer zuordnen — Spedy zeigt alle GitLab-Projektmitglieder und schlägt automatisch passende Spedy-Nutzer vor (Abgleich über E-Mail). Du kannst jede Zuordnung manuell anpassen. Issues von nicht zugeordneten Nutzern werden ohne Bearbeiter importiert.

Nach dem Start läuft der Import im Hintergrund. Du siehst den Fortschritt in Echtzeit — importierte, ausstehende und fehlgeschlagene Issues auf einen Blick. Bei einer Unterbrechung setzt die Migration dort fort, wo sie aufgehört hat.

Was importiert wird

• Issues — Titel, Beschreibung, Status, Fälligkeitsdaten
• Kommentare — alle Issue-Notizen mit Autor und Zeitstempel
• Zuweisungen — gemäß der konfigurierten Nutzer-Zuordnung
• Externe Referenz — jedes Ticket verlinkt zurück auf das Original-Issue (z. B. GL-42)
• Priorität und Story Points — werden aus vorhandenen Labels abgeleitet

Migrationshistorie

Auf der GitLab-Seite in den Integrationseinstellungen siehst du alle bisherigen Migrationen mit Quelle, Zeitpunkt, Status und Anzahl importierter Issues. Du kannst jede Migration einzeln öffnen und das detaillierte Protokoll einsehen.

GitLab-Repositories an Boards anbinden

Neben dem Issue-Import kannst du jetzt auch GitLab-Repositories mit deinen Boards verbinden. Commits und Merge Requests erscheinen dann automatisch am verknüpften Ticket — in Echtzeit per Webhook.

Repository verbinden

1. Öffne die Board-Einstellungen → Integrationen
2. Klicke auf Repository hinzufügen und wähle deine aktive GitLab-Integration
3. Wähle das GitLab-Projekt aus — Spedy richtet den Webhook automatisch ein

Du benötigst mindestens die Rolle Maintainer im GitLab-Projekt, damit der Webhook erstellt werden kann.

Wie die Verknüpfung funktioniert

Wenn ein Commit oder Merge Request eine Ticket-ID enthält — etwa fix: Login-Timeout ACME-42 oder Closes ACME-42 —, erkennt Spedy die Referenz automatisch. Der Commit oder MR erscheint in der Code-Aktivität des Tickets mit Autor, Nachricht, Branch und Zeitstempel.

Gut zu wissen

• Dasselbe Repository kann an mehrere Boards gleichzeitig angebunden werden
• Beim Entfernen wird der Webhook in GitLab automatisch gelöscht
• Push-, Merge-Request- und Pipeline-Events werden verarbeitet
• Die Anbindung funktioniert mit gitlab.com und selbst gehosteten Instanzen

Zusammen gedacht

Import und Repository-Anbindung ergänzen sich: Du migrierst deine Issues nach Spedy und bindest anschließend das gleiche GitLab-Repository an das neue Board an. So hast du die komplette Projekthistorie in Spedy und siehst ab sofort jeden Commit und jede Merge Request direkt am Ticket — ohne zwischen Tools zu wechseln.

Mehr Details findest du in der Integrations-Dokumentation.