Integraties

De meeste teams die overstappen op fremforge hebben al een issuetracker, zoals Jira, Azure Boards, Linear of Trello, en willen dat hun codewijzigingen terugverwijzen naar de tickets die er de aanleiding voor waren. Het onderliggende Forgejo-platform van fremforge heeft daarvoor een ingebouwde externe issuetracker, die het geval van een klikbare link in één richting afdekt zonder dat je iets hoeft te ontwikkelen: zet een URL-patroon in de repository-instellingen, en elke JIRA-123 in een commitbericht, branchnaam of PR-titel wordt een klikbare link rechtstreeks naar je Jira (of Azure DevOps, Linear of Trello-kaart).

Deze sectie is de handleiding voor de zes trackers waar het vaakst naar gevraagd wordt. Elke pagina telt zo’n 50 regels en behandelt:

De Forgejo-kant: het URL-patroon, de reguliere expressie en de velden in de repository-instellingen.
De trackerkant: de optionele inkomende webhook (dan verschijnen meldingen over PR’s en commits ook in je tracker).
Conventies voor commitberichten: de syntaxis die je ontwikkelaars gebruiken om de link te laten werken (bijv. [JIRA-123], AB#456, LINEAR-789).
Gevolgen voor subverwerkers: wat het onder je fremforge-verwerkersovereenkomst (DPA) betekent wanneer commitmetadata een organisatiegrens oversteekt.

Kies je tracker

Jira Cloud: gehost door Atlassian (*.atlassian.net).
Jira Data Center: Jira op je eigen infrastructuur.
Azure Boards: de tracker van Microsoft, onderdeel van Azure DevOps.
Linear: de cloudtracker Linear.app.
Trello: de kaartgebaseerde tracker van Atlassian.
Plane: zelf gehoste opensource-issuetracker (Apache 2.0).

Incidentbeheer

ServiceNow: een ServiceNow-incident voor elke beveiligingsgebeurtenis (nieuwe kritieke bevinding, malwaretreffer, geblokkeerde pull, beleidsovertreding), via de Table API.

Wat hier NIET in zit

Automatische statusovergangen (“sluit JIRA-123 wanneer de PR wordt gemerged”): fremforge verandert (nog) niet automatisch de status van issues in je externe tracker. De link werkt in één richting: commit/PR/branch → tracker. De omgekeerde richting (de tracker toont gekoppelde commits) loopt via de inkomende webhook die elke tracker biedt; stel die aan de trackerkant in volgens de instructies op de pagina van je tracker.
Synchronisatie van aangepaste velden: fremforge schrijft niet naar aangepaste velden, sprints, epics of werkitemhiërarchieën van je tracker. Dat zijn trackerinterne begrippen die te veel verschillen om te standaardiseren.

Hangt je werkwijze af van automatisch sluiten bij een merge, dan heb je twee opties:

Automatisering aan de trackerkant: elke tracker hierboven kun je zo instellen dat een issue sluit wanneer er een webhook met een bepaalde payload binnenkomt. Verbind de uitgaande webhook van fremforge (beheer → Webhooks) met het automatiseringsendpoint van je tracker en leg daar de sluitregel vast.
Een Forgejo Action in je repository: voeg een stap toe die bij pull_request.closed met het filter merged: true een POST naar de REST API van je tracker stuurt. Een workflowbestand van vijf regels. Mogelijk leveren we hier in een toekomstige release een sjabloon voor; voorlopig bouw je dit zelf.

Subverwerkers

Als je commitmetadata aan een externe tracker koppelt, stromen commitberichten (en hun auteurs) naar de cloud van die tracker. Bij een tracker die als dienst gehost wordt, is dat een nieuwe subverwerkersrelatie onder je fremforge-DPA. Op de pagina van elke tracker staat het betreffende control plane (VS / EU / hybride), zodat je DPIA het correct kan vermelden.

Zelf gehoste trackers (Jira DC, Plane) zijn geen subverwerkers: de metadata blijft binnen je eigen omgeving.