Uruchomienie i konfiguracja - Jira Cloud

Co robi ta integracja

Integracja z Jira Cloud pozwala utworzyć zadanie typu Bug bezpośrednio ze szczegółów błędu w DockRay, bez ręcznego przepisywania komunikatu, stosu wywołań czy adresu żądania. Utworzenie zadania zapisuje trwałe powiązanie: jeden błąd DockRay ↔ jedno zadanie Jira. Gdy to zadanie osiągnie w Jirze kategorię statusu Done, DockRay sam oznacza błąd jako rozwiązany - odczyt statusu jest okresowy, nie w czasie rzeczywistym: komenda thor:sync-jira sprawdza powiązane zadania co pięć minut.

Czego potrzebujesz po stronie Jiry

• instancji Jira Cloud w domenie *.atlassian.net - integracja przyjmuje wyłącznie publiczne adresy HTTPS w tej domenie,
• adresu e-mail konta Atlassian, które będzie działać w imieniu integracji,
• tokenu API wygenerowanego dla tego konta (ustawienia konta Atlassian → Bezpieczeństwo → Tokeny API),
• projektu Jira, do którego mają trafiać zadania - integracja mapuje się na projekt, nie na tablicę, bo tablica jest tylko widokiem na projekt.

Połączenie na poziomie konta

W panelu DockRay przejdź do Ustawienia → Jira i podaj adres instancji, adres e-mail konta Atlassian oraz token API. To połączenie jest wspólne dla wszystkich projektów konta, które nie mają skonfigurowanych własnych poświadczeń - pojedynczy projekt może je później nadpisać.

Konfiguracja dla konkretnego projektu

W Ustawienia projektu → Jira wybierz projekt Jira, do którego mają trafiać zadania, domyślną osobę przypisaną oraz opcjonalny status początkowy. Projekt DockRay może korzystać z poświadczeń całego konta albo dostać własne - przydatne, gdy różne zespoły w firmie mają osobne instancje Jiry albo osobne konta serwisowe.

Co trafia do treści zadania

Opis zadania to dokument w formacie Atlassian Document Format: cytat z typem i komunikatem błędu, lista faktów (projekt, środowisko, żądanie, liczba wystąpień, pierwsze i ostatnie wystąpienie w danym dniu, wtyczka klienta), miejsce awarii z kilkoma wierszami kodu wokół wywróconej linii, skrócony stos wywołań i odnośnik do panelu DockRay. To, co świadomie pomijamy w tym opisie, opisuje kolejny artykuł.

Pierwszy test

Otwórz dowolny istniejący błąd w projekcie i utwórz z niego zadanie Jira. Sprawdź w Jirze, że zadanie powstało w oczekiwanym projekcie, z opisem zawierającym komunikat błędu, miejsce awarii i link do panelu DockRay. Przy błędzie w DockRay powinien pojawić się odnośnik do utworzonego zadania - to widoczny dowód zapisanego powiązania.