Hoppa till huvudinnehållet

Linear

Linear är en molnbaserad ärendehanterare där ärenden har adresser som https://linear.app/<your-workspace>/issue/<KEY>-<NUMBER>. Ärendenycklar har formen <TEAM>-<NUMBER> (t.ex. ENG-123, MKT-456).

Forgejo-sidan: extern ärendehanterare

Repots Inställningar → Enheter → Ärenden → Använd externt ärendehanteringssystem.

FältVärde
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} fångar teamnyckeln (t.ex. ENG) och {index} fångar ärendenumret. Uttrycket är avsiktligt tillåtande när det gäller teamnyckelns längd (minst 2 tecken), eftersom Linear låter dig välja vilken sträng med versaler som helst som prefix.

Ersätt <your-workspace> med slugen för din arbetsyta i Linear (den syns i adressfältet på vilken ärendesida i Linear som helst).

Rekommenderat format för commit-meddelanden

feat(checkout): trial-card dedup

ENG-892

Linears integrationer med GitHub och GitLab stöder magiska ord som fixes ENG-892 för att stänga ärendet automatiskt vid merge – orden utlöser automatisering på Linears sida. fremforge är inte en inbyggd integrationspartner till Linear, så beteendet med magiska ord kräver webhook och automatisering på kundens sida (nästa avsnitt).

Ärendehanterarens sida: webhook-driven automatisering (valfritt)

Linears inkommande webhook konfigureras på arbetsytenivå, inte per ärende:

  1. Linear → Settings → API → Webhooks → New webhook.
  2. URL: en HTTP-endpoint som du själv kontrollerar, som tolkar Forgejos webhook-payload och anropar Linears GraphQL-API för att bifoga commiten eller PR:en som en kommentar och (valfritt) ändra ärendets status. Linear tillhandahåller recept för Zapier och n8n för detta; för kunder där suveränitet är viktig klarar en Cloudflare Worker eller en egen FaaS-funktion på 30 rader jobbet direkt.
  3. I fremforge: repots Inställningar → Webbkrokar → Lägg till webbkrok → Forgejo → ange relä-endpointen ovan som mål. Kryssa i Push och Pull Request.

Ett relä däremellan behövs eftersom Linear inte förstår Forgejos webhook-format direkt. Om du har en administratör i Linear som är villig att konfigurera endpointen för magiska ord levererar fremforge händelserna; reläet mappar bara fältnamnen i payloaden.

Konsekvenser för underbiträden

Linears kontrollplan ligger i AWS US-east-1 (ingen EU-region finns per 2026-05-19; Linear har historiskt inte åtagit sig datalokalisering i EU trots önskemål från kunder). När du kopplar fremforge till Linear gäller följande:

  • Commit-metadata och författarens mejladress flödar till Linear → AWS US-east-1.
  • Lägg till Linear Orbit, Inc. som underbiträde i ditt DPA och ditt register över underbiträden.
  • Linears villkor innehåller standardavtalsklausulerna (SCC) för överföringar från EU till USA, men data LÄMNAR EU.

För arbetslaster där suveränitet är viktig, använd i stället Jira DC eller Plane.

Vad det här inte gör

  • Inget inbyggt stöd för magiska ord (fixes ENG-892) – det är en funktion i Linears egna integrationer med GitHub och GitLab, inte en del av funktionen för extern ärendehanterare. Går att uppnå via reläet som beskrivs ovan.
  • Inget skapande av ärenden via GraphQL från fremforge (commits skapar inte automatiskt ärenden i Linear, inte ens när det refererade id:t inte finns).
  • Linears begrepp ”Cycle”, ”Project” och ”Roadmap” har ingen motsvarighet i Forgejo; integrationen stannar på nivån länkar till ärenden.
Azure BoardsTrello