Connecter Jira

Connectez Jira pour que vos automatisations puissent créer, mettre à jour et lier des tickets automatiquement — par exemple lorsqu'un certificat est sur le point d'expirer, qu'un moniteur tombe en panne, ou qu'un domaine doit être renouvelé. Cet article s'adresse à toute personne configurant ou dépannant la connexion Jira dans InfraNest.

Vue d'ensemble

• Les automatisations peuvent créer des tickets Jira, les commenter, changer leur statut et les relier au certificat, au moniteur ou au domaine concerné.
• Plus besoin de recopier les détails à la main — le ticket arrive déjà rempli.
• Fonctionne avec Jira Cloud (une adresse something.atlassian.net). Jira Data Center et Server ne sont pas pris en charge.

Connecter votre site

1. Allez dans Paramètres → Intégrations et trouvez Jira.
2. Cliquez sur Connect with Jira.
3. Approuvez l'accès lorsque Atlassian le demande. Vous revenez dans InfraNest déjà connecté — rien à copier.
4. Si vous avez plusieurs sites Atlassian, choisissez celui à utiliser. Si vous n'en avez qu'un, InfraNest le sélectionne automatiquement pour vous.

NoteSi Connect with Jira est grisé, votre administrateur InfraNest n'a pas encore enregistré d'application Jira. Utilisez plutôt un jeton API — cela fonctionne de la même manière une fois connecté.

Se connecter avec un jeton API

1. Dans Atlassian, ouvrez Account settings → Security → API tokens et créez un jeton.
2. Copiez-le — Atlassian ne l'affiche qu'une seule fois.
3. Dans InfraNest, allez dans Paramètres → Intégrations → Jira et remplissez trois champs :
   • Jira URL — par exemple acme.atlassian.net. Coller l'adresse complète de n'importe quelle page Jira fonctionne aussi.
   • Atlassian account email — l'adresse avec laquelle vous vous connectez.
   • API token — celui que vous venez de copier.
4. InfraNest vérifie immédiatement la connexion et indique à quel compte elle appartient, afin que vous puissiez confirmer que vous avez connecté le bon.

TipUtilisez l'adresse e-mail avec laquelle vous vous connectez. Une adresse différente sur le même site est refusée, et l'erreur ressemble alors à un jeton invalide plutôt qu'à un mauvais e-mail.

Le jeton agit en votre nom, il ne peut donc créer des tickets que dans les projets que vous pouvez déjà voir. Il vous est aussi personnellement lié — si vous quittez l'organisation, il cesse de fonctionner. Pour une connexion sur laquelle toute l'équipe s'appuie, le jeton d'un administrateur ou l'option en un clic Connect with Jira est le choix le plus sûr.

Créer un ticket depuis une automatisation

1. Créez une règle comme d'habitude et choisissez Create Jira issue comme action.
2. Renseignez Project — commencez à taper et choisissez parmi vos projets, ou saisissez une clé de projet comme OPS.
3. Choisissez Issue type — Task, Bug, ou tout autre type utilisé par votre projet. Les types de sous-tâches ne sont pas proposés, car ils nécessitent un ticket parent.
4. Renseignez Summary 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.
5. Définissez éventuellement Assignee — commencez à taper un nom ou une adresse e-mail. Seules les personnes réellement assignables à ce projet sont proposées.
6. Définissez éventuellement Priority et Labels — les labels ne peuvent pas contenir d'espaces ; utilisez un trait d'union à la place.

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, le déplacer ou le lier, à l'aide des actions ci-dessous.

Commenter, changer le statut ou relier

Trois autres actions agissent sur un ticket déjà existant. Toutes demandent quel ticket : indiquez la clé que vous voyez dans Jira (OPS-14), ou référencez le ticket créé par une étape précédente de la même règle — le sélecteur de valeurs précédentes le propose.

1. Comment on Jira issue — ajoute un commentaire. Utile comme pendant d'une règle qui crée des tickets : le moniteur se rétablit, et le ticket l'indique.
2. Set Jira issue status — déplace le ticket, ce qui permet à une règle ayant ouvert un travail de le clôturer aussi. Saisissez le statut souhaité (« Done »), ou le nom que votre workflow donne à cette transition (« Close Issue ») — les deux fonctionnent.
3. Add Jira issue link — ajoute un lien dans le panneau Links du ticket pointant vers le certificat, le moniteur ou le domaine concerné. Réexécuter la règle met à jour ce lien plutôt que d'en ajouter un second.

Dépannage

« Jira rejected the token » — vérifiez les trois champs, pas seulement le jeton. La cause la plus fréquente est une adresse e-mail différente de celle utilisée pour se connecter à Atlassian.

« Your Atlassian account cannot use the Jira API » — le jeton est valide, mais le compte n'est pas autorisé à utiliser l'API sur ce site. Votre administrateur Jira peut modifier cela.

« This Jira connection has no site selected yet » — vous avez autorisé plusieurs sites Atlassian sans en choisir un. Ouvrez la connexion dans Paramètres → Intégrations et sélectionnez-le.

La liste des projets est vide. Choisissez d'abord une connexion, en haut de l'action. Si elle reste vide, le compte ne peut peut-être voir aucun projet.

La liste des types de tickets ou des assignés est vide. Les deux dépendent d'un projet, choisissez donc d'abord le projet. Si le projet provient du déclencheur plutôt que d'être choisi, les listes restent vides et vous pouvez saisir les valeurs manuellement — l'automatisation les résout à l'exécution.

Une automatisation a échoué en indiquant qu'un champ est obligatoire. Certains projets rendent des champs supplémentaires obligatoires sur leur écran de création, alors que l'action Jira d'InfraNest propose un ensemble fixe. L'échec nomme le champ demandé par Jira — ouvrez l'exécution dans Automatisations → History pour le voir. Rendez ce champ optionnel dans Jira, ou créez le ticket dans un projet qui ne l'exige pas.

« Jira offers no transitions on OPS-14 right now. » Jira n'autorise que les transitions permises par son workflow depuis le statut actuel du ticket. Un ticket déjà Done ne peut pas être déplacé vers Done. Le message liste ce que le ticket peut faire — choisissez parmi ces options.

« No transition named … is available. » Votre workflow nomme cette transition différemment. Le message liste les options disponibles ; utilisez celle qui mène au statut souhaité.