Windshift

Forgejo mit Windshift verbinden

Verknüpfen Sie eine selbst gehostete Forgejo-Instanz über die Gitea-kompatible API 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

Forgejo ist ein Community-Forks von Gitea und hält die Gitea-API kompatibel. Windshift verbindet sich über denselben Provider wie bei Gitea, deshalb funktionieren Repository-Verknüpfung, Branches, Commits, Pull Requests, Reviews, Releases und Webhooks gleich.

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

  • OAuth-App: Registrieren Sie eine OAuth-Anwendung in Forgejo. Jede Person autorisiert ihr eigenes Konto, und Windshift erneuert das Token automatisch.
  • Zugriffstoken: Erstellen Sie ein Zugriffstoken in Forgejo 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 Forgejo 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 Forgejo-Instanz ein, zum Beispiel https://forgejo.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 Forgejo.

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

Forgejo 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

Warum wird Forgejo in Windshift als Gitea eingerichtet?

Forgejo hält die Gitea-API kompatibel, deshalb nutzt Windshift einen Provider für beide. Wählen Sie Gitea / Forgejo und tragen Sie die URL der Forgejo-Instanz ein.

Unterscheidet sich die Forgejo-Integration von Gitea?

Provider, Berechtigungen und Ablauf sind gleich. Unterschiedlich sind nur die Instanz-URL und die OAuth-Anwendung.

Kann ich einen Provider auf bestimmte Workspaces beschränken?

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