Łączenie commitów GitHub, pull requestów, gałęzi i problemów z elementami roboczymi w Azure Boards

Usługi Azure DevOps | Azure DevOps Server | Azure DevOps Server 2022

W tym artykule dowiesz się, jak połączyć elementy robocze z zatwierdzeniami GitHub, żądaniami ściągnięcia, gałęziami i kompilacjami po połączeniu projektu Azure Boards z repozytorium GitHub. Użyj składni #mention dla commitów i gałęzi, użyj wzmianek !, aby odwoływać się do pull requestów GitHub w dyskusjach elementów roboczych, lub dodaj bezpośrednio z elementu roboczego w Azure Boards link do commitu, pull requestu lub gałęzi w serwisie GitHub.

Prerequisites

Użyj AB#, aby połączyć GitHub z elementami roboczymi Azure Boards.

Użyj wzmianek AB# w tekście GitHub, aby tworzyć linki do elementów roboczych Azure Boards.

Aby utworzyć link:

1. Dodaj AB#{ID} do komunikatu zatwierdzenia, opisu żądania ściągnięcia lub opisu problemu.
2. Wypchnij commit lub zapisz pull request albo zgłoszenie.
3. Otwórz element roboczy, aby potwierdzić, że link zostanie wyświetlony w sekcji Programowanie .

Użycie AB#ID w komentarzu lub w tytule żądania pull request nie tworzy linku do elementu roboczego.

AB#{ID}

Na przykład AB#125 linkuje do elementu roboczego o identyfikatorze 125.

Możesz również przenieść elementy robocze z tekstu zatwierdzenia lub żądania ściągnięcia. Azure Boards rozpoznaje {state} lub {state category} oraz słowa kluczowe, takie jak fix, fixes i fixed, a następnie stosuje takie przejście do następującego po nim odwołania AB#.

Gdy opis żądania ściągnięcia zawiera prawidłową nazwę stanu, na przykład Closed AB#1234, system aktualizuje przywołyny element roboczy do tego określonego stanu. Jeśli nazwa stanu nie jest rozpoznawana bezpośrednio, Azure Boards próbuje dopasować ją do kategorii przepływu pracy, takiej jak Resolved lub Completed. W przypadku znalezienia dopasowania element roboczy przechodzi do pierwszego dostępnego stanu zdefiniowanego w tej kategorii.

Domyślnie elementy robocze, do których odwołują się fix, fixes lub fixed, przechodzą do pierwszego stanu skojarzonego z kategorią Rozwiązane. Jeśli taki stan nie istnieje w bieżącym procesie, system zamiast tego przenosi element roboczy do pierwszego stanu w kategorii Ukończono .

Aby uzyskać więcej informacji, zobacz Jak stany kategorii przepływu pracy są używane w listach prac i tablicach Azure Boards.

Skorzystaj z następujących przykładów składających się wyłącznie z linków:

Skorzystaj z następujących przykładów linków i przejść:

Po dodaniu linku do elementu roboczego przy użyciu AB# w opisie żądania ściągnięcia te linki są wyświetlane w Development sekcji żądania ściągnięcia GitHub. Te linki są dostępne tylko w przypadku użycia AB# w opisie żądania ściągnięcia. Nie są wyświetlane, jeśli odwołujesz się do pull request bezpośrednio od elementu roboczego. AB# Usunięcie odwołania z opisu spowoduje również usunięcie go z sekcji Programowanie.

Tworzenie gałęzi GitHub na podstawie elementu roboczego

Aby utworzyć gałąź GitHub bezpośrednio z poziomu elementu roboczego, wykonaj następujące kroki:

1. Na tablicy znajdź element roboczy, którego chcesz użyć do utworzenia gałęzi GitHub.

2. Wybierz pozycję Działania elementów roboczych>Nowa gałąź GitHub.

   

3. W oknie dialogowym Utwórz gałąź GitHub wprowadź nazwę gałęzi. Wybierz repozytorium GitHub i gałąź podstawową.

4. Wybierz Utwórz.

   

   Azure Boards tworzy gałąź w określonym repozytorium GitHub i łączy ją z elementem roboczym. Aby uzyskać więcej informacji, zobacz Azure Boards-GitHub integration.

Dodawanie linku elementu roboczego do gałęzi GitHub, zatwierdzenia lub żądania ściągnięcia

1. Otwórz element roboczy i przejdź do obszaru Programowanie .

2. Wybierz pozycję Dodaj link. Z każdego menu rozwijanego wybierz typ łącza, repozytorium GitHub i żądanie pull request GitHub. Możesz wyszukiwać i przechodzić do szczegółów w repozytorium, aby znaleźć i wybrać określone żądanie ściągnięcia lub zatwierdzenie bez konieczności kopiowania i wklejania adresu URL.

3. Wybierz pozycję Dodaj link.

   

   Azure Boards sprawdza, czy wprowadzono prawidłowy link. Repozytorium GitHub musi być połączone z projektem Azure Boards, lub walidacja kończy się niepowodzeniem.

Aktualizacje linków automatycznych

Kilka zdarzeń automatycznie aktualizuje łącza w formularzu elementu roboczego, więc nie trzeba ich tworzyć ręcznie. Te zdarzenia obejmują:

Wyświetlanie lub otwieranie linków z sekcji Programowanie

Sekcja Rozwój w formularzu elementu roboczego zawiera linki do zatwierdzeń GitHub i żądań ściągnięcia utworzone przy użyciu ikony GitHub.

Wybierz link, aby otworzyć zatwierdzenie lub pull request na GitHubie.

Wgląd w pull requesty na GitHubie

Powiązane pull requesty GitHub w sekcji Development pokazują dodatkowe szczegóły statusu. Postęp można ocenić bez otwierania pull requestu w serwisie GitHub.

Wymagania wstępne dotyczące szczegółowych informacji o żądaniach ściągnięcia

Aby wyświetlić szczegółowe informacje o żądaniach ściągnięcia, przejdź do aplikacji Azure Boards w GitHub i zaakceptuj zaktualizowane uprawnienia umożliwiające odczyt i zapis do Checks.

Wyświetl szczegóły stanu pull request

1. Otwórz element roboczy, który ma powiązany pull request GitHub.

2. W sekcji Rozwój znajdź powiązane żądanie dodania. Następujące szczegóły stanu są wyświetlane obok linku żądania ściągnięcia:

   • Stan wersji roboczej: pokazuje, czy żądanie ściągnięcia jest nadal wersją roboczą.
   • Stan przeglądu: pokazuje, czy żądanie ściągnięcia wymaga przeglądu, jest zatwierdzone, czy ma żądane zmiany.
   • Status kontroli: pokazuje, czy kontrole CI przechodzą, kończą się niepowodzeniem, czy są w trakcie.

   

3. Umieść kursor na wskaźniku stanu, aby wyświetlić więcej szczegółów, lub wybierz link żądania ściągnięcia, aby otworzyć go bezpośrednio w GitHub.

Podaj GitHub żądania ściągnięcia przy użyciu !

Użyj ! wzmianki, aby odwołać się do żądań przeciągnięcia na GitHubie bezpośrednio z dowolnego pola z sformatowanym tekstem elementu roboczego lub komentarza w dyskusji. Podczas wpisywania ! w polu tekstowym zostanie wyświetlony selektor, którego można użyć do wyszukiwania i wybrania GitHub żądania ściągnięcia z połączonego repozytorium. Wybrane żądanie ściągnięcia jest wstawione jako link do kliknięcia.

Ta funkcja ułatwia odwoływania się do powiązanych żądań ściągnięcia w opisach elementów roboczych, kryteriach akceptacji lub wątkach dyskusji bez ręcznego kopiowania adresów URL.

Wyświetlanie stanu kompilacji dla potoków YAML (zintegrowane w kompilacji)

Jeśli używasz Azure Pipelines YAML do kompilowania kodu hostowanego w repozytorium GitHub, możesz automatycznie tworzyć Zintegrowane w kompilacji łącza do skojarzonych elementów roboczych. Ta funkcja zapewnia możliwość śledzenia kompilacji dla repozytoriów GitHub, oferując podobne doświadczenie jak to dostępne dla Azure Repos.

Aby włączyć tę funkcję:

1. Otwórz potok YAML, wybierz pozycję Więcej akcji, a następnie wybierz pozycję Ustawienia.

2. W oknie dialogowym Ustawienia potoku włącz opcję Automatycznie połącz nowe elementy robocze w tej kompilacji.

   

Po zakończeniu kompilacji link Zintegrowany w kompilacji zostanie automatycznie wyświetlony w sekcji Rozwój każdego skojarzonego elementu roboczego, co daje zespołowi pełną możliwość śledzenia z elementu roboczego do kompilacji.

Aby uzyskać więcej informacji na temat konfigurowania tego ustawienia, zobacz Konfigurowanie potoków do obsługi śledzenia pracy.

Wyświetlanie obiektów GitHub na tablicy

Po włączeniu na tablicy adnotacji GitHub możesz szybko otwierać powiązane commity, pull requesty lub zgłoszenia, aby uzyskać więcej szczegółów. Aby uzyskać więcej informacji, zobacz Dostosowywanie kart.

Użyj AI do łączenia pracy w serwisie GitHub i zarządzania nią

Jeśli skonfigurujesz serwer Azure DevOps MCP, możesz opisywać w języku naturalnym zadania dotyczące łączenia GitHub z elementami roboczymi zamiast ręcznie przechodzić przez formularz elementu roboczego.

Użyj tych monitów jako przykładów scenariuszy. Obsługiwane operacje różnią się w zależności od skonfigurowanych zestawów narzędzi, wersji rozszerzenia i uprawnień.

Niektóre polecenia mogą zwracać instrukcje zamiast wykonywać operację zapisu albo mogą wymagać kilku poleceń, w zależności od tego, które narzędzia MCP włączono.

Przed uruchomieniem monitu zastąp symbole zastępcze, takie jak <Contoso>, <owner/repo>i <sha> rzeczywistymi wartościami.

Skorzystaj z tego szybkiego procesu uruchamiania i weryfikacji:

1. Uruchom jeden prompt z tabeli.
2. Przejrzyj odpowiedź na akcję podjętą.
3. Otwórz element roboczy i potwierdź wynik w sekcji Programowanie .
4. Otwórz powiązany artefakt GitHub i potwierdź oczekiwany link lub aktualizację.

Najpierw wypróbuj te polecenia:

• Link work item AB#125 in project <Contoso> to GitHub pull request <owner/repo>#42
• Link work item AB#312 in project <Contoso> to GitHub commit <owner/repo>@<sha>
• Summarize all GitHub commits and pull requests linked to work item AB#312 in project <Contoso>

Rozwiązywanie problemów z łączeniem wspomaganym przez sztuczną inteligencję

• Jeśli monit nie zostanie uruchomiony, upewnij się, że tryb agenta jest włączony w kliencie sztucznej inteligencji.
• Jeśli monit zakończy się niepowodzeniem z błędami dostępu, sprawdź, czy Twoje konto ma dostęp do projektu Azure DevOps i repozytorium GitHub.
• Jeśli łącza nie są tworzone, zastąp wszystkie symbole zastępcze (na przykład <Contoso>, , <owner/repo><sha>) rzeczywistymi wartościami i ponownie uruchom monit.
• Jeśli polecenie zbiorcze się nie powiedzie, najpierw spróbuj ponownie, używając pojedynczego elementu roboczego, a następnie ponów próbę z mniejszą partią.
• Jeśli wyniki nadal nie są zgodne z oczekiwaniami, zweryfikuj wynik w sekcji elementu roboczego Development oraz w powiązanym artefakcie GitHub.

Następny krok

Treści powiązane

• Zintegruj Azure Boards z GitHub
• Konfigurowanie potoków do wspierania śledzenia pracy
• Zrozum, jak stany kategorii przepływu pracy są używane w listach prac i tablicach Azure Boards
• Łączenie elementów roboczych z obiektami
• Rozwiązywanie problemów z połączeniem GitHub i Azure Boards