Połącz GitHub Issues: przewodnik krok po kroku
Tworzy jedno zgłoszenie GitHub dla każdego testu zakończonego niepowodzeniem, dodaje komentarz przy kolejnym niepowodzeniu i zamyka zgłoszenie, gdy test przejdzie bez problemów. GitHub nie przyjmuje przesyłanych plików, więc zamiast załączać zrzut ekranu, zgłoszenie wskazuje folder z dowodami. Ten przewodnik przeprowadzi Cię od zera do zweryfikowanego połączenia oraz opisze możliwe błędy, ich przyczyny i sposoby naprawy.
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
- Konto GitHub z uprawnieniami do tworzenia zgłoszeń w repozytorium (współpracownika lub właściciela).
- Repozytorium z włączoną funkcją zgłoszeń (ustawienia repozytorium → Funkcje → Zgłoszenia).
- Osobisty token dostępu z precyzyjnymi uprawnieniami Zgłoszenia → Odczyt i zapis dla tego repozytorium lub klasyczny token z zakresem repo.
Uzyskaj dane uwierzytelniające
- Otwórz https://github.com/settings/personal-access-tokens/new (token z precyzyjnymi uprawnieniami).
- Nadaj mu nazwę, ustaw termin ważności i w sekcji Dostęp do repozytoriów wybierz Tylko wybrane repozytoria, a następnie wskaż repozytorium, do którego mają trafiać zgłoszenia.
- W sekcji Uprawnienia → Uprawnienia do repozytorium ustaw Zgłoszenia na Odczyt i zapis. Nic więcej nie jest potrzebne.
- Wygeneruj token i od razu go skopiuj. GitHub wyświetla go tylko raz. Nie wklejaj go nigdzie poza Studio (następny krok).
Połącz w Studio
- W Studio otwórz Ustawienia → Integracje → Połącz GitHub Issues.
- Po wyświetleniu monitu wprowadź token i naciśnij Zapisz & sprawdź. Studio pokaże, do kogo należy token i do ilu repozytoriów ma dostęp.
- Wybierz repozytorium w polu "Zgłoszenia trafiają do". Lista zawiera tylko repozytoria dostępne dla tokenu i z włączoną funkcją zgłoszeń.
- Włącz
GITHUB_ISSUES_ENABLED.
Sprawdź, czy działa
- Opcja Sprawdź połączenie wyświetla "zalogowano jako <you>" oraz "<owner/repo> przyjmuje zgłoszenia". Sprawdzenie tylko odczytuje dane; nigdy nie tworzy zgłoszenia.
- Otwórz Ustawienia → Integracje → Zgłoszenia i naciśnij Utwórz zgłoszenie testowe przy docelowym repozytorium GitHub. Powstanie jedno zgłoszenie z etykietą nexus-test.
- Otwórz je w GitHub, sprawdź etykietę, a po zakończeniu zamknij lub usuń zgłoszenie.
Typowe błędy
| Co widzisz | Przyczyna | Rozwiązanie |
|---|---|---|
| "GitHub odrzucił token (401)" | Token jest nieprawidłowy, wygasł, został unieważniony lub nie został skopiowany w całości. | Utwórz nowy token z uprawnieniami Zgłoszenia → Odczyt i zapis i zapisz go ponownie. |
| HTTP 403 | Token nie ma uprawnienia do zgłoszeń, nie wybrano dla niego repozytorium lub wyczerpano limit żądań. | Edytuj token: ustaw Zgłoszenia na Odczyt i zapis i wybierz repozytorium. Jeśli przyczyną jest limit żądań, poczekaj kilka minut. |
| HTTP 404 | Repozytorium nie istnieje, zmieniło nazwę lub token nie ma do niego dostępu (prywatne repozytoria trzeba wybrać w ustawieniach tokenu z precyzyjnymi uprawnieniami). | Wybierz repozytorium z listy lub dodaj je do repozytoriów dostępnych dla tokenu. |
| HTTP 422 | GitHub odrzucił pole zgłoszenia, najczęściej przypisaną osobę, która nie jest współpracownikiem, albo niedozwolony tytuł lub etykietę. | Usuń przypisaną osobę w Ustawienia → Integracje → Zgłoszenia lub dodaj tę osobę jako współpracownika. |
| "<repo> ma wyłączoną funkcję zgłoszeń" | Funkcja zgłoszeń jest wyłączona w repozytorium. | W repozytorium włącz Ustawienia → Funkcje → Zgłoszenia lub wybierz inne repozytorium. |
| "nie udało się połączyć z GitHub (…)" lub "brak odpowiedzi w wyznaczonym czasie" | Ten komputer nie może połączyć się z api.github.com: przyczyną jest VPN, serwer proxy lub brak połączenia z siecią. | Otwórz github.com w przeglądarce na tym samym komputerze, a następnie ponownie sprawdź połączenie. |
| Wszystkie kontrole przebiegają pomyślnie, ale zgłoszenie się nie pojawia | GITHUB_ISSUES_ENABLED ma wartość false; lub wynik to FLAKY albo wynik związany ze środowiskiem; lub uruchomienie odbyło się w piaskownicy; lub test ma już otwarte zgłoszenie (kolejne niepowodzenie powoduje dodanie komentarza). | Włącz GITHUB_ISSUES_ENABLED i użyj opcji Utwórz zgłoszenie testowe, aby potwierdzić działanie połączenia. |
Klucze ustawień
| Klucz | Co robi | Prawidłowa wartość | Jak sprawdzić |
|---|---|---|---|
GITHUB_ISSUES_ENABLED | Twórz zgłoszenia w GitHub w przypadku niepowodzeń | true lub false | Włącz po pomyślnym sprawdzeniu za pomocą opcji Sprawdź połączenie, a następnie uruchom opcję Utwórz zgłoszenie próbne. |
GITHUB_ISSUES_TOKEN | Token dostępu GitHub (tajny, zapisywany tylko na tym komputerze) | Jeden wiersz, bez cudzysłowów, bez spacji | Sprawdź połączenie: "odrzucono token" oznacza, że jest on nieprawidłowy, wygasł lub został unieważniony. |
GITHUB_ISSUES_REPO | Repozytorium GitHub na zgłoszenia | właściciel/repozytorium, np. acme/web | Wybierz je z listy; Studio zapisuje tylko repozytorium, do którego token ma dostęp i w którym włączono zgłoszenia. |
Więcej: wszystkie integracje, przewodnik po ustawieniach, rozwiązywanie problemów. Inne przewodniki: Jira Cloud, Azure Boards, Slack, Microsoft Teams, Telegram.
Nadal masz problem? Napisz na [email protected] i podaj dokładny komunikat błędu wyświetlany w Studio. Nie dołączaj tokena.