Gå til hovedinnhold

Linear

Linear er en driftet issue-tracker med adresser på formen https://linear.app/<your-workspace>/issue/<KEY>-<NUMBER>. Issue-nøkler følger formen <TEAM>-<NUMBER> (f.eks. ENG-123, MKT-456).

Forgejo-siden: ekstern issue-tracker

Innstillinger for repositoryet → Enheter → Issues → Bruk ekstern issue-tracker.

FeltVerdi
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økkelen (f.eks. ENG), {index} fanger issue-nummeret. Regex-uttrykket er med vilje romslig når det gjelder lengden på teamnøkkelen (minst 2 tegn), fordi Linear lar deg sette prefikset til en hvilken som helst streng med store bokstaver.

Bytt ut <your-workspace> med slugen for arbeidsområdet ditt i Linear (den står i adressefeltet på enhver issue-side i Linear).

Anbefalt format for commit-meldinger

feat(checkout): trial-card dedup

ENG-892

Linears integrasjoner med GitHub og GitLab støtter magiske ord som fixes ENG-892 for automatisk lukking ved merge – disse ordene utløser automatisering på Linear-siden. fremforge er ikke en innebygd integrasjonspartner i Linear, så oppførselen med magiske ord krever webhook og automatisering på kundesiden (neste avsnitt).

Tracker-siden: webhook-drevet automatisering (valgfritt)

Den innkommende webhooken i Linear ligger på arbeidsområdenivå, ikke per issue:

  1. Linear → Settings → API → Webhooks → New webhook.
  2. URL: et HTTP-endepunkt du selv kontrollerer, som tolker webhook-payloaden fra Forgejo og kaller Linears GraphQL-API for å legge til commiten eller PR-en som en kommentar og (eventuelt) endre status på issuen. Linear tilbyr oppskrifter for Zapier og n8n til dette; for kunder som er opptatt av suverenitet, gjør en Cloudflare Worker eller din egen FaaS-funksjon på 30 linjer jobben direkte.
  3. I fremforge: innstillinger for repositoryet → Webhooks → Legg til webhook → Forgejo → pek mot relé-endepunktet over. Kryss av for Push og Pull Request.

Et relé i midten trengs fordi Linear ikke forstår webhook-formatet til Forgejo direkte. Hvis du har en Linear-administrator som er villig til å sette opp endepunktet for magiske ord, leverer fremforge hendelsene; reléet oversetter bare feltnavnene i payloaden.

Konsekvenser for underdatabehandlere

Kontrollplanet til Linear er AWS US-east-1 (ingen EU-region tilgjengelig per 2026-05-19; Linear har historisk ikke forpliktet seg til datalokalisering i EU, til tross for forespørsler fra kunder). Når du kobler fremforge til Linear:

  • Commit-metadata og forfatterens e-postadresse flyter til Linear → AWS US-east-1.
  • Før opp Linear Orbit, Inc. som underdatabehandler i databehandleravtalen og underdatabehandlerregisteret ditt.
  • Linears vilkår omfatter standard personvernbestemmelser (SCC-er) for overføringer fra EU til USA, men dataene FORLATER EU.

For arbeidslaster der suverenitet er viktig, bruker du heller Jira DC eller Plane.

Hva dette ikke gjør

  • Ingen innebygd støtte for magiske ord (fixes ENG-892) – det er en funksjon i Linears egen integrasjon med GitHub og GitLab, ikke en del av mekanismen for ekstern tracker. Kan oppnås via relé-veien beskrevet over.
  • Ingen oppretting av issues via GraphQL fra fremforge (commits oppretter ikke issues i Linear automatisk, selv om den refererte ID-en ikke finnes).
  • Linears begreper «Cycle», «Project» og «Roadmap» har ingen motsvarighet i Forgejo; integrasjonen holder seg på nivået lenker til issues.