Gå til hovedindhold

Linear

Linear er en hostet issue tracker, hvor et issue har adressen https://linear.app/<your-workspace>/issue/<KEY>-<NUMBER>. Issue-nøgler har formen <TEAM>-<NUMBER> (f.eks. ENG-123, MKT-456).

Forgejo-siden: ekstern issue tracker

Repo-indstillinger → Enheder → Problemer → Brug ekstern problemsporing.

FeltVærdi
External issue tracker URLhttps://linear.app/<your-workspace>/issue/{user}-{index}
External issue tracker URL formathttps://linear.app/<your-workspace>/issue/{user}-{index}
External issue tracker number formatRegexp
External issue tracker number format regexp([A-Z][A-Z]+)-([0-9]+)

{user} fanger teamnøglen (f.eks. ENG), og {index} fanger issuenummeret. Det regulære udtryk er bevidst rummeligt med hensyn til teamnøglens længde (mindst 2 tegn), fordi Linear lader dig sætte præfikset til en hvilken som helst streng med store bogstaver.

Erstat <your-workspace> med slug’en for dit Linear-workspace (den står i adresselinjen på enhver issueside i Linear).

Anbefalet format for commit-beskeder

feat(checkout): trial-card dedup

ENG-892

Linears integrationer med GitHub og GitLab understøtter magiske ord som fixes ENG-892, der lukker issuet automatisk ved merge – ordene udløser automatisering på Linear-siden. fremforge er ikke en indbygget integrationspartner i Linear, så de magiske ord kræver webhook og automatisering på kundens side (næste afsnit).

Tracker-siden: webhook-drevet automatisering (valgfri)

Linears indgående webhook findes på workspaceniveau, ikke pr. issue:

  1. Linear → Settings → API → Webhooks → New webhook.
  2. URL: et HTTP-endpoint, du selv kontrollerer, som parser payloaden fra Forgejo-webhooken og kalder Linears GraphQL-API for at vedhæfte commit’en eller PR’en som en kommentar og (eventuelt) skifte issuets tilstand. Linear har opskrifter til Zapier og n8n; for suverænitetsfølsomme kunder klarer en Cloudflare Worker eller din egen FaaS på 30 linjer det direkte.
  3. I fremforge: Repo-indstillinger → Webhooks → Tilføj webhook → Forgejo → peg mod relæ-endpointet ovenfor. Sæt flueben ved Push og Pull Request.

Der skal et relæ ind imellem, fordi Linear ikke forstår Forgejos webhook-format direkte. Har du en Linear-administrator, der vil sætte endpointet til de magiske ord op, leverer fremforge hændelserne; relæet oversætter blot feltnavnene i payloaden.

Betydning for underdatabehandlere

Linears kontrolplan er AWS US-east-1 (der findes ingen EU-region pr. 2026-05-19; Linear har historisk ikke forpligtet sig til EU-dataresidens trods ønsker fra kunder). Når du forbinder fremforge med Linear:

  • Commit-metadata og forfatterens e-mail sendes til Linear → AWS US-east-1.
  • Tilføj Linear Orbit, Inc. som underdatabehandler i din DPA og fortegnelse over underdatabehandlere.
  • Linears vilkår indeholder EU’s standardkontraktbestemmelser (SCC) for overførsler fra EU til USA, men dataene FORLADER EU.

Til suverænitetsfølsomme workloads skal du i stedet bruge Jira DC eller Plane.

Hvad dette ikke gør

  • Ingen indbygget understøttelse af magiske ord (fixes ENG-892) – det er en funktion i Linears egne GitHub/GitLab-integrationer, ikke en del af funktionen til ekstern tracker. Det kan opnås via relæet beskrevet ovenfor.
  • Ingen oprettelse af issues via GraphQL fra fremforge (commits opretter ikke automatisk Linear-issues, heller ikke når det refererede id ikke findes).
  • Linears begreber “Cycle”, “Project” og “Roadmap” har ingen modsvarighed i Forgejo; integrationen holder sig til links på issueniveau.