Jira koppelen

Koppel Jira zodat je automatiseringen automatisch tickets kunnen aanmaken, bijwerken en koppelen — bijvoorbeeld wanneer een certificaat bijna verloopt, een monitor uitvalt, of een domein binnenkort verlengd moet worden. Dit artikel is bedoeld voor iedereen die de Jira-koppeling in InfraNest instelt of problemen ermee oplost.

Overzicht

• Automatiseringen kunnen Jira-tickets aanmaken, erop reageren met een reactie, hun status wijzigen en ze terugkoppelen aan het certificaat, de monitor of het domein waar het om gaat.
• Geen handmatig kopiëren van gegevens meer — het ticket komt al ingevuld binnen.
• Werkt met Jira Cloud (een something.atlassian.net-adres). Jira Data Center en Server worden niet ondersteund.

Je site koppelen

1. Ga naar Instellingen → Integraties en zoek Jira.
2. Klik op Connect with Jira.
3. Keur de toegang goed wanneer Atlassian daarom vraagt. Je komt terug in InfraNest, al verbonden — niets om te kopiëren.
4. Heb je meer dan één Atlassian-site, kies dan welke je wilt gebruiken. Heb je er precies één, dan kiest InfraNest deze automatisch voor je.

NoteAls Connect with Jira grijs is, heeft je InfraNest-beheerder nog geen Jira-app geregistreerd. Gebruik in dat geval een API-token — dat werkt op dezelfde manier zodra het gekoppeld is.

Koppelen met een API-token

1. Open in Atlassian Account settings → Security → API tokens en maak een token aan.
2. Kopieer het — Atlassian toont het maar één keer.
3. Ga in InfraNest naar Instellingen → Integraties → Jira en vul drie velden in:
   • Jira URL — bijvoorbeeld acme.atlassian.net. Het volledige adres van een willekeurige Jira-pagina plakken werkt ook.
   • Atlassian account email — het adres waarmee je inlogt.
   • API token — het token dat je net hebt gekopieerd.
4. InfraNest controleert de verbinding meteen en toont van wie het account is, zodat je kunt bevestigen dat je de juiste hebt gekoppeld.

TipGebruik het e-mailadres waarmee je inlogt. Een ander adres op dezelfde site wordt geweigerd, en de foutmelding lijkt dan op een ongeldig token in plaats van een verkeerd e-mailadres.

Het token handelt namens jou, dus het kan alleen tickets aanmaken in projecten die je al kunt zien. Het is ook persoonlijk aan jou gekoppeld — verlaat je de organisatie, dan stopt het met werken. Voor een verbinding waar het hele team op vertrouwt, is een token van een beheerder of de optie Connect with Jira met één klik de veiligere keuze.

Een ticket aanmaken vanuit een automatisering

1. Bouw een regel zoals gebruikelijk en kies Create Jira issue als actie.
2. Vul Project in — begin te typen en kies uit je projecten, of typ een projectsleutel zoals OPS.
3. Kies Issue type — Task, Bug, of wat je project verder gebruikt. Subtaaktypen worden niet aangeboden, omdat ze een bovenliggend ticket nodig hebben.
4. Vul Summary en Description in — platte tekst, en je kunt waarden invoegen uit wat de regel activeerde, zodat het ticket meteen de domeinnaam of monitor bevat.
5. Stel eventueel Assignee in — begin een naam of e-mailadres te typen. Alleen mensen die daadwerkelijk aan dat project kunnen worden toegewezen, worden getoond.
6. Stel eventueel Priority en Labels in — labels mogen geen spaties bevatten; gebruik in plaats daarvan een koppelteken.

Het ticket dat de regel aanmaakt, is beschikbaar voor latere stappen in dezelfde regel, zodat je de link ernaar direct na aanmaken naar Slack kunt sturen — of erop kunt reageren, het kunt verplaatsen of eraan kunt koppelen, met de acties hieronder.

Reageren, de status wijzigen of terugkoppelen

Drie andere acties werken op een ticket dat al bestaat. Ze vragen allemaal welk ticket: geef de sleutel op die je in Jira ziet (OPS-14), of verwijs naar het ticket dat een eerdere stap in dezelfde regel heeft aangemaakt — de kiezer van eerdere waarden biedt dit aan.

1. Comment on Jira issue — voegt een reactie toe. Handig als tegenhanger van een regel die tickets aanmaakt: de monitor herstelt, en het ticket vermeldt dit.
2. Set Jira issue status — verplaatst het ticket, zodat een regel die werk opende dit ook kan afronden. Typ de status waarin het moet eindigen (“Done”), of de naam die je workflow aan die stap geeft (“Close Issue”) — beide werken.
3. Add Jira issue link — plaatst een link in het Links-paneel van het ticket die terugverwijst naar het certificaat, de monitor of het domein waar het over gaat. De regel opnieuw uitvoeren werkt die link bij in plaats van een tweede toe te voegen.

Problemen oplossen

“Jira rejected the token” — controleer alle drie de velden, niet alleen het token. De meest voorkomende oorzaak is een e-mailadres dat niet overeenkomt met waarmee je inlogt bij Atlassian.

“Your Atlassian account cannot use the Jira API” — het token is geldig, maar het account mag de API op die site niet gebruiken. Je Jira-beheerder kan dit wijzigen.

“This Jira connection has no site selected yet” — je hebt meer dan één Atlassian-site geautoriseerd en er nog geen gekozen. Open de koppeling in Instellingen → Integraties en kies er een.

De projectenlijst is leeg. Kies eerst een verbinding, bovenaan de actie. Blijft de lijst leeg, dan kan het account mogelijk geen projecten zien.

De lijst met issue-types of assignees is leeg. Beide horen bij een project, kies dus eerst het project. Komt het project uit de trigger in plaats van dat je het kiest, dan blijven de lijsten leeg en kun je de waarden zelf typen — de automatisering zoekt ze uit tijdens de uitvoering.

Een automatisering mislukte met de melding dat een veld verplicht is. Sommige projecten maken extra velden verplicht op hun aanmaakscherm, terwijl InfraNest's Jira-actie een vaste set velden aanbiedt. De foutmelding noemt het veld dat Jira wilde — open de uitvoering in Automatiseringen → History om dit te zien. Maak dat veld optioneel in Jira, of maak het ticket aan in een project dat het niet vereist.

“Jira offers no transitions on OPS-14 right now.” Jira staat alleen de bewegingen toe die de workflow vanuit de huidige status van het ticket toelaat. Een ticket dat al Done is, kan niet naar Done worden verplaatst. Het bericht vermeldt wat het ticket wel kan — kies daaruit.

“No transition named … is available.” Je workflow noemt die stap anders. Het bericht vermeldt de beschikbare opties; gebruik degene die naar de gewenste status leidt.