Łączenie zatwierdzeń GitHub, żądań ściągnięcia, gałęzi i problemów z elementami roboczymi w usłudze Azure Boards
Azure DevOps Services | Azure DevOps Server 2022 — Azure DevOps Server 2019
W tym artykule dowiesz się, jak połączyć elementy robocze z zatwierdzeniami GitHub, prośbami ściągnięcia i gałęziami po połączeniu projektu Azure Boards z repozytorium GitHub. Składnię #mention można użyć dla zatwierdzeń i gałęzi lub dodać link zatwierdzenia, żądania ściągnięcia lub gałęzi usługi GitHub bezpośrednio z elementu roboczego usługi Azure Boards.
Uwaga
Dzięki aplikacji Azure Boards dla usług GitHub usługi Azure Boards i Azure DevOps Services integrują się z repozytoriami GitHub.com i GitHub Enterprise Server. Usługa Azure DevOps Server 2019 i nowsze wersje obsługują integrację tylko z repozytoriami GitHub Enterprise Server. Integracja z innymi repozytoriami Git nie jest obsługiwana.
Wymagania wstępne
| Kategoria | Wymagania |
|---|---|
| uprawnienia | współautor zarówno do projektu usługi Azure Boards, jak i repozytorium GitHub. |
| Połączenie projektu | Projekt usługi Azure Boards jest połączony z repozytorium GitHub, w którym znajdują się zatwierdzenia, pull requesty i gałęzie, do których lub od których chcesz utworzyć łącze. Aby uzyskać więcej informacji, zobacz Integracja z usługą Azure Boards-GitHub. |
Uwaga
Projekty korzystające z hostowanego modelu procesów XML wymagają aktualizacji typów elementów roboczych w celu wyświetlenia sekcji Programistycznej i typów łączy GitHub. Aby uzyskać więcej informacji, zobacz Aktualizowanie definicji XML dla wybranych typów elementów roboczych.
Użyj AB#, aby połączyć GitHub z elementami roboczymi w Azure Boards.
Użyj następującej składni w commicie, pull requestu lub zgłoszeniu GitHub, aby utworzyć link do elementu roboczego Azure Boards. Wprowadź AB#ID wewnątrz tekstu komunikatu zatwierdzenia. W przypadku pull requesta lub zgłoszenia, wprowadź AB#ID w tytule lub opisie. Użycie AB#ID w komentarzu nie powoduje utworzenia linku do elementu roboczego.
AB#{ID}
Na przykład AB#125 linkuje do elementu roboczego o identyfikatorze 125.
Możesz również wprowadzić komunikat zatwierdzenia lub żądania dodania, aby zmienić element roboczy. System rozpoznaje fix, fixesi fixed, i stosuje go do elementu #-mention, który następuje poniżej. Wymienione elementy robocze przechodzą do pierwszego stanu związanego z kategorią stanu przepływu pracy Rozwiązane. Jeśli żaden Stan nie jest skojarzony z Resolved, element roboczy przechodzi do Stanu skojarzonego ze stanem kategorii przepływu pracy Completed. Aby uzyskać więcej informacji, zobacz How workflow category states are used in Azure Boards backlogs and boards (Jak są używane stany kategorii przepływu pracy w listach prac i tablicach usługi Azure Boards).
Zapoznaj się z poniższą tabelą przykładów:
| Komunikat zatwierdzenia lub prośba o pobranie | Akcja |
|---|---|
Fixed AB#123 |
Łączy i przechodzi element roboczy do kategorii 'Rozwiązano' w przepływie pracy lub, jeśli żadna nie jest zdefiniowana, do kategorii 'Ukończono' w przepływie pracy. |
Adds a new feature, fixes AB#123. |
Łączy i przenosi element roboczy do stanu przepływu pracy Rozwiązany lub, jeśli żadna nie jest zdefiniowana, to do stanu przepływu pracy Ukończono. |
Fixes AB#123, AB#124, and AB#126 |
Linki do elementów roboczych usługi Azure Boards 123, 124 i 126. Przenosi tylko pierwszy element, 123 do kategorii stanu Rozwiązany przepływu pracy lub, jeśli żadna nie jest zdefiniowana, wtedy kategoria stanu Ukończony przepływu pracy. |
Fixes AB#123, Fixes AB#124, Fixes AB#125 |
Linki do elementów roboczych usługi Azure Boards 123, 124 i 126. Przenosi wszystkie elementy do kategorii stanu przepływu pracy Rozwiązany lub, jeśli żadna nie jest zdefiniowana, wtedy do kategorii stanu przepływu pracy Ukończono. |
Fixing multiple bugs: issue #123 and user story AB#234 |
Linki do problemu 123 w usłudze GitHub i elementu roboczego usługi Azure Boards 234. Nie są wykonywane żadne przejścia. |
Uwaga
Jeśli połączono to samo repozytorium GitHub z projektami zdefiniowanymi w co najmniej dwóch organizacjach usługi Azure DevOps, mogą się pojawić nieoczekiwane łączenia wzmianki oznaczonej jako AB#. Aby uzyskać więcej informacji, zobacz Rozwiązywanie problemów z połączeniem. Z tego powodu zalecamy połączenie repozytorium GitHub tylko z projektami zdefiniowanymi w jednej organizacji usługi Azure DevOps.
Po dodaniu linku do elementu roboczego przy użyciu programu AB#, te linki są wyświetlane w sekcji Rozwój żądania ściągnięcia.
Tworzenie gałęzi GitHub na podstawie elementu roboczego
Aby utworzyć gałąź usługi GitHub bezpośrednio z poziomu elementu roboczego, wykonaj następujące kroki:
Na tablicy znajdź element roboczy, z którego chcesz utworzyć gałąź usługi GitHub.
Wybierz
Akcje elementu roboczego>Nowa gałąź GitHub.
W oknie dialogowym Tworzenie gałęzi GitHub wprowadź nazwę gałęzi i wybierz repozytorium GitHub i gałąź podstawową.
Wybierz pozycję Utwórz.
Usługa Azure Boards tworzy gałąź w określonym repozytorium GitHub i łączy ją z elementem roboczym. Aby uzyskać więcej informacji, zobacz Integracja z usługą Azure Boards-GitHub.
Dodawanie linku elementu roboczego do gałęzi GitHub, zatwierdzenia lub żądania ściągnięcia
Otwórz element roboczy i przejdź do karty Linki.
W oknie dialogowym Dodaj link wybierz jeden z typów linków GitHub, wybierz repozytorium GitHub, wprowadź adres URL do gałęzi GitHub, zatwierdzenia lub żądania pobrania, a następnie wybierz pozycję Dodaj link.
W poniższym przykładzie dodamy link do pull requestu na GitHubie.
Azure Boards kończy weryfikację, aby upewnić się, że wprowadzono prawidłowy link. Repozytorium GitHub, do którego jest odnośnik, musi być połączone z projektem Azure Boards, lub walidacja kończy się niepowodzeniem.
Uwaga
Jeśli używasz serwera Azure DevOps Server i serwera GitHub Enterprise Server, występuje opóźnienie podczas kończenia linków AB#. Mamy projekt "pchnij-i-ciągnij" do pobierania ze zdarzeń GitHub co godzinę dla zmian przyrostowych w Commitach, Żądaniach Pull i Zagadnieniach.
Wyświetlanie lub otwieranie linków z sekcji Programowanie
Sekcja Rozwój w formularzu elementu roboczego zawiera linki utworzone do zatwierdzeń w GitHub i pull requestów wraz z ikoną 
GitHub.
Wybierz podany link, aby otworzyć commit lub pull request w usłudze GitHub.
Wyświetlanie obiektów usługi GitHub na tablicy
Dzięki włączeniu adnotacji usługi GitHub na tablicy można szybko otwierać połączone zatwierdzenia, żądania ściągnięcia lub problemy w usłudze GitHub, aby uzyskać więcej szczegółów. Aby uzyskać więcej informacji, zobacz Dostosowywanie kart.
