Connecter Linear

Connectez Linear pour que vos automatisations puissent ouvrir, commenter ou mettre à jour des tickets automatiquement — un certificat sur le point d'expirer, un moniteur tombé en panne, un domaine à renouveler — déposé dans la bonne équipe sans que personne n'ait à recopier les détails à la main.

Aperçu

• Linear se connecte en un clic (OAuth) ou avec une clé API.
• Une fois connecté, vos automatisations peuvent créer des tickets, les commenter et changer leur statut.
• Les tickets arrivent dans la bonne équipe, avec les détails de ce qui a déclenché l'automatisation déjà renseignés.

Connecter votre espace de travail

1. Allez dans Paramètres, puis Intégrations.
2. Trouvez Linear et cliquez dessus.
3. Approuvez l'espace de travail lorsque Linear le demande.
4. Vous revenez sur InfraNest déjà connecté — rien à recopier.

NoteSi le bouton Connecter est grisé, votre administrateur InfraNest n'a pas encore enregistré d'application Linear. Utilisez plutôt une clé API — elle fonctionne de la même façon une fois connectée.

Connexion avec une clé API

1. Dans Linear, ouvrez Settings → Account → Security & Access.
2. Sous Personal API keys, créez une clé. Donnez-lui les accès Read et Write.
3. Copiez la clé — Linear ne l'affiche qu'une seule fois.
4. Dans InfraNest, allez dans Paramètres → Intégrations → Linear, collez la clé et cliquez sur Enregistrer.

InfraNest vérifie immédiatement la clé et affiche l'espace de travail auquel elle appartient, afin que vous puissiez confirmer que vous avez connecté le bon.

WarningUne clé peut être limitée à des équipes spécifiques. Si vous la restreignez, assurez-vous qu'elle inclut l'équipe dans laquelle vous voulez les tickets — une clé qui l'exclut se connectera sans problème puis échouera lorsqu'une automatisation s'exécutera.

La clé est liée à la personne qui l'a créée. Si cette personne quitte l'équipe, la clé cesse de fonctionner — pour une connexion sur laquelle toute l'équipe compte, la clé d'un administrateur ou l'option de connexion en un clic est le choix le plus sûr.

Créer des tickets depuis une automatisation

1. Créez une règle comme d'habitude.
2. Choisissez Create Linear issue comme action.
3. Définissez Team — commencez à taper et choisissez parmi vos équipes Linear, ou saisissez une clé d'équipe telle que ENG.
4. Remplissez Title et Description — texte brut, et vous pouvez y insérer des valeurs provenant de ce qui a déclenché la règle, afin que le ticket arrive déjà avec le nom de domaine ou le moniteur concerné.
5. (Facultatif) Définissez Status — laissez vide et Linear placera le ticket là où vont normalement les nouveaux tickets de cette équipe.
6. (Facultatif) Définissez Project et Assignee — les projets listés correspondent à l'équipe choisie ; n'importe qui dans votre espace de travail peut être l'assigné, ou saisissez son adresse e-mail au lieu de le sélectionner.
7. (Facultatif) Définissez Priority, en utilisant l'échelle propre à Linear (1 est Urgent, 4 est Low).

Le ticket créé par la règle est disponible pour les étapes suivantes de la même règle, ce qui vous permet de publier son lien sur Slack juste après sa création — ou de le commenter, ou de le clore, avec les actions ci-dessous.

Commenter un ticket, ou changer son statut

1. Ajoutez Comment on Linear issue ou Set Linear issue status comme étape de votre règle.
2. Indiquez de quel ticket il s'agit — donnez l'identifiant tel qu'il apparaît dans Linear (par exemple ENG-14), ou référez-vous au ticket créé par une étape précédente de la même règle (le sélecteur de valeurs précédentes le propose).
3. Pour un commentaire, rédigez le texte — utile comme second volet d'une règle qui ouvre des tickets : le moniteur se rétablit, et le ticket le précise.
4. Pour un changement de statut, saisissez le nom exactement tel qu'il apparaît sur le tableau de cette équipe (« In Progress », « Done »). Les statuts appartiennent à une équipe, et l'équipe provient du ticket lui-même, il n'y a donc pas de liste à choisir ici.

Dépannage

« Linear rejected the key » — la clé est incorrecte, expirée, ou a été créée sans accès Write. Créez-en une nouvelle et collez-la à nouveau.

La liste des équipes est vide. Choisissez d'abord une connexion, en haut de l'action. Si elle reste vide, la clé est probablement limitée à des équipes qu'elle ne peut pas voir — vérifiez ses restrictions d'équipe dans Linear.

La liste des statuts est vide. Les statuts appartiennent à une équipe, choisissez donc d'abord l'équipe. Si l'équipe provient du déclencheur plutôt que d'être sélectionnée, la liste reste vide — vous pouvez alors saisir le nom du statut, et l'automatisation le résoudra lors de son exécution.

La liste des projets est vide. Les projets appartiennent à des équipes — choisissez d'abord l'équipe, seuls les projets de cette équipe seront alors proposés.

Une automatisation a échoué avec « Linear rejected the request ». Ouvrez l'exécution dans Automatisations → Historique ; l'étape indique ce que Linear a répondu. La cause habituelle est une équipe que la clé ne peut pas atteindre, ou un nom de statut qui n'existe pas pour cette équipe.

« No Linear user matches… » — deux personnes peuvent partager le même nom affiché, donc l'automatisation se base d'abord sur l'adresse e-mail. Utilisez l'adresse pour être certain de la personne visée.