Integrationer

De flesta team som börjar använda fremforge har redan en ärendehanterare – Jira, Azure Boards, Linear, Trello – och vill att kodändringarna ska länka tillbaka till ärendena som låg bakom dem. Forgejo-plattformen som fremforge bygger på har en inbyggd funktion för extern ärendehanterare som löser fallet med envägs klickbara länkar helt utan utvecklingsarbete: lägg in ett URL-mönster i repots inställningar, så blir varje JIRA-123 i ett commit-meddelande, ett branch-namn eller en PR-titel en klickbar länk direkt till din Jira (eller Azure DevOps, Linear eller ett Trello-kort).

Det här avsnittet visar hur du gör för de sex ärendehanterare vi oftast får frågor om. Varje sida är cirka 50 rader och tar upp:

Forgejo-sidan – URL-mönstret, det reguljära uttrycket och fälten i repots inställningar.
Ärendehanterarens sida – den valfria inkommande webhooken (så att notiser om PR:er och commits också syns i ärendehanteraren).
Konventioner för commit-meddelanden – syntaxen dina utvecklare använder för att länken ska skapas (t.ex. [JIRA-123], AB#456, LINEAR-789).
Konsekvenser för underbiträden – vad det innebär enligt ditt personuppgiftsbiträdesavtal (DPA) med fremforge när commit-metadata passerar en organisationsgräns.

Välj din ärendehanterare

Jira Cloud – driftas av Atlassian (*.atlassian.net).
Jira Data Center – egendriftad Jira i din egen infrastruktur.
Azure Boards – Microsofts ärendehanterare, en del av Azure DevOps.
Linear – molntjänsten Linear.app.
Trello – Atlassians kortbaserade ärendehanterare.
Plane – egendriftad ärendehanterare med öppen källkod (Apache 2.0).

Incidenthantering

ServiceNow: en incident i ServiceNow för varje säkerhetshändelse (nytt kritiskt fynd, träff på skadlig kod, blockerad pull, policyöverträdelse), via Table API.

Vad som INTE finns här

Automatiska statusövergångar (”stäng JIRA-123 när PR:en mergas”) – fremforge ändrar (ännu) inte automatiskt status på ärenden i din externa ärendehanterare. Länken går åt ett håll: commit/PR/branch → ärendehanterare. Den omvända riktningen (att ärendehanterarens gränssnitt visar länkade commits) får du via den inkommande webhook som varje ärendehanterare erbjuder; konfigurera den på ärendehanterarens sida enligt anvisningarna på respektive sida.
Synkronisering av anpassade fält – fremforge skriver inte till anpassade fält, sprintar, epics eller hierarkier av arbetsobjekt i ärendehanteraren. Det är begrepp som är interna för varje ärendehanterare och varierar för mycket för att kunna standardiseras.

Om ditt arbetsflöde bygger på att ärenden stängs automatiskt vid merge finns två alternativ:

Automatisering i ärendehanteraren – alla ärendehanterare ovan kan konfigureras att stänga ett ärende när en webhook med en viss payload kommer in. Koppla fremforges utgående webhook (Organisationens administration → Webhooks) till ärendehanterarens automatiserings-endpoint och skriv stängningsregeln där.
En Forgejo Action i ditt repo – lägg till ett steg som gör en POST mot ärendehanterarens REST API vid pull_request.closed med filtret merged: true. En arbetsflödesfil på fem rader. Vi kan komma att leverera en färdig mall för detta i en framtida version; tills vidare bygger du det själv.

Underbiträden som berörs

Att koppla commit-metadata till en extern ärendehanterare innebär att commit-meddelanden (och deras författare) flödar till ärendehanterarens moln. För molntjänster blir det en ny underbiträdesrelation enligt ditt personuppgiftsbiträdesavtal med fremforge. Sidorna för respektive ärendehanterare anger var kontrollplanet finns (USA / EU / hybrid), så att din konsekvensbedömning (DPIA) kan ange det korrekt.

Egendriftade ärendehanterare (Jira DC, Plane) är inte underbiträden – metadatan stannar inom din egen perimeter.