Linear koppelen

Koppel Linear zodat je automatiseringen automatisch issues kunnen aanmaken, becommentariëren of bijwerken — een certificaat dat bijna verloopt, een monitor die down ging, een domein dat aan verlenging toe is — ingediend bij het juiste team zonder dat iemand details handmatig hoeft over te typen.

Overzicht

• Linear koppel je met één klik (OAuth) of met een API-sleutel.
• Eenmaal gekoppeld kunnen je automatiseringen issues aanmaken, erop reageren en de status ervan wijzigen.
• Issues komen terecht bij het juiste team, met de details van wat de automatisering triggerde al ingevuld.

Je werkruimte koppelen

1. Ga naar Instellingen, dan Integraties.
2. Zoek Linear en klik erop.
3. Keur de werkruimte goed wanneer Linear daarom vraagt.
4. Je komt terug in InfraNest, al gekoppeld — niets om te kopiëren.

NoteAls de knop Verbinden grijs is, heeft je InfraNest-beheerder nog geen Linear-app geregistreerd. Gebruik dan een API-sleutel — die werkt op dezelfde manier zodra hij gekoppeld is.

Koppelen met een API-sleutel

1. Open in Linear Settings → Account → Security & Access.
2. Maak onder Personal API keys een sleutel aan. Geef deze Read- en Write-toegang.
3. Kopieer de sleutel — Linear toont deze maar één keer.
4. Ga in InfraNest naar Instellingen → Integraties → Linear, plak de sleutel en klik op Opslaan.

InfraNest controleert de sleutel meteen en toont bij welke werkruimte deze hoort, zodat je kunt bevestigen dat je de juiste hebt gekoppeld.

WarningEen sleutel kan beperkt zijn tot specifieke teams. Als je dit beperkt, zorg dan dat het team waarin je issues wilt ook is inbegrepen — een sleutel die dat team uitsluit, koppelt gewoon en mislukt pas als een automatisering draait.

De sleutel is gekoppeld aan de persoon die deze heeft aangemaakt. Verlaat die persoon het team, dan stopt de sleutel met werken — voor een koppeling waar het hele team op vertrouwt, is een sleutel van een beheerder of de koppeling met één klik de veiligere keuze.

Issues aanmaken vanuit een automatisering

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

Het issue dat de regel aanmaakt, is beschikbaar voor latere stappen in dezelfde regel, zodat je de link ervan direct naar Slack kunt posten na het aanmaken — of erop kunt reageren, of het kunt sluiten, met de acties hieronder.

Reageren op een issue, of de status wijzigen

1. Voeg Comment on Linear issue of Set Linear issue status toe als stap in je regel.
2. Geef aan om welk issue het gaat — geef de identifier zoals je die in Linear ziet (zoals ENG-14), of verwijs naar het issue dat een eerdere stap in dezelfde regel heeft aangemaakt (de kiezer van eerdere waarden biedt dit aan).
3. Voor een reactie schrijf je de tekst — handig als tweede helft van een regel die issues opent: de monitor herstelt, en het issue meldt dit.
4. Voor een statuswijziging typ je de naam exact zoals die op het bord van dat team staat ("In Progress", "Done"). Statussen horen bij een team, en het team komt uit het issue zelf, dus is er hier geen lijst om uit te kiezen.

Problemen oplossen

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

De teamlijst is leeg. Kies eerst een verbinding, bovenaan de actie. Is deze nog steeds leeg, dan is de sleutel waarschijnlijk beperkt tot teams die deze 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 — je kunt de statusnaam dan zelf typen en de automatisering lost dit op wanneer deze draait.

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

Een automatisering is mislukt met "Linear rejected the request". Open de uitvoering in Automatiseringen → Geschiedenis; de stap toont wat Linear meldde. De gebruikelijke oorzaak is een team dat de sleutel niet kan bereiken, of een statusnaam die niet bestaat bij dat team.

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