Zum Hauptinhalt springen

Jira Data Center

Jira Data Center (und das ältere Jira Server) ist die selbst gehostete Variante des Trackers von Atlassian, erreichbar unter deinem eigenen Hostnamen (z. B. https://jira.example.com/browse/<KEY>-<NUMBER>). Das URL-Template ist dasselbe wie bei Jira Cloud, nur der Hostname unterscheidet sich.

Forgejo-Seite: externer Issue-Tracker

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

FeldWert
External issue tracker URLhttps://jira.example.com/browse/{user}-{index}
External issue tracker URL formathttps://jira.example.com/browse/{user}-{index}
External issue tracker number formatRegexp
External issue tracker number format regexp([A-Z][A-Z0-9]+)-([0-9]+)

Ersetze jira.example.com durch den Hostnamen deines Data Center. Liegt dein Jira hinter einem VPN oder in einem privaten Netz, funktioniert der Link trotzdem: Die URL wird nur im Browser der Nutzerin oder des Nutzers geöffnet, nicht vom fremforge-Backend aus.

Empfohlenes Format für Commit-Nachrichten

fix(auth): session-token refresh race

PROJ-456

Dieselbe Konvention wie bei Jira Cloud. Verweise stehen am Ende des Commit-Texts.

Tracker-Seite: DVCS Connector (optional)

Der klassische Weg zwischen Jira DC und Git ist das Plugin DVCS Connector (kostenlos, seit 8.x in Jira enthalten):

  1. Jira DC → Settings → Applications → DVCS accounts → Link Bitbucket or GitHub account.
  2. Der DVCS Connector unterstützt derzeit nur Bitbucket und GitHub nativ; für Forgejo nimmst du den Weg über den generischen Webhook:
    • Jira → Settings → System → WebHooks → Create a WebHook.
    • URL: https://jira.example.com/rest/api/2/issue/{issue.key}/remotelink (oder der eigene Automatisierungs-Endpunkt deines Tenants).
  3. In fremforge: Repository → Einstellungen → Webhooks → Webhook hinzufügen → Forgejo → die Webhook-URL deines Data Center einfügen. Setze die Haken bei Push und Pull Request.

Ist dein Jira DC nicht öffentlich erreichbar, ist der Webhook der richtige Baustein: fremforge sendet per POST über seinen ausgehenden Proxy (der ausgehende Verkehr zum Hostnamen deines Jira wird über Admin → Integration → Webhooks freigeschaltet).

Folgen für Unterauftragsverarbeiter

Selbst gehostet = kein neuer Unterauftragsverarbeiter. Jira DC läuft in deiner Infrastruktur (ob on-prem, in deinem AWS oder in deinem Azure). Commit-Metadaten verlassen deinen Perimeter nie:

  • Über das hinaus, was du für deine eigene Jira-DC-Installation bereits hast, ist kein Nachtrag zum AVV nötig.
  • Die Souveränität bleibt gewahrt: fremforge und dein Jira DC bleiben beide in der EU (oder dort, wo du sie betreibst).

Das ist die empfohlene Jira-Variante für Kundinnen und Kunden, für die Souveränität entscheidend ist.

Was das nicht leistet

  • Kein automatisches Schließen beim Merge (Data Center unterstützt Automatisierungsregeln über das Plugin Automation for Jira; richte diese Regeln auf Basis der Payload des eingehenden Webhooks ein).
  • Die ältere Smart-Commit-Syntax (PROJ-123 #close) setzt den DVCS Connector und einen Commit-Poller auf Bitbucket- oder GitHub-Seite voraus; bei Forgejo ist das Gegenstück deine eigene Automatisierungsregel, die die Webhook-Payload auswertet.
  • Zeitplan bei einer Migration: Ziehst du im selben Zeitraum VON Jira DC weg UND ZU fremforge um, verknüpfe beim Umstieg ein letztes Mal und friere dann ein; laufen während einer langen Migration beide Webhooks gleichzeitig, entstehen doppelte Einträge für verknüpfte Commits.