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

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

Po utworzeniu żądania ściągnięcia i określeniu wymaganych/opcjonalnych recenzentów usługa Azure Repos powiadomi recenzentów, że żądanie ściągnięcia jest gotowe do przeglądu. Wszyscy wymagani recenzenci muszą zatwierdzić zmiany w żądaniu ściągnięcia, zanim zmiany będą mogły zostać scalone z gałęzią docelową. W przypadku żądań ściągnięcia, które zmieniają krytyczne gałęzie, takie jak main gałąź, zespół mógł utworzyć zasady gałęzi określające recenzentów lub wymagać minimalnej liczby recenzentów. Jeśli zasady gałęzi dodają opcjonalnych recenzentów do żądania ściągnięcia, możesz je zachować, wymagać lub usunąć. Jeśli zasady gałęzi dodają wymaganych recenzentów do żądania ściągnięcia, nie będzie można ich opcjonalnych ani usunąć. Aby uzyskać informacje na temat przypisywania recenzentów za pomocą zasad gałęzi, zobacz Automatyczne dołączanie recenzentów kodu.

Jeśli przeglądasz żądanie ściągnięcia, spróbuj przekazać konstruktywną opinię, która jest dokładna i łatwa do zrozumienia. Aby uzyskać więcej informacji na temat przeglądu opinii, zobacz Opinie dotyczące żądania ściągnięcia. W tym artykule opisano sposób przeglądania żądań ściągnięcia w usłudze Azure DevOps.

Żądania ściągnięcia usługi Azure DevOps można przeglądać tylko w portalu internetowym przy użyciu przeglądarki.

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 żądania ściągnięcia
• Ukończ żądanie ściągnięcia

Wymagania wstępne

• Repozytoria muszą być włączone 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, musisz być członkiem projektu usługi Azure DevOps, w którym znajduje się żądanie ściągnięcia, z poziomem dostępu podstawowego lub wyższym.

  • 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.

Żądania ściągnięcia można zarządzać w usługach Azure DevOps Services przy użyciu interfejsu wiersza polecenia (CLI) usługi Azure DevOps. Interfejs wiersza polecenia usługi Azure DevOps jest dostępny podczas instalowania interfejsu wiersza polecenia platformy Azure i rozszerzenia Usługi Azure DevOps. Aby uzyskać listę poleceń interfejsu wiersza polecenia do zarządzania żądaniami ściągnięcia, zobacz az repos pr polecenia.

Przeglądanie zmian

Żądania ściągnięcia umożliwiają wyznaczonym recenzentom badanie, omawianie i głosowanie nad proponowanymi zmianami przed zastosowaniem tych zmian do 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 otwarte żądanie ściągnięcia jest domyślnie wyświetlane na karcie Przegląd .

2. Karta Przegląd żądania ściągnięcia zawiera tytuł, opis, recenzentów, połączone elementy robocze, historię, stan i komentarze. Przeczytaj opis żądania ściągnięcia, aby zobaczyć proponowane zmiany. Wyświetl komentarze, aby zrozumieć problemy zgłaszane przez innych recenzentów.

   Uwaga

   Każdy plik jest szacowany na wiele modyfikacji i jest oznaczony znakiem "+" lub etykietą "zmień nazwę, edytuj" obok jej nazwy. Jeśli plik ma więcej niż 50 procent zmian, jest uznawany za zmienioną nazwę. Jest to domyślny próg dla repozytoriów git, których nie można zmienić.

   

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ć układ różnicowy równoległy lub różnicowy .

   

   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 wypchnięte do żądania ściągnięcia od ostatniej przeglądu i chcesz tylko zobaczyć nowe zmiany. Lista rozwijana zmian zawiera nazwy każdego zestawu zmian z komunikatem zatwierdzenia z końcowego zatwierdzenia w każdej operacji wypychania.

   

   Napiwek

   Przytrzymaj Shift podczas wybierania wielu zestawów zmian z listy rozwijanej zmiany.

6. Wybierz kartę Aktualizacje , aby wyświetlić wszystkie wypchnięte zestawy zmian, aby upewnić się, że nie pominięto żadnych zmian 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 w tej operacji wypychania. Wymuszony zestaw zmian nie zastąpi historii zestawu zmian i będzie wyświetlany na liście zestawów zmian tak samo jak w przypadku innych zestawów zmian.

   

7. Wybierz kartę Zatwierdzenia, aby wyświetlić historię zatwierdzeń gałęzi źródłowej po rozmieściu z gałęzi docelowej. Historia zatwierdzeń na karcie Zatwierdzenia zostanie zastąpiona, jeśli autor żądania ściągnięcia wymusza wypychanie 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, aby wyświetlić rzeczywiste zmiany wprowadzone w gałęzi źródłowej obok gałęzi docelowej żądania ściągnięcia.

Uwaga

Porównanie żądań ściągnięcia usługi Azure DevOps pokazuje inne zmiany, niż porównanie gałęzi usługi Azure DevOps, ponieważ są stosowane są różne metody porównywania.

Istnieją dwie metody porównania dla polecenia różnic git: Dwie kropki (git diff A..B) i trzy kropki (git diff A...B). Domyślnie żądania ściągnięcia pokazują różnicę z trzema kropkami, podczas gdy porównanie gałęzi pokazuje różnicę dwukropka.

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 trzy-kropki i dwa-dot-git-diff-comparisons i różnice git

Uwaga

Podczas wyświetlania różnicy dla pojedynczego wybranego pliku istnieje limit rozmiaru pliku wynoszący 5 MB. Aby wyświetlać i różnicować pliki większe niż 5 MB, możesz pobrać plik i wyświetlić go przy użyciu lokalnego narzędzia różnic. 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 karcie Aktualizacje żądania ściągnięcia. Podczas wybierania różnych aktualizacji różnicowe aktualizacje widoku pokazują różnice między plikami w każdej wersji żądania ściągnięcia.

Aktualizacje żądania ściągnięcia można nadrobić po odejściu od żądania ściągnięcia, przechodząc przez zmiany wprowadzone od czasu ostatniej przeglądu.

Przejrzyj listę zmian z autora na karcie Aktualizacje .

Wyświetl i wybierz zmiany wprowadzone w zatwierdzeniach w gałęzi na karcie Zatwierdzenia .

Używanie komentarzy

Autorzy żądań ściągnięcia i recenzenci mogą komunikować się ze sobą, dodając komentarze żądania ściągnięcia 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. Adresaci adresują się bezpośrednio przy użyciu elementu @username. Odwołuj się do elementów roboczych przy użyciu polecenia #workitemID i innych żądania ściągnięcia 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 żądania ściągnięcia umieść kursor nad wierszem, nad którym 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 żądania ściągnięcia mogą również używać komentarzy do sugerowania zmian 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 ściągnięcia umieść kursor nad wierszem, nad którym 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. 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) widoku różnic obok siebie, nie zobaczysz ikony żarówki.

   

Autorzy żądań ściągnięcia 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ń ściągnięcia mogą cofnąć sugestię, wybierając pozycję 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ągnięcia 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 żądań ściągnięcia powinni odpowiedzieć na komentarze, aby poinformować recenzentów, w jaki sposób zajmują się opiniami i sugestiami:

1. Aby odpowiedzieć na komentarz, wpisz odpowiedź w polu Napisz odpowiedź . Adresaci adresują się bezpośrednio przy użyciu elementu @username. Odwołuj się do elementów roboczych przy użyciu polecenia #workitemID i innych żądania ściągnięcia przy użyciu polecenia !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 żądań ściągnięcia mogą również bezpośrednio zmienić stan komentarza zgodnie z opisem w następnej sekcji.

Zmienianie stanu komentarza

Nowe komentarze początkowo mają stan Aktywny, który autorzy żądań ściągnięcia aktualizują podczas procesu przeglądu, aby wskazać, w jaki sposób adresowali opinie i sugestie recenzenta. Autorzy żądań ściągnięcia mogą wybrać stan komentarza z listy rozwijanej stan:

• Aktywne: domyślny stan nowych komentarzy.

• Oczekujące: problem w tym komentarzu jest w trakcie przeglądu i oczekuje na coś innego.

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

• Nie rozwiąże problemu w tym komentarzu, ale nie zostanie rozwiązany.

• 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ę Co nowego filtru, aby wyświetlić nowe komentarze i aktualizacje od czasu ostatniego otwarcia żądania ściągnięcia. Każda opcja filtru pokazuje liczbę elementów dla swojej kategorii.

Edytowanie plików

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

1. Wybierz pozycję Pliki repozytoriów>, wybierz gałąź źródłową żądania ściągnięcia, wybierz plik, a następnie wybierz pozycję Edytuj.

   

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

   

3. W oknie dialogowym Zatwierdzanie zmodyfikuj komunikat zatwierdzenia w razie potrzeby, a następnie wybierz pozycję Zatwierdź, aby zatwierdzić i wypchnąć zmiany do żądania ściągnięcia.

   

Śledzenie przeglądanych plików

Recenzenci żądania ściągnięcia mogą śledzić przeglądane pliki, wybierając pozycję Oznacz jako przeglądane w menu opcji pliku lub zaznaczając pole wyboru obok pliku lub folderu:

Głosowanie nad zmianami żądania ściągnięcia

Przeglądarka

Recenzenci żądania ściągnięcia mogą głosować na żądanie ściągnięcia, wybierając opcję głosowania z listy rozwijanej głosowania. Ikona recenzenta na stronie żądania ściągnięcia będzie zawierać wskazanie ich głosu.

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

• Zatwierdź: zatwierdza proponowane zmiany w żądaniu ściągnięcia. Ta opcja jest tylko głosowaniem i nie zatwierdza żądania ściągnięcia.

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

• Poczekaj na autora: prosi autora o przejrzenie komentarzy recenzenta. Autor żądania ściągnięcia powinien poinformować recenzentów o ponownym przejrzeniu kodu po tym, jak autor żądania ściągnięcia zwrócił się do komentarzy. Jeśli wymagany recenzent ustawia tę opcję głosowania, głosowanie zablokuje zatwierdzenie żądania ściągnięcia.

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

• Zresetuj opinię: czyści swój głos. Brak głosowania nie uniemożliwia ukończenia żądania ściągnięcia.

Interfejs wiersza polecenia usługi Azure DevOps

Aby głosować nad tym, czy zatwierdzić żądanie ściągnięcia, użyj az repos pr set-vote polecenia .

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

Parametry

Parametr	Wymagania	opis
--id	Tak	Identyfikator żądania ściągnięcia
--vote	Tak	Nowa wartość głosowania dla żądania ściągnięcia (akceptowane wartości: approve, , approve-with-suggestionsreject, resetlub 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

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

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

• Ukończono: ukończ żądanie ściągnięcia teraz, jeśli wszyscy wymagani recenzenci zatwierdzili je i zostaną spełnione wszystkie wymagane zasady gałęzi.

• Ustaw automatyczne uzupełnianie: autouzupełnij żądanie ściągnięcia, gdy wszyscy wymagani recenzenci zatwierdzą je i zostaną spełnione wszystkie wymagane zasady gałęzi.

• 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 żądania ściągnięcia możesz wybrać pozycję Publikuj , aby usunąć jego stan wersji roboczej i oznaczyć go jako gotowy do przeglądu.

• Porzuć: zamknij żądanie ściągnięcia. W przypadku porzuconego żądania ściągnięcia możesz wybrać pozycję Aktywuj ponownie , aby je przywrócić.

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

Następne kroki

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

Powiązane artykuły

• Powiadomienia o aktualizacji żądania ściągnięcia
• Informacje o żądaniach ściągnięcia i uprawnieniach