Hoppa till huvudinnehållet

Jira Cloud

Jira Cloud är Atlassians molnbaserade ärendehanterare, där ärenden har adresser som https://<your-org>.atlassian.net/browse/<KEY>-<NUMBER>. Den här sidan visar hur du kopplar commit-meddelanden, branch-namn och PR-titlar i dina fremforge-repon till länkar till ärenden i din Jira.

Forgejo-sidan: extern ärendehanterare

Repots Inställningar → Enheter → Ärenden → Använd externt ärendehanteringssystem.

FältVärde
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]+)

Verkställ och spara. Varje JIRA-123 eller PROJ-456 (eller vilket projektnyckelprefix din Jira än använder) i commit-meddelanden, branch-namn och PR-titlar blir en klickbar länk till din Jira.

Rekommenderat format för commit-meddelanden

feat(api): add SBOM endpoint

PROJ-123 PROJ-124

Ange en eller flera nycklar i slutet av commit-texten. Panelen ”Development” på varje ärende i Jira plockar upp de länkade commitsen via den inkommande webhooken (nästa avsnitt).

Ärendehanterarens sida: inkommande webhook (valfritt)

Så får du Jira att visa länkade commits och PR:er på varje ärende:

  1. Jira → Settings → System → WebHooks → Create a WebHook.
  2. URL: https://<your-org>.atlassian.net/rest/dvcs/1.0/jira-dvcs-webhook (ersätt med din instans DVCS-webhook-endpoint; Atlassians dokumentation Linking commits to issues anger den aktuella URL:en).
  3. Händelser: kryssa i Push och Pull Request.
  4. I fremforge: repots Inställningar → Webbkrokar → Lägg till webbkrok → Forgejo → klistra in URL:en.

Verifierade payloads hamnar i Jiras DVCS Connector. Konfigurationen tar cirka 5 minuter per repo; administratörer som ansvarar för flera team konfigurerar den oftast via standardinställningarna för repon, så att varje nytt repo ärver den.

Konsekvenser för underbiträden

Jira Clouds kontrollplan ligger i AWS US-east-1 + AWS EU-west-2 (Atlassians datalokalisering väljer ett av dem vid registreringen). När du kopplar fremforge till Jira Cloud gäller följande:

  • Commit-meddelanden, författarens mejladress och repots namn flödar till Atlassians moln.
  • Uppdatera din konsekvensbedömning (DPIA) och ditt register över underbiträden så att Atlassian finns med som underbiträde som behandlar personuppgifter (commit-metadata).
  • fremforges personuppgiftsbiträdesavtal (DPA) undantar uttryckligen Atlassian – din organisations DPA-tillägg är ett separat dokument.

Om suveränitet är ett absolut krav, använd i stället Jira Data Center (egendriftad) eller Plane (egendriftad, kan driftas i EU, Apache 2.0).

Vad det här inte gör

  • Ingen automatisk stängning vid merge (automatisering i ärendehanteraren: konfigurera en automatiseringsregel i Jira som stänger ärendet när den inkommande webhooken kommer med merged: true).
  • Ingen dubbelriktad statussynkronisering (när ett ärende i Jira flyttas till ”In Progress” skapas INTE automatiskt någon branch i fremforge; det kräver ett arbetsflöde i Forgejo Actions på kundens sida).
  • Ingen smart commit-syntax (#close PROJ-123 ändrar inte status – det är en automatiseringsregel i Jira som kunden konfigurerar mot den inkommande webhookens payload).
Jira Data Center