Połącz z Jira Cloud: poradnik krok po kroku
Tworzy jedno zgłoszenie typu Bug dla każdego testu zakończonego niepowodzeniem, dodaje komentarz przy kolejnym niepowodzeniu i przenosi zgłoszenie do stanu Gotowe, gdy test przejdzie bez błędów. Ten poradnik prowadzi od zera do sprawdzonego połączenia i opisuje możliwe błędy wraz z ich przyczynami i rozwiązaniami.
Ostatnia aktualizacja:
Chroń swoje dane uwierzytelniające. Nigdy nie wklejaj tokenu, klucza, hasła ani adresu URL webhooka na czacie. Wprowadzaj je wyłącznie w Studio → Ustawienia → Integracje, gdzie są zapisywane w pliku .env obszaru roboczego i wyświetlane jako kropki. Dotyczy to również asystenta AI: może przeprowadzić Cię przez ten przewodnik, ale nigdy nie potrzebuje Twojego tokenu.
Czego potrzebujesz
- Witryna Jira Cloud, na przykład https://your-team.atlassian.net (tylko Jira Cloud; adres musi używać https).
- Adres e-mail konta Atlassian i token API utworzony przy użyciu tego samego konta.
- Klucz projektu, na przykład QA, w którym istnieje typ zgłoszenia o nazwie Bug.
- Uprawnienia tego konta w danym projekcie do przeglądania, tworzenia zgłoszeń, dodawania komentarzy, tworzenia załączników i zmiany stanów zgłoszeń.
Uzyskaj dane uwierzytelniające
- Otwórz https://id.atlassian.com/manage-profile/security/api-tokens i wybierz Utwórz token API.
- Nadaj mu nazwę (na przykład "Nexus StudioQA"), wybierz termin ważności, utwórz go i od razu skopiuj. Atlassian wyświetla go tylko raz.
- Zachowaj go w schowku. Nie wklejaj go nigdzie poza Studio (następny krok).
Połącz w Studio
- W Studio otwórz Ustawienia → Integracje → Połącz z Jira.
- Wklej dowolny link ze swojej witryny Jira (do strony głównej, tablicy lub zgłoszenia) i naciśnij Sprawdź połączenie. Studio zachowa adres witryny i klucz projektu.
- Gdy pojawi się prośba, wpisz adres e-mail konta Atlassian i token, a następnie naciśnij Zapisz & sprawdź.
- Wybierz projekt w polu "Błędy trafiają do", a następnie włącz
JIRA_ENABLED.
Sprawdź, czy działa
- Opcja Sprawdź połączenie wyświetla "Zalogowano jako <Twoje imię>" oraz "<KEY> przyjmuje zgłoszenia typu Bug". Sprawdzenie jedynie odczytuje dane; nigdy nie tworzy zgłoszenia.
- Otwórz Ustawienia → Integracje → Zgłoszenia i naciśnij Utwórz zgłoszenie testowe. Ta opcja tworzy jedno zgłoszenie z etykietą nexus-test i jako jedyna w tym miejscu wysyła żądanie do Jira.
- Otwórz to zgłoszenie w Jira i sprawdź, czy ma etykiety auto-generated, nexus-studioqa-automation i nexus-test. Usuń je po zakończeniu.
Typowe błędy
| Co widzisz | Przyczyna | Rozwiązanie |
|---|---|---|
| "To nie jest link" lub "Link do Jira zaczyna się od https://" | Wklejony tekst nie jest pełnym adresem internetowym lub zaczyna się od http://. | Skopiuj adres z paska adresu, gdy jesteś w swojej witrynie Jira. Musi zaczynać się od https://. |
| HTTP 401 | Adres e-mail lub token jest nieprawidłowy, token wygasł lub został unieważniony albo adres e-mail nie należy do konta, na którym utworzono token. | Utwórz nowy token na id.atlassian.com przy użyciu konta, którego adres e-mail zapisano, a następnie ponownie zapisz obie wartości w Ustawieniach. |
| HTTP 403 | Logowanie działa, ale Jira informuje, że konto nie może wykonać tej czynności: zazwyczaj brakuje uprawnienia do tworzenia zgłoszeń, dodawania komentarzy lub tworzenia załączników w projekcie. | Poproś administratora projektu o te uprawnienia lub wybierz inny projekt. Nexus StudioQA nie może ich nadać. |
| HTTP 404 | Adres witryny lub klucz projektu nie istnieje albo to konto nie ma dostępu do projektu (Jira zwraca kod 404 dla ukrywanych projektów). | Wklej dowolny link z właściwej witryny i wybierz projekt z listy. |
| "Ten adres odpowiedział, ale nie kontem Jira" | Adres nie prowadzi do witryny Jira Cloud (może to być na przykład adres wersji Server lub Data Center albo inna strona internetowa). | Użyj adresu https://<team>.atlassian.net swojej witryny Jira Cloud. |
| "<KEY> nie ma typu zgłoszenia o nazwie Bug" | Projekt nie ma typu zgłoszenia o nazwie Bug, więc nie można utworzyć zgłoszenia. | W Jira otwórz Ustawienia projektu → Typy zgłoszeń i dodaj Bug lub wybierz inny projekt. |
| "nie udało się połączyć z Jira (ENOTFOUND)" lub "brak odpowiedzi w ciągu 20 s" | Ten komputer nie może połączyć się z witryną: przyczyną jest literówka w adresie, VPN lub serwer proxy albo brak sieci. | Popraw adres, a następnie otwórz witrynę w przeglądarce na tym samym komputerze. Ponów sprawdzenie. |
| Weryfikacja przebiega pomyślnie, ale zgłoszenie się nie pojawia | JIRA_ENABLED ma wartość false; lub wynik to FLAKY albo wynik wskazujący na problem ze środowiskiem; lub było to uruchomienie w piaskownicy; lub dla tego testu istnieje już otwarte zgłoszenie Bug (kolejne niepowodzenie powoduje dodanie komentarza); lub w ciągu ostatnich 24 godzin utworzono zgłoszenie Bug o tym samym tytule. | Włącz JIRA_ENABLED, przeczytaj sekcję "Jedno zgłoszenie na test" na stronie integracji i użyj opcji Utwórz zgłoszenie testowe, aby potwierdzić połączenie. |
| Pomyślny test nie zamyka powiązanego zgłoszenia | Przepływ pracy nie ma przejścia o nazwie zgodnej z JIRA_DONE_TRANSITION, więc do zgłoszenia dodawany jest tylko komentarz. | Ustaw JIRA_DONE_TRANSITION na dokładną nazwę przycisku przejścia w swoim przepływie pracy. |
Klucze ustawień
| Klucz | Co robi | Prawidłowa wartość | Jak sprawdzić |
|---|---|---|---|
JIRA_ENABLED | Twórz zgłoszenia Jira dla niepowodzeń | true lub false | Włącz integrację, a następnie użyj opcji Utwórz zgłoszenie testowe. |
JIRA_BASE_URL | Adres witryny Jira | https://<site>.atlassian.net | Opcja Sprawdź połączenie wyświetla witrynę; wklejenie linku uzupełnia jej adres. |
JIRA_EMAIL | Adres e-mail do logowania w Jira | Adres e-mail konta Atlassian, do którego należy token | Opcja Sprawdź połączenie wyświetla "Zalogowano jako …" z tym adresem e-mail. |
JIRA_API_TOKEN | Token dostępu Jira (tajny, zapisany tylko na tym komputerze) | Jeden wiersz, bez cudzysłowów, bez spacji | Sprawdź połączenie: HTTP 401 oznacza nieprawidłową parę adres e-mail/token. |
JIRA_PROJECT_KEY | Projekt Jira dla zgłoszeń Bug | Klucz projektu, zwykle zapisany wielkimi literami, na przykład QA | Projekt jest widoczny na liście rozwijanej; komunikat "przyjmuje zgłoszenia Bug" potwierdza typ. |
JIRA_DONE_TRANSITION | Status Jira po pomyślnym zakończeniu testu | Dokładna nazwa przejścia w przepływie pracy, bez rozróżniania wielkości liter | Pomyślny wynik bez zastrzeżeń zmienia status zgłoszenia; jeśli przepływ pracy nie ma takiego przejścia, dodawany jest tylko komentarz. |
Więcej: wszystkie integracje, przewodnik po ustawieniach, rozwiązywanie problemów. Inne przewodniki: Azure Boards, Slack, Microsoft Teams, Telegram, GitHub Issues.
Nadal masz problem? Napisz na [email protected] i podaj dokładny komunikat błędu wyświetlany w Studio. Nie dołączaj tokena.