Uwaga
Dostęp do tej strony wymaga autoryzacji. Może spróbować zalogować się lub zmienić katalogi.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
Azure DevOps Services | Azure DevOps Server 2022 — Azure DevOps Server 2019
Visual Studio 2019 | Visual Studio 2022
Utwórz żądania dodania (PR), aby zmieniać, przeglądać i scalać kod w repozytorium Git . Żądania ściągnięcia można utworzyć na podstawie gałęzi w repozytorium nadrzędnym lub z gałęzi w rozwidleniu repozytorium. Twój zespół może przejrzeć pull requesty i przekazać opinię na temat zmian. Recenzenci mogą przeglądać proponowane zmiany, zostawiać komentarze i głosować, aby zatwierdzić lub odrzucić PR-y. W zależności od zasad gałęzi i innych wymagań, spełnienie różnych kryteriów może być konieczne, zanim będzie można ukończyć PR i scalić zmiany z gałęzią docelową.
Aby uzyskać wskazówki dotyczące próśb ściągnięcia i kwestie zarządzania, zobacz Informacje o prośbach ściągnięcia.
Wymagania wstępne
Kategoria | Wymagania |
---|---|
Poziomy dostępu | - Wyświetl lub przejrzyj PR-y: co najmniej dostęp podstawowy. W przypadku projektów publicznych użytkownicy udziałowcy z dostępem mają pełny dostęp do usługi Azure Repos. |
uprawnienia | - Wniesienie wkładu do PR: Członek grupy bezpieczeństwa Czytelników lub mający odpowiednie uprawnienia. — Utwórz i ukończ wniosek o ściągnięcie: członek grupy współautorów zabezpieczeń lub posiadający odpowiednie uprawnienia. |
Usługi | Repozytoria włączone. |
Narzędzia | interfejsu wiersza polecenia usługi Azure DevOps. |
Kategoria | Wymagania |
---|---|
Poziomy dostępu | - Wyświetl lub przejrzyj prośby ściągnięcia: co najmniej Podstawowy Dostęp. |
uprawnienia | - Współtworzenie żądania ściągnięcia: Członek Czytelników grupy zabezpieczeń lub odpowiednich uprawnień. — Utwórz i ukończ żądanie scalenia: członek grupy zabezpieczeń współautorów lub posiadający odpowiednie uprawnienia. |
Usługi | Repozytoria włączone. |
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.
Utwórz pull request
Nowe żądanie pobrania można utworzyć z witryny projektu Azure DevOps, Visual Studio lub z poziomu CLI Azure DevOps.
Na stronie internetowej projektu Azure DevOps możesz utworzyć nowy pull request na podstawie:
- strona Żądania ściągnięcia.
- gałąź funkcjonalna wypchnięta do repozytorium.
- Istniejące żądanie ściągnięcia przy użyciu funkcji "cherry-pick".
- Kontrola rozwoju w powiązanym elemencie roboczym usługi Azure Boards.
Utwórz Pull request na stronie Pull requests
Możesz utworzyć pull requesty dla dowolnej gałęzi na stronie pull requestów projektu w przeglądarce internetowej.
Na stronie Repozytoria>żądania ściągnięcia wybierz pozycję Nowe żądanie ściągnięcia w prawym górnym rogu.
Wybierz gałąź ze zmianami i gałąź, do której chcesz scalić zmiany, na przykład gałąź główna.
Wprowadź szczegóły PR i utwórz PR.
Utwórz żądanie ściągnięcia z wypchniętej gałęzi
Po wypchnięciu lub zaktualizowaniu gałęzi funkcji, usługa Azure Repos wyświetla monit o utworzenie pull request.
Na stronie Żądania ściągnięcia:
Na stronie Files:
Wybierz pozycję Utwórz żądanie ściągnięcia, aby przejść do strony, na której można wprowadzić szczegóły żądania ściągnięcia i utworzyć żądanie ściągnięcia.
Tworzenie żądania ściągnięcia na podstawie połączonego elementu roboczego
Pull request można utworzyć bezpośrednio z elementu roboczego usługi Azure Boards połączonego z gałęzią.
W usłudze Azure Boards z listy prac lub zapytań w widoku Work otwórz element roboczy połączony z gałęzią.
W obszarze Rozwój elementu roboczego wybierz pozycję Stwórz pull request.
Link umożliwia przejście do strony, na której można wprowadzić szczegóły PR i utworzyć PR.
Dodawanie aktualizacji przy użyciu funkcji cherry-pick
Zatwierdzenia można skopiować z jednej gałęzi do innej przy użyciu narzędzia cherry-pick. W przeciwieństwie do scalania lub "rebase", "cherry-pick" przenosi tylko zmiany z wybranych commitów, zamiast wszystkich zmian w gałęzi.
Aby wybrać zmiany z ukończonego pull requesta, wybierz opcję Cherry-pick na stronie Przegląd pull requesta. Aby skopiować zmiany z aktywnego żądania ściągnięcia, wybierz pozycję cherry-pick z menu więcej opcji żądania ściągnięcia. Ta akcja powoduje utworzenie nowej gałęzi z skopiowanymi zmianami. Następnie możesz utworzyć nowy PR z nowej gałęzi. Aby uzyskać szczegółowe instrukcje, zobacz Kopiowanie zmian za pomocą cherry-pick.
Przełącz gałęzie źródłową i docelową pull requesta
Przed pierwszym zapisaniem żądania ściągnięcia można przełączyć gałęzie źródłowe i docelowe żądania ściągnięcia, wybierając Przełącz źródło i gałęzie docelowe obok nazw gałęzi. Gdy PR jest aktywny, ta ikona zniknie, ale nadal można zmienić gałąź docelową PR.
Korzystanie z szablonów pull requestów
Szablon pull requestu to plik zawierający tekst Markdown, który automatycznie wypełnia opis tego żądania podczas jego tworzenia. Dobre opisy PR informują recenzentów, czego się spodziewać, i mogą pomóc w śledzeniu zadań, takich jak dodawanie testów jednostkowych i aktualizowanie dokumentacji. Twój zespół może utworzyć domyślny szablon pull request, który dodaje tekst do wszystkich nowych opisów pull request w repozytorium. Ponadto możesz wybrać szablony specyficzne dla gałęzi lub inne szablony zdefiniowane przez zespół. Aby uzyskać więcej informacji na temat tworzenia i używania szablonów pull requestów, zobacz Ulepszanie opisów pull requestów za pomocą szablonów.
Jeśli repozytorium ma szablon domyślny, wszystkie żądania ściągnięcia w repozytorium mają domyślny tekst opisu szablonu w momencie tworzenia. Aby dodać inne szablony, wybierz pozycję Dodaj szablon, a następnie wybierz szablon z listy rozwijanej. Możesz edytować tekst szablonu w opisie, usunąć go lub dodać inny tekst.
Utwórz wersje robocze pull requestów
Jeśli pull request nie jest gotowy do przeglądu, możesz utworzyć wersję roboczą pull request, aby zasygnalizować pracę w toku. Gdy pull request jest gotowy do przeglądu, możesz go opublikować i rozpocząć lub wznowić pełny przegląd.
Szkice pull requestów różnią się od opublikowanych pull requestów następującymi cechami:
Zasady weryfikacji kompilacji nie są uruchamiane automatycznie. Możesz ręcznie kolejkować walidacje budowy, wybierając menu z większą liczbą opcji w pull requeście.
Głosowanie jest wyłączone w trybie roboczym.
Wymagani recenzenci nie są automatycznie dodawani. Powiadomienia są wysyłane tylko do recenzentów, których jawnie dodasz do wersji roboczej żądania pull.
Robocze żądania ściągnięcia są wyświetlane na liście żądań ściągnięcia ze znaczkiem Draft.
Aby utworzyć wersję roboczą pull requesta, wybierz strzałkę obok Utwórz i wybierz pozycję Utwórz jako wersję roboczą podczas tworzenia pull requesta. Nie musisz używać prefiksów tytułu, takich jak WIP
lub DO NOT MERGE
.
Gdy będziesz gotowy do przejrzenia i ukończenia PR, wybierz pozycję Publikuj w prawym górnym rogu PR. Publikowanie prośby o scalenie przypisuje niezbędnych recenzentów, ocenia zasady i rozpoczyna głosowanie.
Aby zmienić istniejące opublikowane żądanie ściągnięcia na wersję roboczą, wybierz opcję Oznacz jako wersję roboczą. Oznaczanie PR jako projekt usuwa wszystkie istniejące głosy.
Dodawanie lub edytowanie tytułu i opisu żądania ściągnięcia
Na stronie nowego żądania ściągnięcia wprowadź tytuł oraz szczegółowy opis zmian, aby inni mogli zobaczyć, jakie problemy zmiany te rozwiązują. W przypadku nowego żądania ściągnięcia, tak jak w istniejących żądaniach ściągnięcia, możesz wyświetlić Files i Commits na osobnych kartach żądania ściągnięcia. Możesz dodawać recenzentów, łączyć elementy robocze i dodawać tagi do pull requesta.
Gdy będziesz gotowy do przejrzenia swoich zmian, wybierz pozycję Utwórz, aby utworzyć pull request.
Nie martw się, jeśli nie masz wszystkich zadań, recenzentów ani szczegółów gotowych podczas tworzenia pull requesta. Te elementy można dodawać lub aktualizować po utworzeniu żądania ściągnięcia.
Edycja tytułu i opisu PR
Utrzymuj aktualność tytułu i opisu PR, aby recenzenci mogli zrozumieć zmiany w PR.
Możesz zaktualizować tytuł istniejącego pull requestu, wybierając go i zmieniając tekst. Wybierz ikonę Zapisz, aby zapisać zmiany, lub wybierz ikonę Cofnij, aby odrzucić zmiany.
Edytuj opis pull requestu, wybierając ikonę Edytuj w sekcji Opis.
Dodawanie recenzentów do żądania ściągnięcia
W części Recenzenci nowego lub istniejącego pull requestu można dodać recenzentów. Możesz również zmienić opcjonalnych recenzentów na wymagane, zmienić wymaganych recenzentów na opcjonalne lub usunąć je, chyba że są one wymagane przez zasady.
Zasady gałęzi mogą wymagać minimalnej liczby recenzentów lub automatycznie uwzględnić niektórych opcjonalnych lub wymaganych recenzentów w pull requestach. Nie można usunąć recenzentów wymaganych przez zasady gałęzi, ale możesz zmienić opcjonalnych recenzentów na wymagane lub usunąć je.
Aby zobaczyć zasady gałęzi, które automatycznie dodały recenzenta, wybierz prawym przyciskiem Więcej opcji obok recenzenta w sekcji Recenzenci na stronie Przegląd PR.
Jeśli użytkownik lub grupa, który/a ma przejrzeć twoją prośbę o wciągnięcie (PR), nie jest członkiem projektu, upewnij się, że dodasz ich do projektu przed dodaniem ich jako recenzentów.
Aby dodać recenzentów do nowego pull requestu, wykonaj następujące czynności:
- Na stronie Nowe żądanie ściągnięcia w obszarze Recenzenciwybierz pozycję Wyszukaj użytkowników i grupy, aby dodać jako recenzentów.
- Podczas wprowadzania nazwy lub adresu e-mail lista rozwijana zawiera listę pasujących użytkowników i grup. Wybierz nazwy z listy, aby dodać jako opcjonalnych recenzentów.
- Aby dodać wymaganych recenzentów, wybierz pozycję Dodaj wymaganych recenzentów, a następnie wybierz pozycję Wyszukaj, aby wyszukać i wybrać nazwy.
Aby dodać recenzentów do istniejącego żądania ściągnięcia, wykonaj następujące czynności:
W sekcji Recenzenci na stronie Przegląd wybierz Dodaj, a następnie wybierz Wymagany recenzent lub Opcjonalny recenzent.
omówienie pull requestu
Podczas wprowadzania nazwy lub adresu e-mail zostanie wyświetlona lista pasujących użytkowników lub grup. Wybierz nazwy, które mają zostać dodane jako recenzenci.
Aby zmienić recenzenta między wymaganym i opcjonalnym lub usunąć recenzenta, wybierz pozycję Więcej opcji (⋮) po prawej stronie nazwy recenzenta. Aby wyświetlić członkostwo grupy lub zespołu wyznaczonego jako recenzent, wybierz ikonę grupy.
Łączenie elementów roboczych z żądaniem ściągnięcia
Aby połączyć elementy robocze z nowym pull requestem, wykonaj następujące czynności:
- Na stronie Nowe żądanie przeciągnięcia, w sekcji Elementy robocze do połączenia, wybierz Wyszukaj elementy robocze według identyfikatora lub tytułu.
- Zacznij wpisywać identyfikator lub tytuł elementu roboczego, a następnie wybierz element roboczy z wyświetlonej listy rozwijanej, aby go połączyć.
- Wyszukiwanie według tytułu zwraca elementy robocze filtrowane według stanu; wszystkie elementy robocze ze stanami sklasyfikowanymi jako ukończone i usunięte są wykluczone.
- Te elementy robocze są również filtrowane według daty i użytkownika, pokazując tylko elementy utworzone lub zaktualizowane w ciągu ostatnich 30 dni. Powinny być tworzone przez bieżącego użytkownika, przypisane do niego lub autoryzowane jako on.
Aby połączyć zadania z istniejącym PR, wykonaj następujące czynności:
Na karcie Przegląd w obszarze elementy robocze wybierz +.
Wprowadź identyfikator elementu roboczego lub wyszukaj tytuł elementu roboczego. Wybierz element roboczy z wyświetlonej listy.
Usuń link elementu roboczego, wybierając ikonę x obok elementu roboczego. Usunięcie łącza spowoduje usunięcie tylko połączenia między elementem roboczym a żądaniem ściągnięcia. Linki utworzone w gałęzi lub z commitów pozostają w elemencie roboczym.
Dodawanie tagów do pull requesta
Użyj tagów, aby pokazać ważne szczegóły i ułatwić organizowanie PR. Tagi mogą przekazywać dodatkowe informacje recenzentom, takie jak to, że PR jest nadal w toku lub że stanowi hotfix dla nadchodzącej wersji.
Aby dodać tag podczas tworzenia żądania ściągnięcia, wpisz nazwę tagu w sekcji Tagi. Po utworzeniu pull request można zarządzać tagami w sekcji Tagi.
Dodawanie załączników do żądań ściągnięcia
Pliki, w tym obrazy, można dołączać do żądania ściągnięcia podczas tworzenia lub po jego utworzeniu. Wybierz ikonę spinacza poniżej pola Opis lub przeciągnij i upuść pliki bezpośrednio do pola Opis żądania połączenia.
Zmiana gałęzi docelowej aktywnego pull requesta
W przypadku większości zespołów prawie wszystkie PR-y są przeznaczone dla gałęzi domyślnej, takiej jak main
lub develop
. Jeśli czasami trzeba skierować na inną gałąź, łatwo zapomnieć o zmianie gałęzi docelowej podczas tworzenia prośby o ściągnięcie. W takim przypadku możesz zmienić gałąź docelową aktywnego pull requesta:
- Wybierz pozycję Więcej akcji w prawym górnym rogu strony PR Przegląd, a następnie wybierz pozycję Zmień gałąź docelową z menu rozwijanego.
- W panelu Zmień gałąź docelową wybierz Wybierz gałąź docelową, wybierz nową gałąź, a następnie wybierz Zmień.
Wysyłanie powiadomień o żądaniach ściągnięcia wiadomości e-mail do uczestników projektu
Możesz udostępnić pull request e-mailem, aby powiadomić recenzentów i komunikować się z członkami zespołu. Aby udostępnić pull request:
Wybierz pozycję Więcej opcji na stronie Przegląd pull requesta, a następnie wybierz pozycję Udostępnij pull requesta.
Na ekranie udostępniania żądania ściągnięcia dodaj adresatów, wpisując ich nazwy użytkowników w polu Do: i wybierając z wyświetlonych nazw użytkowników. Można również usunąć adresatów.
Dodaj opcjonalny komunikat w polu Uwaga (opcjonalnie), a następnie wybierz Wyślij. Adresaci otrzymują wiadomość e-mail z prośbą o uwagę oraz linkiem do pull requestu.
Uwaga
W przypadku korzystania z wbudowanej funkcji poczty e-mail można wysyłać wiadomości e-mail tylko na adresy poszczególnych członków projektu. Dodanie grupy zespołu lub grupy zabezpieczeń do wiersza Do: nie jest obsługiwane. W przypadku dodania nierozpoznanego adresu e-mail zostanie wyświetlony komunikat z informacją, że co najmniej jeden adresat nie ma uprawnień do odczytu przesłanego żądania ściągnięcia.
Aby funkcja poczty e-mail działała, administrator musi skonfigurować serwer SMTP.