Windshift

GitLab mit Windshift verbinden

Verknüpfen Sie GitLab-Projekte mit Windshift, starten Sie Branches und Merge Requests aus einem Arbeitselement und behalten Sie den Review-Status am Element. Funktioniert mit GitLab.com und selbst verwaltetem GitLab.

Ein Windshift-Arbeitselement mit verknüpftem Pull Request, Branch und Commit im Bereich Entwicklung.

Legen Sie aus dem Arbeitselement einen Branch und einen Pull Request an, verknüpfen Sie einen Commit und sehen Sie, wie der Review-Status der Änderung folgt.

Windshift herunterladen

Was die Integration leistet

Die Verbindung liegt in Ihrer Windshift-Instanz und ruft die Provider-API direkt auf.

  • Repositories verknüpfen: Windshift findet die Repositories, die die Verbindung erreicht. Sie verknüpfen die, die ein Workspace verfolgt.
  • Änderungen mit Arbeitselementen verbinden: Verknüpfen Sie Pull Requests oder Merge Requests mit dem Arbeitselement und lesen Sie Element-Schlüssel aus Branch-Namen und Commit-Nachrichten.
  • Aus einem Arbeitselement starten: Einen Branch anlegen und eine Änderungsanfrage öffnen, ohne das Element zu verlassen.
  • Review-Threads verfolgen: Review-Kommentare lesen, damit eine Kollegin oder ein Agent aus der Diskussion weiterarbeiten kann.
  • Releases verfolgen: Ein Tag an einen Meilenstein hängen und sehen, welche Änderungen damit veröffentlicht wurden.
  • Aktuell bleiben: Webhooks aktualisieren verknüpfte Repositories nach jedem Push oder Review-Ereignis, Polling dient als Ausgleich.
  • Die Issue-Synchronisierung gibt es nur in der GitHub-Integration. Diese Integration verknüpft Branches, Commits und Änderungsanfragen, nicht deren Issue-Tracker.

Möglichkeiten der Verbindung

Windshift verbindet sich über eine OAuth-Anwendung oder ein Zugriffstoken mit GitLab.com oder einer selbst verwalteten GitLab-Instanz (CE oder EE). Repository-Suche, Branches, Commits, Merge Requests, Review-Threads, Releases und Webhooks laufen über die GitLab-REST-API v4.

Windshift legt Branches an und erstellt Änderungsanfragen. Die Verbindung braucht Schreibzugriff, nicht nur Lesezugriff.

  • OAuth-App: Jede Person autorisiert ihr eigenes GitLab-Konto. Windshift erneuert das Token automatisch, so bleibt die Verbindung bestehen, bis der Zugriff entzogen wird.
  • Zugriffstoken: GitLab akzeptiert persönliche, Projekt- und Gruppen-Zugriffstoken. Für Bots und Server-zu-Server-Integrationen eignet sich ein Projekt- oder Gruppen-Token besser.

Integration einrichten

Ein Windshift-Administrator richtet den Provider einmal ein. Workspace-Administratoren verknüpfen danach die Repositories.

Bewahren Sie die Zugangsdaten bei dem Team auf, dem der Git-Host gehört. Wechseln Sie Token oder Secret im selben Rhythmus wie bei Ihren übrigen Dienstkonten.

  • Zugangsdaten in GitLab anlegen: Registrieren Sie eine OAuth-Anwendung mit dem Scope api oder erstellen Sie ein persönliches, Projekt- oder Gruppen-Zugriffstoken. Setzen Sie die Redirect-URI auf die Callback-URL, die Windshift anzeigt.
  • Provider in Windshift hinzufügen: Öffnen Sie Einstellungen, SCM-Provider, fügen Sie einen Provider hinzu, wählen Sie GitLab und die Authentifizierungsmethode und fügen Sie die Zugangsdaten ein. Lassen Sie die Basis-URL für GitLab.com leer oder tragen Sie die URL Ihrer Instanz ein.
  • Workspace verbinden und Projekte verknüpfen: Die Repository-Suche listet die Projekte, die das verbundene Konto erreicht. Verknüpfen Sie die Projekte, die der Workspace verfolgt.
  • Projekt-Webhook anlegen: Erzeugen Sie das Webhook-Secret in Windshift und tragen Sie Callback-URL und Secret im Projekt in GitLab ein. Aktivieren Sie Push-, Tag-Push-, Merge-Request-, Note- und Release-Ereignisse.

Berechtigungen und Scopes

Die genauen Berechtigungsnamen richten sich nach dem Provider. Prüfen Sie sie vor der Freigabe gegen Ihre Instanzrichtlinie.

  • Projekte verknüpfen und ansehen: Das verbundene Konto ist Mitglied des Projekts.
  • Branches, Merge Requests und Kommentare erstellen: Rolle Developer (Zugriffsebene 30) oder höher.
  • Projekt-Webhook anlegen: Rolle Maintainer oder höher.
  • OAuth-Scope: api

Hinweise zum Selbst-Hosting

Setzen Sie die Basis-URL auf die Wurzel Ihrer Instanz, zum Beispiel https://gitlab.example.com. Beide Server müssen sich für OAuth-Callbacks, Webhooks und API-Aufrufe erreichen. Nutzt die Instanz ein selbst ausgestelltes Zertifikat, muss der Windshift-Host der Zertifizierungsstelle vertrauen.

Häufige Fragen

Unterstützt Windshift selbst verwaltetes GitLab?

Ja. Windshift arbeitet mit GitLab.com und selbst verwaltetem GitLab CE und EE. Setzen Sie die Basis-URL auf Ihre Instanz.

Kann ich mehr als eine GitLab-Instanz verbinden?

Ja. Fügen Sie einen Provider pro Instanz mit eigener Basis-URL hinzu und verknüpfen Sie dann die Projekte, die jeder Workspace verfolgt.

Kann ich einen Provider auf bestimmte Workspaces beschränken?

Ja. Ein Systemadministrator kann einen Provider auf eine Liste erlaubter Workspaces beschränken.