Windshift

Gitea mit Windshift verbinden

Verknüpfen Sie eine selbst gehostete Gitea-Instanz mit Windshift, starten Sie Branches und Pull Requests aus einem Arbeitselement und behalten Sie den Review-Status am Element.

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 die native API mit Gitea. Derselbe Provider bedient auch Forgejo, weil Forgejo die Gitea-API kompatibel hält. Die Authentifizierung läuft über eine OAuth-Anwendung oder ein Zugriffstoken.

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

  • OAuth-App: Registrieren Sie eine OAuth-Anwendung in Gitea. Jede Person autorisiert ihr eigenes Konto, und Windshift erneuert das Token automatisch.
  • Zugriffstoken: Erstellen Sie ein Zugriffstoken in Gitea und nutzen Sie es für alle Vorgänge in Windshift. Verwenden Sie ein eigenes Konto für Server-zu-Server-Aufgaben.

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 Gitea anlegen: Registrieren Sie eine OAuth-Anwendung oder erstellen Sie ein Zugriffstoken. Für OAuth 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 Gitea / Forgejo und tragen Sie die Basis-URL der Instanz ein, zum Beispiel https://gitea.example.com.
  • Workspace verbinden und Repositories verknüpfen: Verbinden Sie den Provider mit dem Workspace und verknüpfen Sie die Repositories, die der Workspace verfolgt.
  • Webhook prüfen: Windshift registriert einen Repository-Webhook, wenn die Verbindung es erlaubt. Prüfen Sie die Zustellung in den Repository-Einstellungen von Gitea.

Berechtigungen und Scopes

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

  • Repositories verknüpfen und ansehen: Das verbundene Konto erreicht das Repository.
  • Branches, Pull Requests und Kommentare erstellen: Schreibzugriff auf das Repository.
  • Repository-Webhook registrieren: Administratorzugriff auf das Repository.
  • OAuth-Scopes: read:user read:repository write:repository

Hinweise zum Selbst-Hosting

Gitea wird selbst gehostet, deshalb ist die Basis-URL erforderlich. 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 Forgejo über den Gitea-Provider?

Ja. Forgejo hält die Gitea-API kompatibel, deshalb funktioniert derselbe Provider. Tragen Sie die URL der Forgejo-Instanz als Basis-URL ein.

Kann ich mehr als eine Gitea-Instanz verbinden?

Ja. Fügen Sie einen Provider pro Instanz mit eigener Basis-URL hinzu und verknüpfen Sie dann die Repositories, 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.