Ćwiczenie — tworzenie, przeglądanie i scalanie żądania ściągnięcia

  • 5 min

Ukończono pracę w celu dodania kolejki do witryny internetowej. Teraz zespół deweloperów witryn internetowych jest gotowy, abyś scalił zmiany z gałęzią główną. W tym ćwiczeniu utworzysz i scalisz pull request dotyczący twoich zmian.

Podczas tego procesu wykonasz następujące czynności:

  • Utwórz prośbę o połączenie.
  • Przejrzyj żądanie ściągnięcia.
  • Ukończ pull request.
  • Sprawdź, czy zmiany zostały scalone.

Utwórz pull request w celu scalenia gałęzi funkcjonalności

Ponieważ nie można wypchnąć zmian bezpośrednio do głównej gałęzi repozytorium, musisz utworzyć pull request.

  1. W przeglądarce przejdź do Code.

  2. Wybierz 2 gałęzie, aby wyświetlić gałęzie w repozytorium GitHub.

    Zrzut ekranu witryny GitHub przedstawiający stronę repozytorium z wyróżnionym linkiem do listy gałęzi.

  3. Obok add-orders-queue wybierz ikonę Więcej (...), a następnie wybierz pozycję Nowe żądanie ściągnięcia.

    Zrzut ekranu witryny GitHub przedstawiający listę gałęzi. Przycisk nowego żądania dołączenia został wyróżniony dla gałęzi add-orders-queue.

  4. Podczas tworzenia żądania ściągnięcia zwróć uwagę, że usługa GitHub automatycznie użyła komunikatu zatwierdzenia usługi Git jako tytułu żądania ściągnięcia.

    Zaktualizuj opis do następującego tekstu:

    Ten PR dodaje nową kolejkę Azure Storage do przetwarzania zamówień i aktualizuje konfigurację strony internetowej, uwzględniając informacje o koncie magazynowania i kolejce.

  5. Wybierz pozycję Utwórz pull request.

    Zrzut ekranu witryny GitHub przedstawiający stronę tworzenia żądania ściągnięcia z wyróżnionym przyciskiem tworzenia żądania ściągnięcia.

  1. W przeglądarce przejdź do Repozytoria>Pliki.

    Zwróć uwagę, że usługa Azure DevOps wyświetla baner, który wskazuje na zmiany w gałęzi add-orders-queue. Baner oferuje utworzenie pull request dla tych zmian.

    Zrzut ekranu usługi Azure DevOps przedstawiający listę plików repozytorium, w tym baner z ofertą tworzenia żądania dołączenia.

  2. Wybierz pozycję Utwórz pull request.

  3. Na stronie tworzenia pull requestu zwróć uwagę, że Azure DevOps automatycznie użył komunikatu zatwierdzenia Git jako tytułu pull requestu.

    Zaktualizuj opis do następującego tekstu:

    Ten pull request dodaje nową kolejkę Azure Storage do przetwarzania zamówień i aktualizuje konfigurację witryny internetowej, aby zawierała informacje o koncie magazynu i kolejce.

  4. Wybierz pozycję Utwórz.

    Zrzut ekranu usługi Azure DevOps pokazujący stronę tworzenia żądania ściągnięcia, z wyróżnionym przyciskiem

Przejrzyj żądanie ściągnięcia

Zwykle pull request jest przeglądany przez kogoś innego niż jego autor. W tym przykładzie będziesz odgrywać rolę innego członka zespołu i przeglądać własny pull request.

  1. Na stronie pull request wybierz kartę Pliki zmienione.

    Zrzut ekranu witryny GitHub przedstawiający kartę zmienionych plików w żądaniu ściągnięcia.

    W usłudze GitHub są wyświetlane pliki, które zostały zmienione w tym żądaniu ściągnięcia. Zwróć uwagę, że wyróżnia wszystkie zmienione wiersze, dzięki czemu można łatwo zobaczyć, co należy przejrzeć.

    Napiwek

    Wyobraź sobie, że przeglądasz to dla własnego zespołu. Czy masz jakieś sugestie?

  2. W pliku main.bicep, który został zmieniony, umieść kursor nad wierszem 18 i wybierz przycisk z znak plus (+).

    Zrzut ekranu z GitHub, pokazujący zmiany w głównym pliku .bicep. Wskaźnik myszy najeżdża na wiersz 18, a przycisk do dodawania komentarzy jest wyróżniony.

  3. W polu komentarza wprowadź następujący tekst: Czy to powinno być napisane wielką literą?

  4. Wybierz Rozpocznij przegląd.

    Zrzut ekranu witryny GitHub przedstawiający pole komentarza z wyróżnionym przyciskiem umożliwiającym rozpoczęcie przeglądu.

    Napiwek

    GitHub nie pozwala na zatwierdzanie własnych pull requestów. Tutaj skomentujesz wniosek o dołączenie zmian, ale go nie zatwierdzisz. Podczas pracy z żądaniami ściągnięcia własnego zespołu jest to punkt, w którym zatwierdzisz je, aby wskazać, że chcesz je scalić.

  5. Wybierz pozycję Zakończ recenzję.

  6. W wyświetlonym panelu przeglądu wybierz pozycję Prześlij recenzję.

    Zrzut ekranu witryny GitHub przedstawiający panel do ukończenia przeglądu z wyróżnionym przyciskiem przesyłania przeglądu.

    GitHub zwraca cię do karty Konwersacja pull requestu.

  1. Na stronie żądania ściągnięcia wybierz kartę Pliki.

    zrzut ekranu usługi Azure DevOps przedstawiający pliki zmienione w żądaniu ściągnięcia.

    Usługa Azure DevOps pokazuje pliki, które zostały zmienione w tym żądaniu ściągnięcia. Zwróć uwagę, że wyróżnia wszystkie zmienione wiersze, dzięki czemu można łatwo zobaczyć, co należy przejrzeć.

    Napiwek

    Wyobraź sobie, że przeglądasz to dla własnego zespołu. Czy możesz zaproponować jakieś sugestie?

  2. W pliku main.bicep, który został zmieniony, umieść kursor nad wierszem 18 i wybierz przycisk komentarza.

    Zrzut ekranu przedstawiający usługę Azure DevOps, która pokazuje zmiany w głównym pliku .bicep. Kursor myszy znajduje się nad wierszem 18, a przycisk dodawania komentarza jest wyróżniony.

  3. W polu komentarza wprowadź następujący tekst: Czy ten tekst powinien być wielką literą?

  4. Wybierz pozycję Komentarz.

    Zrzut ekranu usługi Azure DevOps przedstawiający pole komentarza z wyróżnionym przyciskiem Komentarz.

    Szerokość okna przeglądarki może mieć wpływ na sposób wyświetlania okna dialogowego komentarza. Komentarz otworzy okno dialogowe Dyskusja, a nie wbudowany komentarz, jak pokazano na zrzucie ekranu.

  5. Wybierz Zatwierdź.

    zrzut ekranu usługi Azure DevOps przedstawiający przycisk Zatwierdź dla żądania wciągnięcia.

    Po wybraniu opcji Zatwierdźopcja Ustaw automatyczne uzupełnianie zmienia się na Zakończ. Użyjesz tej funkcji w dalszej części tego modułu.

Odpowiedz na przegląd pull requestu

Podczas tworzenia lub przeglądania żądania ściągnięcia możesz uczestniczyć w konwersacji dotyczącej jej zawartości. Wyobraź sobie, że jesteś autorem tego pliku i chcesz odpowiedzieć na komentarz recenzenta.

  1. Odpowiedz na przegląd żądania ściągnięcia z następującym komentarzem: Nie, kolejki w magazynie danych muszą mieć nazwy pisane małymi literami.

  2. Wybierz opcję Komentarz, a następnie wybierz opcję Rozwiąż konwersację, aby wskazać, że dyskusja na temat tematu się zakończyła.

    Zrzut ekranu usługi GitHub przedstawiający odpowiedź na komentarz z wyróżnionymi przyciskami wprowadzania komentarza i rozwiązywania konwersacji.

  1. Na stronie pull request wybierz zakładkę Przegląd.

    zrzut ekranu usługi Azure DevOps przedstawiający kartę Przegląd.

  2. Teraz wyobraź sobie, że jesteś autorem tego pliku. Odpowiedz na przegląd żądania ściągnięcia z następującym komentarzem: Nie, nazwy kolejek magazynowych muszą być pisane małymi literami.

  3. Wybierz Odpowiedz & Rozwiąż, aby wskazać, że dyskusja na linii się zakończyła.

    zrzut ekranu usługi Azure DevOps przedstawiający odpowiedź na komentarz z wyróżnionym przyciskiem odpowiadania i rozwiązywania.

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

Zespół odpowiedzialny za rozwój Twojej witryny potwierdził, że zamówienia mogą być wysyłane do kolejki, więc możesz przystąpić do ukończenia i połączenia swojej prośby o połączenie.

Twój pull request został zatwierdzony. Zespół deweloperów witryny internetowej potwierdził, że jest gotowy do wysłania zamówień do kolejki, więc możesz przystąpić do ukończenia i scalania żądania ściągnięcia.

  1. Wybierz Scal prośbę o ściągnięcie.

    Zrzut ekranu GitHub przedstawiający pull request z wyróżnionym przyciskiem do scalania.

  2. Usługa GitHub prosi o potwierdzenie scalania. Gdy GitHub scala pull request, tworzy commit i automatycznie generuje komunikat commitu. Wybierz , potwierdź scalanie.

    Zrzut ekranu z GitHuba przedstawiający pull request z wyróżnionym przyciskiem potwierdzenia scalenia.

    Żądanie ściągnięcia zostało scalone, a nowa funkcja znajduje się teraz w głównej gałęzi repozytorium.

  3. Dobrym rozwiązaniem jest usunięcie gałęzi funkcji po zakończeniu pracy z nimi. Usuwanie gałęzi pomaga uniknąć dezorientacji członków zespołu w przyszłości co do tego, która praca jest nadal w toku. Wybierz pozycję Usuń gałąź.

    Zrzut ekranu usługi GitHub przedstawiający pull request z wyróżnionym przyciskiem do usuwania gałęzi.

  1. Wybierz Ukończ.

    Zrzut ekranu przedstawiający usługę Azure DevOps z przyciskiem Ukończ żądanie ściągnięcia.

  2. W Zakończ żądanie ściągnięciaużyj ustawień domyślnych. Wybierz opcję Zakończ scalanie.

    Zrzut ekranu usługi Azure DevOps przedstawiający panel uzupełniania żądania ściągnięcia z wyróżnionym przyciskiem umożliwiającym ukończenie scalania.

    Żądanie ściągnięcia zostało scalone, a nowa funkcja znajduje się teraz w głównej gałęzi repozytorium.

    Usługa Azure DevOps automatycznie usunęła gałąź funkcji po scaleniu żądania ściągnięcia. Dobrym rozwiązaniem jest usunięcie gałęzi funkcji po zakończeniu pracy z nimi. Usuwanie gałęzi pomaga uniknąć wprowadzania w błąd członków zespołu w przyszłości co do tego, która praca jest nadal w toku.

Weryfikowanie zmian

Po scaleniu pull requesta, warto potwierdzić pomyślne scalenie zmian.

  1. Przejdź do Code.

  2. Przejdź do pliku deploy/main.bicep, a następnie do pliku deploy/modules/appService.bicep.

    Zrzut ekranu witryny GitHub przedstawiający listę plików repozytorium po scaleniu żądania pull.

    Zwróć uwagę, że kolejka i inne zmiany znajdują się teraz w plikach.

  1. Przejdź do Repozytoria plików>.

  2. Przejdź do pliku deploy/main.bicep, a następnie do pliku deploy/modules/appService.bicep.

    Zwróć uwagę, że kolejka i inne zmiany znajdują się teraz w plikach.