Naar de hoofdinhoud

Jira Cloud

Jira Cloud is de gehoste issuetracker van Atlassian, bereikbaar als https://<your-org>.atlassian.net/browse/<KEY>-<NUMBER>. Deze pagina koppelt commitberichten, branchnamen en PR-titels in je fremforge-repository’s aan links naar issues in je Jira.

Forgejo-kant: externe issuetracker

Repository-instellingen → Onderdelen → Issues → Gebruik externe issue tracker.

VeldWaarde
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]+)

Toepassen, opslaan. Elke JIRA-123 of PROJ-456 (of welk projectsleutelvoorvoegsel je Jira ook gebruikt) in commitberichten, branchnamen en PR-titels wordt een klikbare link naar je Jira.

Aanbevolen formaat voor commitberichten

feat(api): add SBOM endpoint

PROJ-123 PROJ-124

Verwijs aan het eind van de commitbody naar een of meer sleutels. Het paneel “Development” bij elk issue in Jira pikt de gekoppelde commits op via de inkomende webhook (volgende sectie).

Trackerkant: inkomende webhook (optioneel)

Zo laat je Jira de gekoppelde commits en PR’s bij elk issue tonen:

  1. Jira → Settings → System → WebHooks → Create a WebHook.
  2. URL: https://<your-org>.atlassian.net/rest/dvcs/1.0/jira-dvcs-webhook (vervang dit door het DVCS-webhookendpoint van je eigen omgeving; de documentatie van Atlassian op Linking commits to issues geeft de actuele URL).
  3. Events: vink Push en Pull Request aan.
  4. In fremforge: Repository-instellingen → Webhooks → Webhook toevoegen → Forgejo → plak de URL.

Geverifieerde payloads komen binnen in de DVCS Connector van Jira. De inrichting kost ongeveer 5 minuten per repository; beheerders die over teams heen werken, regelen het meestal via de standaardinstellingen voor repository’s, zodat elke nieuwe repository het overneemt.

Gevolgen voor subverwerkers

Het control plane van Jira Cloud is AWS US-east-1 + AWS EU-west-2 (de dataresidentie van Atlassian kiest er bij registratie één). Als je fremforge aan Jira Cloud koppelt:

  • Stromen commitberichten, het e-mailadres van de auteur en de repositorynaam naar de cloud van Atlassian.
  • Werk je je DPIA en register van subverwerkers bij met Atlassian als subverwerker van persoonsgegevens (commitmetadata).
  • De DPA van fremforge sluit Atlassian uitdrukkelijk uit; het DPA-addendum van je organisatie is een apart document.

Is soevereiniteit een harde eis, gebruik dan Jira Data Center (zelf gehost) of Plane (zelf gehost, in de EU te draaien, Apache 2.0).

Wat dit niet doet

  • Geen automatisch sluiten bij een merge (automatisering aan de trackerkant: stel in Jira een automatiseringsregel in die het issue sluit wanneer de inkomende webhook binnenkomt met merged: true).
  • Geen statussynchronisatie in twee richtingen (een Jira-issue dat naar “In Progress” gaat, maakt NIET automatisch een fremforge-branch aan; daarvoor is een Forgejo Actions-workflow aan klantzijde nodig).
  • Geen smart-commit-syntaxis (#close PROJ-123 verandert de status niet; dat is een automatiseringsregel aan de Jira-kant die de klant instelt op de payload van de inkomende webhook).
Jira Data Center