Zum Hauptinhalt springen

Jira Cloud

Jira Cloud ist der gehostete Issue-Tracker von Atlassian, erreichbar unter https://<your-org>.atlassian.net/browse/<KEY>-<NUMBER>. Diese Seite verbindet Commit-Nachrichten, Branch-Namen und PR-Titel in deinen fremforge-Repositorys mit Links auf Issues in deinem Jira.

Forgejo-Seite: externer Issue-Tracker

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

FeldWert
External issue tracker URLhttps://<your-org>.atlassian.net/browse/{user}-{index}
External issue tracker URL formathttps://<your-org>.atlassian.net/browse/{user}-{index}
External issue tracker number formatRegexp
External issue tracker number format regexp([A-Z][A-Z0-9]+)-([0-9]+)

Übernehmen und speichern. Jedes JIRA-123 oder PROJ-456 (oder welches Projektschlüssel-Präfix dein Jira auch verwendet) in Commit-Nachrichten, Branch-Namen und PR-Titeln wird zu einem anklickbaren Link in dein Jira.

Empfohlenes Format für Commit-Nachrichten

feat(api): add SBOM endpoint

PROJ-123 PROJ-124

Führe einen oder mehrere Schlüssel am Ende des Commit-Texts auf. Das Panel „Development“ an jedem Jira-Issue übernimmt die verknüpften Commits über den eingehenden Webhook (nächster Abschnitt).

Tracker-Seite: eingehender Webhook (optional)

Damit Jira die verknüpften Commits und PRs an jedem Issue anzeigt:

  1. Jira → Settings → System → WebHooks → Create a WebHook.
  2. URL: https://<your-org>.atlassian.net/rest/dvcs/1.0/jira-dvcs-webhook (ersetze sie durch den DVCS-Webhook-Endpunkt deines Tenants; die aktuelle URL steht in der Atlassian-Dokumentation unter Linking commits to issues).
  3. Ereignisse: Setze die Haken bei Push und Pull Request.
  4. In fremforge: Repository → Einstellungen → Webhooks → Webhook hinzufügen → Forgejo → URL einfügen.

Geprüfte Payloads landen im DVCS Connector von Jira. Die Einrichtung dauert etwa 5 Minuten pro Repository; Admins, die mehrere Teams betreuen, richten sie meist über die Repository-Standards ein, sodass jedes neue Repository sie erbt.

Folgen für Unterauftragsverarbeiter

Die Steuerungsebene von Jira Cloud liegt in AWS US-east-1 + AWS EU-west-2 (die Datenresidenz von Atlassian legt bei der Registrierung eine davon fest). Wenn du fremforge mit Jira Cloud verbindest:

  • Commit-Nachrichten, die E-Mail-Adresse der Autorin oder des Autors und der Repository-Name fließen in die Cloud von Atlassian.
  • Ergänze deine DSFA und dein Verzeichnis der Unterauftragsverarbeiter um Atlassian als Unterauftragsverarbeiter, der personenbezogene Daten (Commit-Metadaten) verarbeitet.
  • Der AVV von fremforge schließt Atlassian ausdrücklich aus; der AVV-Nachtrag deines Tenants ist ein eigenes Dokument.

Ist Souveränität eine harte Vorgabe, nutze stattdessen Jira Data Center (selbst gehostet) oder Plane (selbst gehostet, in der EU betreibbar, Apache 2.0).

Was das nicht leistet

  • Kein automatisches Schließen beim Merge (Automatisierung auf der Tracker-Seite: Richte eine Jira-Automatisierungsregel ein, die das Issue schließt, wenn der eingehende Webhook mit merged: true eintrifft).
  • Keine bidirektionale Statussynchronisierung (wechselt ein Jira-Issue auf „In Progress“, wird in fremforge NICHT automatisch ein Branch angelegt; dafür braucht es einen Forgejo-Actions-Workflow auf Kundenseite).
  • Keine Smart-Commit-Syntax (#close PROJ-123 ändert den Status nicht – dafür ist eine Automatisierungsregel auf der Jira-Seite nötig, die du auf Basis der Payload des eingehenden Webhooks einrichtest).
Jira Data Center