Zum Hauptinhalt springen

Linear

Linear ist ein gehosteter Issue-Tracker, erreichbar unter https://linear.app/<your-workspace>/issue/<KEY>-<NUMBER>. Issue-Schlüssel haben die Form <TEAM>-<NUMBER> (z. B. ENG-123, MKT-456).

Forgejo-Seite: externer Issue-Tracker

Repository → Einstellungen → Einheiten → Issues → Externen Issue-Tracker verwenden.

FeldWert
External issue tracker URLhttps://linear.app/<your-workspace>/issue/{user}-{index}
External issue tracker URL formathttps://linear.app/<your-workspace>/issue/{user}-{index}
External issue tracker number formatRegexp
External issue tracker number format regexp([A-Z][A-Z]+)-([0-9]+)

{user} erfasst den Team-Schlüssel (z. B. ENG), {index} die Issue-Nummer. Der reguläre Ausdruck ist bei der Länge des Team-Schlüssels (≥ 2 Zeichen) bewusst großzügig, weil du in Linear jede beliebige Großbuchstabenfolge als Präfix festlegen kannst.

Ersetze <your-workspace> durch den Slug deines Linear-Workspaces (er steht in der Adresszeile jeder Issue-Seite in Linear).

Empfohlenes Format für Commit-Nachrichten

feat(checkout): trial-card dedup

ENG-892

Die GitHub- und GitLab-Integrationen von Linear unterstützen Schlüsselwörter wie fixes ENG-892, die beim Merge automatisch schließen – diese Wörter lösen eine Automatisierung auf der Seite von Linear aus. fremforge ist kein nativer Integrationspartner von Linear, daher braucht das Verhalten mit Schlüsselwörtern einen kundenseitigen Webhook samt Automatisierung (nächster Abschnitt).

Tracker-Seite: Webhook-gesteuerte Automatisierung (optional)

Der eingehende Webhook von Linear gilt für den ganzen Workspace, nicht pro Issue:

  1. Linear → Settings → API → Webhooks → New webhook.
  2. URL: ein HTTP-Endpunkt, den du selbst betreibst, der die Forgejo-Webhook-Payload auswertet und die GraphQL-API von Linear aufruft, um den Commit oder PR als Kommentar anzuhängen und (optional) den Status des Issues zu ändern. Linear bietet dafür Rezepte für Zapier und n8n an; für Kundinnen und Kunden mit Fokus auf Souveränität erledigt das ein Cloudflare Worker mit 30 Zeilen oder deine eigene FaaS direkt.
  3. In fremforge: Repository → Einstellungen → Webhooks → Webhook hinzufügen → Forgejo → den Relay-Endpunkt von oben als Ziel angeben. Setze die Haken bei Push und Pull Request.

Ein Relay dazwischen ist nötig, weil Linear das Webhook-Format von Forgejo nicht nativ versteht. Findet sich eine Linear-Admin oder ein Linear-Admin, der den Endpunkt für die Schlüsselwörter einrichtet, liefert fremforge die Ereignisse; das Relay bildet nur die Feldnamen der Payload ab.

Folgen für Unterauftragsverarbeiter

Die Steuerungsebene von Linear liegt in AWS US-east-1 (Stand 19.05.2026 gibt es keine EU-Region; Linear hat sich trotz Kundenanfragen bisher nicht auf EU-Datenresidenz festgelegt). Wenn du fremforge mit Linear verbindest:

  • Commit-Metadaten und die E-Mail-Adresse der Autorin oder des Autors fließen zu Linear → AWS US-east-1.
  • Nimm Linear Orbit, Inc. als Unterauftragsverarbeiter in deinen AVV und dein Verzeichnis der Unterauftragsverarbeiter auf.
  • Die Bedingungen von Linear enthalten die Standardvertragsklauseln für Übermittlungen aus der EU in die USA, aber die Daten VERLASSEN die EU.

Für souveränitätskritische Workloads nutze stattdessen Jira DC oder Plane.

Was das nicht leistet

  • Keine native Unterstützung für Schlüsselwörter (fixes ENG-892) – das ist eine Funktion der nativen GitHub- und GitLab-Integration von Linear, nicht Teil des Bausteins für externe Tracker. Über den oben beschriebenen Weg mit Relay lässt es sich umsetzen.
  • Kein Anlegen von Issues über GraphQL aus fremforge heraus (Commits legen keine Linear-Issues an, auch wenn die referenzierte ID nicht existiert).
  • Die Konzepte „Cycle“, „Project“ und „Roadmap“ von Linear lassen sich nicht auf Forgejo abbilden; die Integration bleibt auf der Ebene der Issue-Links.
Azure BoardsTrello