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.
| Felt | Verdi |
|---|---|
| External issue tracker URL | https://linear.app/<your-workspace>/issue/{user}-{index} |
| External issue tracker URL format | https://linear.app/<your-workspace>/issue/{user}-{index} |
| External issue tracker number format | Regexp |
| 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-892Linears 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:
- Linear → Settings → API → Webhooks → New webhook.
- 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.
- 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.