Gå til hovedindhold

Integrationer

De fleste teams, der tager fremforge i brug, har allerede en issue tracker – Jira, Azure Boards, Linear, Trello – og vil gerne have, at kodeændringerne linker tilbage til de opgaver, der var anledningen til dem. Forgejo, som fremforge bygger på, har en indbygget funktion til ekstern issue tracker, der klarer det envejs, klikbare link uden nogen udvikling: indsæt et URL-mønster i repoets indstillinger, så bliver hvert JIRA-123 i en commit-besked, et branchnavn eller en PR-titel til et klikbart link direkte til din Jira (eller Azure DevOps, Linear eller et Trello-kort).

Dette afsnit er vejledningen til de seks trackere, vi oftest bliver spurgt om. Hver side er på cirka 50 linjer og dækker:

  1. Forgejo-siden – URL-mønsteret, det regulære udtryk og felterne i repoets indstillinger.
  2. Tracker-siden – den valgfri indgående webhook (så notifikationer om PR’er og commits også vises i din tracker).
  3. Konventioner for commit-beskeder – den syntaks, udviklerne bruger for at få linket til at virke (f.eks. [JIRA-123], AB#456, LINEAR-789).
  4. Betydning for underdatabehandlere – hvad det betyder under din fremforge-databehandleraftale (DPA), når commit-metadata krydser en organisatorisk grænse.

Vælg din tracker

  • Jira Cloud – hostet af Atlassian (*.atlassian.net).
  • Jira Data Center – selvhostet Jira på din egen infrastruktur.
  • Azure Boards – Microsofts tracker, en del af Azure DevOps.
  • Linear – Linear.app, en tracker i skyen.
  • Trello – Atlassians kortbaserede tracker.
  • Plane – selvhostet open source issue tracker (Apache 2.0).

Incident management

  • ServiceNow: en ServiceNow-incident for hver sikkerhedshændelse (nyt kritisk fund, malwarematch, blokeret pull, politikovertrædelse) via Table API’et.

Hvad der IKKE er med

  • Automatiske tilstandsskift (“luk JIRA-123, når PR’en merges”) – fremforge skifter (endnu) ikke automatisk tilstand på issues i din eksterne tracker. Linket går én vej: commit/PR/branch → tracker. Den modsatte retning (trackerens brugerflade viser linkede commits) kommer via den indgående webhook, som hver tracker stiller til rådighed. Den sætter du op på tracker-siden efter vejledningen på den enkelte side.
  • Synkronisering af brugerdefinerede felter – fremforge skriver ikke til trackerens brugerdefinerede felter, sprints, epics eller hierarkier af work items. Det er trackerens egne begreber, og de varierer for meget til at kunne standardiseres.

Hvis din arbejdsgang afhænger af automatisk lukning ved merge, har du to muligheder:

  1. Automatisering på tracker-siden – alle trackerne ovenfor kan sættes op til at lukke et issue, når der kommer en webhook med en bestemt payload. Forbind fremforges udgående webhook (Administration → Webhooks) med trackerens automatiserings-endpoint, og skriv lukkereglen dér.
  2. En Forgejo Action i dit repo – tilføj et trin, der sender en POST til trackerens REST API ved pull_request.closed med filteret merged: true. Det er en workflow-fil på fem linjer. Vi udgiver måske en skabelon til det i en fremtidig version; indtil videre bygger du det selv.

Fodaftryk af underdatabehandlere

Når du forbinder commit-metadata med en ekstern tracker, sendes commit-beskeder (og deres forfattere) til trackerens sky. For hostede trackere er det et nyt underdatabehandlerforhold under din fremforge-DPA. Siderne for de enkelte trackere angiver det relevante kontrolplan (USA / EU / hybrid), så din konsekvensanalyse (DPIA) kan angive det korrekt.

Selvhostede trackere (Jira DC, Plane) er ikke underdatabehandlere – metadataene bliver inden for din egen perimeter.