Przeglądanie żądań ściągnięcia

Azure DevOps Services | Azure DevOps Server 2022 — Azure DevOps Server 2019

Po utworzeniu pull requestu (PR) i określeniu wymaganych/opcjonalnych recenzentów, usługa Azure Repos powiadomi recenzentów, że Twój PR jest gotowy do przeglądu. Wszyscy wymagani recenzenci muszą zatwierdzić zmiany w PR, zanim zmiany zostaną scalone z gałęzią docelową. W przypadku pull requestów, które zmieniają kluczowe gałęzie, takie jak gałąź , zespół mógł utworzyć polityki gałęzi określające recenzentów lub wymagające minimalnej liczby recenzentów. Jeśli zasady gałęzi dodają opcjonalnych recenzentów do pull requesta, możesz ich zachować, wymagać ich zatwierdzenia lub usunąć. Jeśli zasady gałęzi dodają wymaganych recenzentów do żądania ściągnięcia, nie można uczynić ich opcjonalnymi ani usunąć. Aby uzyskać informacje na temat przypisywania recenzentów za pomocą zasad gałęzi, zobacz Automatyczne uwzględnianie recenzentów kodu.

Jeśli przeglądasz PR, spróbuj przekazać konstruktywną informację zwrotną, która jest dokładna i łatwa do zrozumienia. Aby uzyskać więcej informacji na temat informacji zwrotnej z recenzji, zobacz Opinie dotyczące żądania zmiany. W tym artykule opisano sposób przeglądania pull requestów w usłudze Azure DevOps.

Możesz przeglądać PR-y w Azure DevOps tylko w przeglądarce internetowej.

W tym artykule omówiono sposób wykonywania następujących zadań:

• Przeglądanie zmian
• Używanie komentarzy
• Edytowanie plików
• Śledzenie przeglądanych plików
• Głosowanie nad zmianami w Pull Requestach
• Ukończ żądanie ściągnięcia

Wymagania wstępne

• Repozytoria muszą być aktywowane w ustawieniach projektu usługi Azure DevOps. Jeśli centrum repozytoriów i skojarzone strony nie są wyświetlane, zobacz Włączanie lub wyłączanie usługi Azure DevOps w celu ponownego włączenia repozytoriów.

• Aby przejrzeć żądania ściągnięcia, należy do projektu usługi Azure DevOps, w ramach których znajduje się żądanie ściągnięcia, co najmniej dostęp do usługi Basic.

  • Jeśli nie masz projektu, utwórz go lub zarejestruj się bezpłatnie.

  • Jeśli nie jesteś członkiem projektu, dodaj go.

  Uwaga

  W przypadku projektów publicznych użytkownicy, którym udzielono dostępu uczestnikom projektu , mają pełny dostęp do usługi Azure Repos.

• Aby uzyskać więcej informacji o uprawnieniach i dostępie, zobacz Domyślne repozytorium Git i uprawnienia gałęzi oraz Informacje o poziomach dostępu.

Możesz zarządzać żądaniami przeciągnięcia w usługach Azure DevOps za pomocą interfejsu wiersza polecenia (CLI) Azure DevOps. Interfejs Azure DevOps CLI jest dostępny po zainstalowaniu Azure CLI i rozszerzenia Azure DevOps. Aby uzyskać listę poleceń interfejsu wiersza polecenia do zarządzania żądaniami ściągnięcia, zobacz polecenia az repos pr.

Przeglądanie zmian

Pull requesty umożliwiają wyznaczonym recenzentom przeglądanie, omawianie i głosowanie nad proponowanymi zmianami przed ich zastosowaniem w gałęzi docelowej repozytorium. Należy pamiętać, że w przypadku programowania z tymi samymi plikami w różnych gałęziach mogą wystąpić zmiany powodujące konflikt. W takim przypadku należy dokładnie analizować i rozwiązywać te konflikty. W tym celu może wymagać ręcznego edytowania pliku w celu poprawnego zastosowania zmian z gałęzi źródłowych, docelowych lub obu gałęzi. Pobieranie wszystkich zmian ze źródła lub miejsca docelowego (które można wykonać za pomocą jednego kliknięcia przycisku) może nie być optymalne i może spowodować utratę niektórych wymaganych zmian. Można to zrobić przy użyciu narzędzi ADO lub będzie wygodniejsze w korzystaniu z narzędzi programistycznych (takich jak Visual Studio).

Aby dowiedzieć się więcej, zobacz Rozwiązywanie konfliktów scalania.

W poniższych krokach opisano, jak recenzenci żądań ściągnięcia w usłudze Azure Repos mogą przechodzić przez żądanie ściągnięcia, aby zrozumieć proponowane zmiany:

1. W przeglądarce internetowej otwórz projekt zespołowy organizacji usługi Azure DevOps. Wybierz pozycję Żądania ściągnięcia repozytorium > , aby wyświetlić listę żądań ściągnięcia . Nowo otwarty pull request domyślnie otwiera się na karcie Przegląd.

2. Karta Przegląd żądania pull wyświetla tytuł, opis, recenzentów, połączone elementy robocze, historię, status i komentarze. Przeczytaj opis PR, aby zobaczyć proponowane zmiany. Wyświetl komentarze, aby zrozumieć problemy zgłaszane przez innych recenzentów.

   Uwaga

   Każdy plik ma przypisaną liczbę modyfikacji i jest oznaczony znakiem "+" lub oznaczeniem "zmień nazwę, edytuj" obok jego nazwy. Jeśli plik ma więcej niż 50 procent zmian, jest uznawany za przemianowany. Jest to domyślny próg dla repozytoriów git, który nie może być zmieniony.

   

3. Wybierz kartę Pliki, aby przejrzeć wszystkie zmiany zawartości w gałęzi źródłowej żądania ściągnięcia. Widok początkowy przedstawia widok podsumowania wszystkich zmian w pliku. Wybierz przycisk Wyświetl obok pliku, aby wyświetlić tylko zmiany tego pliku. Jeśli plik został zmodyfikowany, przycisk Wyświetl otwiera widok różnic. Jeśli plik został dodany lub usunięty, przycisk Wyświetl otwiera okienko zawartości.

   

   Uwaga

   Ze względu na wydajność widok podsumowania nie będzie pokazywał zmian dla pliku, który jest większy niż 0,5 MB.

4. W widoku różnic dla pliku można wybrać widok równoległy albo widok w linii.

   

   Napiwek

   W przypadku każdego pojedynczego pliku, który jest większy niż 5 MB, widok różnic pokazuje obciętą zawartość pliku. Aby uzyskać widok różnic pełnej zawartości, pobierz i przejrzyj takie pliki przy użyciu lokalnego narzędzia różnic.

   Użyj drzewa plików po lewej stronie, aby wyświetlić inny plik, lub wybierz katalog główny drzewa plików, aby wyświetlić widok podsumowania wszystkich zmian w pliku.

5. Aby przejrzeć zestaw zmian wprowadzony przez określone wypchnięcia do gałęzi źródłowej, wybierz co najmniej jeden zestaw zmian z listy rozwijanej zmian. Po wybraniu co najmniej jednego zestawu zmian widok różnic zostanie zaktualizowany, aby wyświetlić tylko zmiany z wybranych zestawów zmian. Ta funkcja jest przydatna, gdy zmiany zostały przesłane do pull requestu od Twojej ostatniej recenzji i chcesz zobaczyć tylko nowe elementy. Lista rozwijana zmian zawiera nazwy każdego zestawu zmian z komunikatem zatwierdzenia z końcowego zatwierdzenia w każdej operacji wypychania.

   

   Napiwek

   Przytrzymaj klawisz Shift, aby wybrać wiele zestawów zmian z listy rozwijanej zmian.

6. Wybierz kartę Aktualizacje, aby wyświetlić wszystkie przesłane zestawy zmian i upewnić się, że nie pominięto żadnych zmian w gałęzi źródłowej. Zestawy zmian są numerowane, a najnowszy zestaw zmian pojawia się w górnej części listy. Każdy zestaw zmian pokazuje zatwierdzenia, które zostały wypchnięte podczas tej operacji. Zestaw zmian wykonany za pomocą wymuszenia nie zastąpi historii zestawu zmian i będzie wyświetlany na liście zestawów zmian tak samo jak inne zestawy zmian.

   

7. Wybierz kartę Zatwierdzenia, aby wyświetlić historię zatwierdzeń gałęzi źródłowej po rozdzieleniu się z gałęzi docelowej. Historia zatwierdzeń na karcie Zatwierdzenia zostanie zastąpiona, jeśli autor PR wymusi wypchnięcie innej historii zatwierdzeń, więc zatwierdzenia wyświetlane na karcie Zatwierdzenia mogą różnić się od zatwierdzeń wyświetlanych na karcie Aktualizacje.

   

Przeglądanie plików

Wybierz kartę Pliki żądania ściągnięcia (pull request), aby zobaczyć rzeczywiste zmiany wprowadzone w źródłowej gałęzi w porównaniu z gałęzią docelową żądania ściągnięcia.

Uwaga

Różne zmiany między prośbą o wyciągnięcie w usłudze Azure DevOps a porównaniem gałęzi w usłudze Azure DevOps wynikają z różnych stosowanych metod porównawczych.

Istnieją dwie metody porównania dla polecenia git diff: Dwie kropki (git diff A..B) i trzy kropki (git diff A...B). Domyślnie pull requesty pokazują trzy-dotkową różnicę, podczas gdy porównanie gałęzi pokazuje dwu-dotkową różnicę.

Na przykład:

      C---D---E branch
     /
A---B---F---G   master

Żądania ściągnięcia: git diff branch...master będą tworzyć tylko zatwierdzenia C, D, E. Porównanie gałęzi: git diff branch..master spowoduje wygenerowanie zatwierdzeń C, D, E, F, G.

Aby uzyskać więcej informacji, zobacz three-dot-and-two-dot-git-diff-comparisons i git diff

Uwaga

Podczas wyświetlania różnicy dla pojedynczego wybranego pliku istnieje limit rozmiaru pliku wynoszący 5 MB. Aby wyświetlać i porównywać pliki większe niż 5 MB, możesz pobrać plik i oglądać go za pomocą lokalnego narzędzia różnicującego. Podczas wyświetlania różnicy dla kolekcji plików limit rozmiaru każdego pliku wynosi 0,5 MB ze względu na wydajność.

Przeglądanie aktualizacji

Przejrzyj poprzednie wersje kodu z listy rozwijanej Wszystkie aktualizacje .

Każda aktualizacja gałęzi dodaje nową wersję do listy i na zakładce Aktualizacje pull requesta. Podczas wybierania różnych zmian, widok różnic aktualizuje się, aby pokazać różnice między plikami w każdej wersji żądania ściągnięcia.

Możesz nadrobić aktualizacje PR po nieobecności, przeglądając zmiany wprowadzone od czasu ostatniej przeglądu.

Przejrzyj listę zmian od autora na karcie Aktualizacje.

Wyświetl i wybierz zmiany wprowadzone w ramach commitów w gałęzi na karcie Commits.

Używanie komentarzy

Autorzy i recenzenci PR mogą komunikować się ze sobą, dodając komentarze PR i odpowiadając na nie. Podczas przeglądania żądania ściągnięcia użyj komentarzy, aby wskazać problemy z proponowanymi zmianami, zasugerować zmiany i odpowiedzieć na poprzednie komentarze. Celuj w konstruktywne opinie, które są precyzyjne i łatwe do zrozumienia. Zwracaj się bezpośrednio do adresatów, używając ich @username. Odwołuj się do elementów roboczych przy użyciu polecenia #workitemID i innych żądań zmiany przy użyciu polecenia !pullrequestID. Czasami autorzy żądań ściągnięcia tworzą komentarze dla siebie w celach dokumentacji.

Prześlij opinię w komentarzach

Jeśli twoja opinia dotyczy określonego wiersza lub zakresu wierszy w pliku, dodaj komentarz w tej lokalizacji w pliku:

1. Na karcie Pliki pull requesta umieść kursor nad wierszem, do którego chcesz dodać komentarz, i wybierz przycisk komentarza, aby otworzyć wbudowane pole komentarza. Możesz również wybrać wiele wierszy, a następnie wybrać przycisk komentarza wyświetlany po umieszczeniu wskaźnika myszy na tych wierszach.

   

2. Wprowadź komentarz w polu komentarza i wybierz pozycję Komentarz.

   

Jeśli twoja opinia dotyczy całego pliku, dodaj komentarz na poziomie pliku, wybierając pozycję Dodaj komentarz z menu opcji pliku:

Aby przekazać ogólną opinię niepowiązaną z określonym plikiem, dodaj komentarz na karcie Przegląd :

Recenzenci PR mogą także używać komentarzy, aby sugerować zmiany w określonych wierszach plików, zgodnie z opisem w następnej sekcji.

Sugerowanie zmian w komentarzach

Możesz użyć komentarzy, aby zasugerować tekst zastępczy dla co najmniej jednego wiersza w pliku:

1. Na karcie Pliki żądania połączenia umieść kursor nad wierszem, do którego chcesz dodać komentarz, i wybierz przycisk komentarza , aby otworzyć pole wbudowanego komentarza. Możesz również wybrać wiele wierszy, a następnie wybrać przycisk komentarza wyświetlany po umieszczeniu wskaźnika myszy na tych wierszach. Jeśli zostanie zaakceptowana, sugerowana zawartość zastąpi wiersz lub wiersze dodane do komentarza.

   

2. Wybierz ikonę żarówki w polu komentarza, aby wprowadzić sugerowane zmiany w polu komentarza w bloku kodu ogrodzonego, a następnie wybierz pozycję Komentarz. Jeśli dodasz komentarz do oryginalnego kodu (po lewej stronie) w widoku porównawczym obok siebie, ikona żarówki nie będzie widoczna.

   

Autorzy PR mogą zaakceptować twoją sugestię, wykonując następujące czynności:

1. Wybranie opcji Zastosuj zmiany w celu przygotowania zmiany gotowości do zatwierdzenia.

   

2. Wybranie opcji Zatwierdź wszystkie zmiany w celu zatwierdzenia wszystkich zmian etapowych. Autorzy żądań scalenia mogą usunąć etapowanie sugestii, wybierając opcję cofnij zmianę.

   

Edytowanie lub usuwanie komentarzy

Możesz edytować lub usunąć komentarz, umieszczając kursor nad komentarzem i wybierając ikonę edytowania lub usuwania:

Lubię komentarze

Autorzy żądań ściągania i recenzenci mogą polubić własny komentarz lub komentarz innego użytkownika, umieszczając kursor nad komentarzem i wybierając ikonę kciuka w górę.

Komentarze z polubieniami pokazują wypełnioną ikonę kciuka i liczbę polubień. Umieść kursor na ikonie thumbs-up, aby wyświetlić listę osób, które polubiły komentarz.

Odpowiedz na komentarze

Autorzy pull requestów powinni odpowiedzieć na komentarze, aby poinformować recenzentów, w jaki sposób zajmują się uwagami i sugestiami.

1. Aby odpowiedzieć na komentarz, wpisz odpowiedź w polu Napisz odpowiedź . Adresuj odbiorców bezpośrednio przy użyciu @username. Odwołuj się do elementów roboczych za pomocą #workitemID i innych żądań pobrania za pomocą !pullrequestID.

   

2. Po wprowadzeniu odpowiedzi wybierz pozycję Odpowiedz i rozwiąż, jeśli odpowiedź jest ostateczna. W przeciwnym razie wybierz pozycję Odpowiedz.

   

   Jeśli wybierzesz pozycję Odpowiedz i rozwiąż, stan komentarza zmieni się na Rozwiązano. Autorzy PR mogą również bezpośrednio zmienić status komentarza, jak opisano w następnej sekcji.

Zmienianie stanu komentarza

Nowe komentarze początkowo mają status Aktywny, który autorzy żądań ściągnięcia aktualizują podczas procesu przeglądu, aby wskazać, w jaki sposób odnoszą się do komentarzy i sugestii recenzentów. Autorzy żądań pobrania mogą wybrać status komentarza z listy rozwijanej ze stanem:

• Aktywne: domyślny stan nowych komentarzy.

• Oczekujące: kwestia w tym komentarzu jest w trakcie przeglądu i czeka na dalsze kroki.

• Rozwiązano: problem w tym komentarzu został rozwiązany.

• Nie zostanie naprawione: kwestia w tym komentarzu jest zanotowana, ale nie zostanie naprawiona.

• Zamknięte: dyskusja w tym komentarzu jest zamknięta.

Autorzy żądań ściągnięcia i recenzenci mogą śledzić postęp żądania ściągnięcia, filtrując stan komentarza zgodnie z opisem w następnej sekcji.

Filtrowanie komentarzy

Możesz wybrać komentarze lub aktualizacje wyświetlane na karcie Przegląd , wybierając opcję filtru z listy rozwijanej filtru komentarzy. Na przykład wybierz opcję filtru Co nowego, aby wyświetlić nowe komentarze i aktualizacje od czasu ostatniego otwarcia pull requesta. Każda opcja filtru pokazuje liczbę elementów dla swojej kategorii.

Edytowanie plików

Dla wygody autorzy żądań zmiany mogą edytować pliki bezpośrednio w Azure Repos. Na przykład możesz zaakceptować sugerowaną zmianę kodu recenzenta i chcieć wprowadzić podobne zmiany w innym miejscu.

1. Wybierz Repozytoria > Pliki, wybierz gałąź źródłową PR, wybierz plik, a następnie wybierz Edytuj.

   

2. Wprowadź zmiany w edytorze, a następnie wybierz pozycję Zatwierdź, aby otworzyć okno dialogowe Zatwierdzanie.

   

3. W oknie dialogowym Zatwierdź zmodyfikuj komunikat zatwierdzenia w razie potrzeby, a następnie wybierz pozycję Zatwierdź, aby zatwierdzić i wypchnąć zmiany do PR.

   

Śledzenie przeglądanych plików

Recenzenci PR mogą śledzić przeglądane pliki, wybierając pozycję Oznacz jako przejrzane w menu opcji pliku lub zaznaczając pole wyboru obok pliku lub folderu:

Głosowanie nad zmianami w pull requestach

Przeglądarka

Recenzenci mogą głosować na pull request, wybierając opcję z listy rozwijanej głosowania. Ikona recenzenta na stronie PR będzie zawierać informację o ich głosie.

Dostępne są następujące opcje głosowania:

• Zatwierdź: zatwierdza proponowane zmiany w pull request. Ta opcja jest tylko głosowaniem i nie zatwierdza pull requesta.

• Zatwierdź sugestie: zatwierdza proponowane zmiany w żądaniu ściągnięcia z opcjonalnymi sugestiami dotyczącymi ulepszeń. Ta opcja jest tylko opcją głosowania i nie zatwierdza pull requesta.

• Poczekaj na autora: prosi autora o przejrzenie komentarzy recenzenta. Autor PR powinien poinformować recenzentów o konieczności ponownej oceny kodu po odniesieniu się do uwag. Jeśli wymagany recenzent wybierze tę opcję głosowania, to głosowanie zablokuje zatwierdzenie pull requesta.

• Odrzuć: wskazuje, że zmiany nie są akceptowalne. Po wybraniu tej opcji dodaj komentarz wyjaśniający, dlaczego. Jeśli wymagany recenzent ustawi tę opcję głosowania, głosowanie zablokuje zatwierdzenie pull requesta.

• Zresetuj opinię: usuwa Twój głos. Brak głosowania nie uniemożliwia ukończenia pull requestu.

Interfejs wiersza polecenia usługi Azure DevOps

Aby głosować nad zatwierdzeniem PR, użyj polecenia az repos pr set-vote.

az repos pr set-vote --id
                     --vote {approve, approve-with-suggestions, reject, reset, wait-for-author}
                     [--detect {false, true}]
                     [--org]
                     [--subscription]

Parametry

Parametr	Wymagane	opis
--id	Tak	Identyfikator żądania ściągnięcia
--vote	Tak	Nowa wartość głosowania dla żądania przeciągnięcia (akceptowane wartości: approve, approve-with-suggestions, reject, reset, lub wait-for-author)
--detect	Nie.	Automatycznie wykrywaj organizację (akceptowane wartości: false, true)
--organization	Tak, jeśli domyślna organizacja nie jest ustawiona, a plik konfiguracji git nie określa organizacji	Adres URL organizacji usługi Azure DevOps lub ustaw domyślną organizację przy użyciu: az devops configure -d organization=<organization URL>
--subscription	Nie.	Nazwa lub identyfikator subskrypcji platformy Azure albo ustaw subskrypcję domyślną przy użyciu: az account set -s <name or ID>

Przykłady

Następujące polecenie zagłosuje, aby zatwierdzić żądanie ściągnięcia nr 21. Polecenie zwraca tabelę.

az repos pr set-vote --id 21 --vote approve --output table

Name            Email                ID                                    Vote      Required
--------------  ------------------- -------------------------------------  --------  ----------
Jamal Hartnett  jamalh@fabrikam.com  00000000-0000-0000-0000-000000000000  Approved  False

Następujące polecenie usuwa głos. Polecenie zwraca tabelę.

az repos pr set-vote --id 21 --vote reset --output table

Name            Email                ID                                    Vote      Required
--------------  ------------------- -------------------------------------  --------  ----------
Jamal Hartnett  jamalh@fabrikam.com  00000000-0000-0000-0000-000000000000            False

Zakończ PR

Autorzy żądań ściągnięcia mogą wybrać opcję rozpoznawania żądań ściągnięcia:

• Ukończ: zakończ realizację prośby o przesłanie teraz, jeśli wszyscy wymagani recenzenci ją zatwierdzili i wszystkie wymagane zasady gałęzi są spełnione.

• Ustaw automatyczne zakończenie: automatycznie zakończ pull request, gdy wszyscy wymagani recenzenci go zatwierdzą i wszystkie wymagane zasady gałęzi zostaną spełnione.

• Oznacz jako wersję roboczą: ustaw stan żądania ściągnięcia na wersję roboczą, aby wskazać, że nie jest gotowy do przeglądu. W przypadku roboczego pull requestu możesz wybrać Publikuj, aby usunąć jego status wersji roboczej i oznaczyć jako gotowy do przeglądu.

• Anuluj: zamknij wniosek. W przypadku porzuconego żądania przejęcia możesz wybrać Aktywuj ponownie, aby je przywrócić.

Aby uzyskać więcej informacji na temat ukończenia żądania ściągnięcia, zobacz Ukończenie żądania ściągnięcia.

Następne kroki

Ukończ żądanie ściągnięcia

Powiązane artykuły

• Powiadomienia dotyczące aktualizacji pull request
• Informacje o żądaniach ściągnięcia i uprawnieniach