Linear koppelen

Koppel Linear aan je InfraNest-account zodat automatiseringen issues kunnen openen, becommentariëren of sluiten namens jou — een certificaat dat bijna verloopt, een monitor die uitviel, een domein dat voor verlenging in aanmerking komt — ingediend bij het juiste team zonder dat iemand gegevens hoeft over te typen.

Overzicht

• Laat automatiseringen automatisch Linear-issues aanmaken en bijwerken.
• Kan ook andersom werken: wijzigingen in Linear kunnen een InfraNest-automatisering starten.
• Werkt zowel met een koppeling in één klik als met een persoonlijke API-sleutel.

Je workspace koppelen

1. Open Integraties in de zijbalk en zoek Linear.
2. Klik op Connect with Linear (indien weergegeven).
3. Keur de workspace goed in Linear.
4. Je komt terug in InfraNest, al gekoppeld — er hoeft niets gekopieerd te worden.

NoteAls Connect with Linear grijs is weergegeven, heeft je InfraNest-beheerder nog geen Linear-app geregistreerd. Gebruik in dat geval een API-sleutel — die werkt op dezelfde manier zodra deze is gekoppeld.

Koppelen met een API-sleutel

1. Open in Linear Settings → Account → Security & Access.
2. Maak onder Personal API keys een sleutel aan met Read- en Write-toegang.
3. Kopieer de sleutel — Linear toont deze slechts één keer.
4. Open in InfraNest Integraties in de zijbalk, vervolgens Linear, plak de sleutel en selecteer Opslaan.

InfraNest controleert de sleutel meteen en toont de workspace waartoe deze behoort, zodat je kunt bevestigen dat je de juiste hebt gekoppeld.

WarningEen sleutel kan beperkt zijn tot specifieke teams. Als je dit doet, zorg er dan voor dat het team waarin je issues wilt plaatsen hierin is opgenomen — anders wordt de koppeling wel gemaakt, maar mislukt deze zodra een automatisering wordt uitgevoerd. Let er ook op dat de sleutel gekoppeld is aan de persoon die hem heeft aangemaakt; als die persoon vertrekt, stopt de sleutel met werken. Gebruik voor een koppeling waar het hele team op vertrouwt liever de sleutel van een beheerder of de koppeling in één klik.

Issues aanmaken vanuit een automatisering

1. Bouw een regel zoals gebruikelijk en kies Create Linear issue als actie.
2. Stel Team in — begin te typen en kies uit je Linear-teams, of typ een teamcode zoals ENG.
3. Vul Title en Description in — platte tekst, waarin je waarden kunt invoegen uit wat de regel heeft geactiveerd, zodat het issue meteen de domeinnaam of monitor bevat.
4. Stel optioneel Status in — laat dit leeg en Linear plaatst het issue waar de nieuwe issues van dat team normaal gesproken terechtkomen.
5. Stel optioneel Project en Assignee in — projecten worden getoond voor het gekozen team; iedereen in je workspace kan de assignee zijn, of typ het e-mailadres.
6. Stel optioneel Priority in, met Linears eigen schaal (1 is Urgent, 4 is Low).

Het issue dat de regel aanmaakt, is beschikbaar voor latere stappen binnen dezelfde regel, zodat je de link er meteen na het aanmaken naar Slack kunt posten, er een reactie op kunt plaatsen, of het kunt sluiten.

Eén ticket per incident. Wanneer de regel wordt uitgevoerd bij een incident (bijvoorbeeld een monitor die uitviel), onthoudt InfraNest het issue dat is geopend. Als de regel opnieuw wordt uitgevoerd voor hetzelfde incident terwijl dat issue nog open staat, voegt InfraNest een reactie toe in plaats van een nieuw issue te openen — een flapperende monitor levert je dus één issue op, niet één per flap. Om toch telkens een nieuw issue te openen, stel je If this incident already has an open ticket in op Open a new ticket anyway. De tijdlijn van het incident bevat een link naar het issue.

Een issue becommentariëren of de status wijzigen

1. Voeg Comment on Linear issue toe om een reactie te plaatsen — handig als tegenhanger van een regel die issues opent: de monitor herstelt, en het issue vermeldt dat.
2. Voeg Set Linear issue status toe om het issue te verplaatsen, zodat een regel die werk opende dit ook kan afronden.
3. Geef voor beide acties aan om welk issue het gaat — vul de identifier in zoals je die in Linear ziet (ENG-14), of verwijs naar het issue dat een eerdere stap in dezelfde regel heeft aangemaakt, wat de kiezer van eerdere waarden aanbiedt.
4. Typ bij een status de naam precies zoals deze op het bord van dat team staat (“In Progress”, “Done”). Statussen horen bij een team, en het team komt voort uit het issue zelf, dus is er hier geen lijst om uit te kiezen.

Een automatisering starten vanuit Linear

1. Ga naar Integraties → Linear en selecteer Turn on triggers bij het account.
2. Open in Linear Settings → API → Webhooks en selecteer New webhook. Hiervoor is een Linear-beheerder nodig.
3. Plak de URL die InfraNest toont, kies de teams die je wilt volgen en vink Issues en Comments aan. Sla op.
4. Linear toont eenmalig een signing secret. Kopieer deze, plak hem in InfraNest en selecteer Opslaan.

Het account geeft vervolgens aan of er events binnenkomen. Wijzig een issue om het te testen. In de automatiseringsbouwer waarschuwt een Linear-trigger je wanneer geen enkel Linear-account triggers heeft ingeschakeld.

Issue a new URL vervangt de URL onmiddellijk — plak de nieuwe meteen in de Linear-webhook. Turn off triggers stopt ze; verwijder de webhook ook in Linear.

Problemen oplossen

“Linear rejected the key” — de sleutel is onjuist, verlopen, of aangemaakt zonder Write-toegang. Maak een nieuwe aan en plak deze opnieuw.

Een lijst geeft aan waarom er niets te tonen is. Wanneer Linear niet kon worden geraadpleegd, legt de lijst dit uit in plaats van leeg te blijven:

• Needs to be connected again — de toegang van de koppeling is ingetrokken of verlopen. Koppel opnieuw via Integraties in de zijbalk. De lijst vult zich bij je volgende poging.
• Isn't allowed to read this list — de koppeling werkt, maar de toegang dekt deze lijst niet. Geef die toegang in Linear, of typ de waarde zelf.
• Couldn't load suggestions just now — Linear reageerde niet. Probeer het straks opnieuw, of typ de waarde zelf.

De teamlijst is leeg. Kies eerst een koppeling, bovenaan de actie. Is deze nog steeds leeg, dan is de sleutel waarschijnlijk beperkt tot teams die hij niet kan zien — controleer de teambeperkingen in Linear.

De statuslijst is leeg. Statussen horen bij een team, dus kies eerst het team. Als het team afkomstig is van de trigger in plaats van gekozen te worden, blijft de lijst leeg — typ in dat geval de statusnaam zelf, en de automatisering lost deze op tijdens de uitvoering.

De projectlijst is leeg. Projecten horen bij teams — kies eerst het team, waarna alleen de projecten van dat team worden getoond.

Een automatisering is mislukt met “Linear rejected the request”. Open de uitvoering in Automatiseringen → History; de stap toont wat Linear heeft gemeld. De gebruikelijke oorzaak is een team dat de sleutel niet kan bereiken, of een statusnaam die niet bestaat binnen dat team.

“No Linear user matches…” — twee mensen kunnen dezelfde weergavenaam hebben, dus matcht de automatisering eerst op e-mailadres. Gebruik het adres om zeker te zijn wie wordt bedoeld.

Wat InfraNest bewaart

InfraNest ontvangt van Linear een event voor elk issue en elke reactie die jij of je team aanmaakt of wijzigt — ongeacht of een automatisering dit gebruikt.

• Gebeurtenisgeschiedenis — wordt gebruikt om te laten zien hoe vaak een conceptautomatisering zou zijn uitgevoerd. Hierin wordt bijgehouden welk issue het betreft, de status, het team en de prioriteit, wie de actie uitvoerde en wat er gebeurde, gedurende 45 dagen. De geschreven tekst zelf wordt niet bewaard: issue-titels en reactietekst worden weggelaten.
• Uitvoeringsgeschiedenis — wanneer een automatisering daadwerkelijk wordt uitgevoerd, bewaart de uitvoering het volledige event waarop deze reageerde, inclusief de reactietekst, gedurende 90 dagen. Alleen leden wiens rol automatiseringen mag bewerken, kunnen dit inzien. Anderen zien alleen dát een uitvoering heeft plaatsgevonden en of deze is geslaagd.

De koppeling verbreken stopt het binnenkomen van nieuwe events. Wat InfraNest al heeft opgeslagen, wordt verwijderd zodra die 45 en 90 dagen zijn verstreken.