Połącz Azure Boards: przewodnik krok po kroku
Tworzy jeden element roboczy dla każdego testu zakończonego niepowodzeniem, dodaje do niego komentarz przy kolejnym niepowodzeniu i ustawia stan zakończenia, gdy test przejdzie bez błędów. Ten sam token służy też do publikowania wyników testów i dodawania potoków do kolejki. Ten przewodnik prowadzi od zera do zweryfikowanego połączenia oraz opisuje 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
- Organizacja w Azure DevOps Services: https://dev.azure.com/<organization> lub https://<organization>.visualstudio.com (Azure DevOps Server na własnych maszynach nie jest obsługiwany).
- Nazwa projektu, do którego będą trafiać elementy robocze.
- Osobisty token dostępu (PAT) z uprawnieniami Elementy robocze → Odczyt i zapis oraz Kompilacja → Odczyt i wykonywanie, jeśli korzystasz też z funkcji Uruchom w CI.
- Znajomość procesu projektu, ponieważ określa on typ elementu roboczego: Basic zawiera Issue, Epic i Task (bez Bug); Agile, Scrum i CMMI zawierają Bug.
Uzyskaj dane uwierzytelniające
- Otwórz dev.azure.com, a następnie Ustawienia użytkownika → Osobiste tokeny dostępu → Nowy token.
- Wybierz organizację, ustaw termin ważności i w sekcji Zakresy wybierz Zdefiniowane niestandardowo.
- Zaznacz Elementy robocze → Odczyt i zapis (dodaj Kompilacja → Odczyt i wykonywanie dla funkcji Uruchom w CI), utwórz token i od razu go skopiuj. Jest wyświetlany 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 Azure DevOps.
- Wklej dowolny link z Azure DevOps (do tablicy, elementu roboczego lub strony projektu) i naciśnij Sprawdź połączenie. Studio zachowa organizację i projekt.
- Gdy pojawi się prośba, wprowadź PAT i naciśnij Zapisz i sprawdź. Wybierz projekt w polu "Elementy robocze trafiają do".
- Jeśli sprawdzenie wykaże, że projekt nie ma typu elementu roboczego o nazwie Bug, ustaw
AZURE_BOARDS_WORK_ITEM_TYPEna jeden z wymienionych typów (w projekcie Basic: Issue), aAZURE_BOARDS_DONE_STATEna stan dostępny w tym procesie (Basic: Done). - Włącz
AZURE_BOARDS_ENABLED.
Sprawdź, czy działa
- Funkcja Sprawdź połączenie wyświetla "Token ma dostęp do N projektów" oraz "<project> przyjmuje elementy robocze typu <type>". Sprawdzenie jedynie odczytuje dane; nigdy nie tworzy elementu roboczego.
- Otwórz Ustawienia → Integracje → Zgłoszenia i naciśnij Utwórz zgłoszenie testowe. Spowoduje to utworzenie jednego elementu roboczego z tagiem nexus-test i załączonym zrzutem ekranu.
- Otwórz go w Azure Boards, sprawdź tag i załącznik, a po zakończeniu usuń go.
Typowe błędy
| Co widzisz | Przyczyna | Rozwiązanie |
|---|---|---|
| "Azure DevOps odrzucił token" (HTTP 203 lub 401) | PAT jest nieprawidłowy, wygasł, został unieważniony, skopiowany nie w całości lub utworzony w innej organizacji. | Utwórz nowy PAT w organizacji wskazanej przez AZURE_DEVOPS_ORG_URL z uprawnieniami Elementy robocze → Odczyt i zapis, a następnie zapisz go ponownie. |
| HTTP 403 | PAT jest prawidłowy, ale brakuje mu zakresu uprawnień lub Twoje konto nie ma uprawnień w tym projekcie. | Edytuj zakresy uprawnień PAT (Elementy robocze → Odczyt i zapis; Kompilacja → Odczyt i wykonywanie dla funkcji Uruchom w CI) lub poproś administratora projektu o dostęp. |
| HTTP 404 | Organizacja lub projekt o podanej nazwie nie istnieje albo nazwa projektu została zmieniona. | Wklej link z właściwego projektu i wybierz go z listy. |
| VS402323 "Typ elementu roboczego Bug nie istnieje" | Proces projektu nie ma typu elementu roboczego o tej nazwie. Projekt Basic zawiera Issue, Epic i Task, ale nie Bug. | Ustaw AZURE_BOARDS_WORK_ITEM_TYPE na typ wymieniony w wynikach sprawdzenia (Basic: Issue), a AZURE_BOARDS_DONE_STATE na jeden z jego stanów (Basic: Done), a następnie ponownie naciśnij Sprawdź połączenie. |
| "<project> nie ma typu elementu roboczego o nazwie …" | Ta sama przyczyna co w przypadku VS402323, wykryta przez opcję Sprawdź połączenie przed utworzeniem zgłoszenia. | Ustaw AZURE_BOARDS_WORK_ITEM_TYPE na jeden z typów wymienionych w tym komunikacie lub wybierz inny projekt. |
| "To nie jest link do Azure DevOps" | Adres nie jest w domenie dev.azure.com/<organization> ani <organization>.visualstudio.com lub zaczyna się od http://. | Skopiuj adres z paska adresu w Azure DevOps Services. Azure DevOps Server nie jest obsługiwany. |
| "nie udało się połączyć z Azure DevOps (…)" lub "brak odpowiedzi w ciągu 20 s" | Ten komputer nie może połączyć się z Azure DevOps: przyczyną jest VPN, serwer proxy lub brak sieci. | Otwórz dev.azure.com w przeglądarce na tym samym komputerze, a następnie ponownie sprawdź połączenie. |
| Pomyślny wynik testu nie ustawia stanu ukończenia | Proces odrzuca AZURE_BOARDS_DONE_STATE dla tego typu, więc do elementu dodawany jest tylko komentarz. | Ustaw AZURE_BOARDS_DONE_STATE na stan tego typu (Basic: Done; błąd w Agile: Resolved). |
| Wszystkie kontrole przebiegają pomyślnie, ale element roboczy się nie pojawia | AZURE_BOARDS_ENABLED ma wartość false; lub wynik to FLAKY albo wskazuje na problem ze środowiskiem; lub było to uruchomienie w środowisku izolowanym; lub test ma już otwarty element roboczy (kolejne niepowodzenie powoduje dodanie komentarza). | Włącz AZURE_BOARDS_ENABLED i użyj opcji Utwórz zgłoszenie próbne, aby potwierdzić działanie połączenia. |
Klucze ustawień
| Klucz | Co robi | Prawidłowa wartość | Jak sprawdzić |
|---|---|---|---|
AZURE_BOARDS_ENABLED | Twórz elementy robocze w Azure dla 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. |
AZURE_DEVOPS_ORG_URL | Adres organizacji w Azure DevOps | https://dev.azure.com/<organization> lub https://<organization>.visualstudio.com | Opcja Sprawdź połączenie pokazuje organizację; wklejenie linku uzupełnia jej adres. |
AZURE_DEVOPS_PROJECT | Nazwa projektu w Azure DevOps | Nazwa projektu dokładnie w takiej postaci, w jakiej wyświetla ją Azure DevOps | Opcja Sprawdź połączenie wyświetla projekty dostępne dla tokenu. |
AZURE_DEVOPS_PAT | Token dostępu do Azure DevOps (tajny, zapisywany tylko na tym komputerze) | Jeden wiersz, bez cudzysłowów, bez spacji | Sprawdź połączenie: "token odrzucony" oznacza, że jest nieprawidłowy, wygasł lub pochodzi z innej organizacji. |
AZURE_BOARDS_WORK_ITEM_TYPE | Typ zgłoszenia w Azure dla niepowodzeń | Typ dostępny w procesie projektu: Bug (Agile, Scrum, CMMI) lub Issue (Basic) | Opcja Sprawdź połączenie wyświetla komunikat "<project> obsługuje elementy robocze typu <type>" lub listę typów dostępnych w projekcie. |
AZURE_BOARDS_DONE_STATE | Stan w Azure po pomyślnym teście | Stan danego typu elementu roboczego: Resolved (błąd w Agile), Done (problem w Basic) | Pomyślny wynik bez zastrzeżeń zmienia stan elementu; jeśli proces odrzuca ten stan, dodawany jest tylko komentarz. |
AZURE_PIPELINE_ID | Potok Azure do uruchomienia w CI | Liczbowy identyfikator potoku Azure (tylko dla opcji Uruchom w CI) | nexus ci-remote --provider=azure dodaje ten potok do kolejki; wymaga uprawnienia Kompilacja → Odczyt i wykonywanie. |
Więcej: wszystkie integracje, przewodnik po ustawieniach, rozwiązywanie problemów. Inne przewodniki: Jira Cloud, 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.