Przetwarzanie żądania ściągnięcia

Po otwarciu żądania ściągnięcia żądanie ściągnięcia żądanie ściągnięcia przechodzi zestaw kontroli i przeglądów, aby upewnić się, że proponowane zmiany można scalić. Aby uzyskać więcej informacji na temat żądania ściągnięcia, zobacz Podstawy usług Git i GitHub.

Sprawdzanie poprawności

Zanim żądanie ściągnięcia zostanie scalone z gałęzią docelową, może być wymagane przejście przez co najmniej jeden proces weryfikacji żądań ściągnięcia. Po wybraniu pozycji Utwórz żądanie ściągnięcia usługa GitHub uruchamia walidacje skonfigurowane dla repozytorium. Po zakończeniu procesu weryfikacji wyniki są wyświetlane w żądaniu ściągnięcia.

Procesy weryfikacji różnią się w zależności od zakresu proponowanych zmian i reguł repozytorium docelowego. Po przesłaniu żądania ściągnięcia można oczekiwać, że nastąpi co najmniej jedna z następujących czynności:

• Możliwość scalania: test scalania w usłudze GitHub punktu odniesienia najpierw sprawdza, czy proponowane zmiany w gałęzi powodują konflikt z gałęzią docelową. Jeśli żądanie ściągnięcia wskazuje, że ten test zakończył się niepowodzeniem, należy uzgodnić zawartość powodującą konflikt scalania, zanim będzie można kontynuować przetwarzanie.
• Umowa licencyjna współtworzenia (CLA): Jako współautor firmy innej niż Microsoft, jeśli współtworzesz repozytorium publiczne, możesz zostać poproszony o ukończenie krótkiej umowy CLA przy pierwszym przesłaniu żądania ściągnięcia do tego repozytorium. Po wyczyszczonej operacji CLA twoje żądanie ściągnięcia jest przetwarzane.
• Etykietowanie: etykiety są automatycznie stosowane do żądania ściągnięcia, aby wskazać stan żądania ściągnięcia podczas przechodzenia przez przepływ pracy weryfikacji. Na przykład nowe żądania ściągnięcia mogą automatycznie otrzymywać etykietę "nie scalaj", co oznacza, że żądanie ściągnięcia nie zakończyło jeszcze czynności weryfikacji, przeglądu i wylogowania.
• Weryfikacja i kompilacja: zautomatyzowane kontrole sprawdzają, czy zmiany przeszły testy weryfikacyjne. Testy weryfikacyjne mogą zwracać ostrzeżenia lub błędy, co wymaga edycji co najmniej jednego pliku w żądaniu ściągnięcia, zanim będzie można je scalić. Wyniki testu weryfikacji są dodawane jako komentarz w żądaniu ściągnięcia do przeglądu i mogą być wysyłane do Ciebie w wiadomości e-mail.
• Przejściowe: po pomyślnej weryfikacji i kompilacji artykuły, które zostały zmienione, są automatycznie wdrażane w środowisku przejściowym w celu przejrzenia. Adresy URL podglądu są udostępniane w komentarzu do żądania ściągnięcia.
• Automatyczne scalanie: Żądanie ściągnięcia może zostać automatycznie scalone, jeśli przejdzie testy poprawności i określone kryteria. W takim przypadku nie musisz wykonywać żadnych innych czynności.

Przeglądanie i rozwiązywanie problemów z opinią

Po zakończeniu przetwarzania wszystkich żądań ściągnięcia należy przejrzeć wyniki (na przykład komentarze do żądania ściągnięcia, wyniki kompilacji). Określ, czy przed rozpoczęciem scalania musisz wprowadzić więcej zmian. Może być konieczne zmianę zawartości z dowolnego z następujących powodów:

• Komentarze do żądania ściągnięcia od recenzentów. Jeśli recenzent żądania ściągnięcia przejrzył żądanie ściągnięcia, może przekazać opinię za pośrednictwem komentarzy, jeśli przed scaleniem zostaną rozwiązane zaległe problemy lub pytania.
• Opinie recenzentów równorzędnych.
• Poprawki formatowania spowodowane problemami z renderowaniem.
• Błędy weryfikacji lub ostrzeżenia.
• Konflikty scalania.

Jeśli musisz wprowadzić zmiany, możesz edytować zawartość bezpośrednio w żądaniu ściągnięcia lub wrócić do programu VS Code, aby wprowadzić zmiany. Po zakończeniu zatwierdź zmiany w gałęzi roboczej. Żądanie ściągnięcia jest automatycznie aktualizowane wraz ze zmianami.

Za każdym razem, gdy dodasz zatwierdzenie do tej samej gałęzi roboczej, zatwierdzenie jest dodawane automatycznie do żądania ściągnięcia. Po każdym zatwierdzeniu system publikowania automatycznie uruchamia procesy weryfikacji i przeglądu.

Automatyzacja logowania i komentarzy

Po usunięciu wszystkich błędów opinii i weryfikacji i sposobie scalenia zmian nadszedł czas, aby zalogować się do żądania ściągnięcia, tworząc nowy komentarz, który odczytuje #sign-off. Aby scalić zmiany, musisz wprowadzić #sign-off komentarz. Nawet jeśli wszystkie przeglądy i testy weryfikacji są przekazywane, odpowiadasz za użycie tego komentarza, aby poinformować recenzentów żądania ściągnięcia i administratorów repozytorium, że zmiany są gotowe do scalenia.

Gdy recenzenci określają, że żądanie ściągnięcia jest wolne od problemów i jest podpisane, zmiany są scalane z gałęzią domyślną i żądanie ściągnięcia jest zamknięte.

Automatyzacja komentarzy umożliwia użytkownikom, którzy nie mają uprawnień do zapisu w repozytorium, aby ukończyć akcję na poziomie zapisu, przypisując odpowiednią etykietę do żądania ściągnięcia. Jeśli pracujesz w repozytorium, w którym zaimplementowano automatyzację komentarzy, użyj komentarzy hasztagów wymienionych w poniższej tabeli, aby przypisać etykiety, zmienić etykiety lub zamknąć żądanie ściągnięcia. Autorzy firmy Microsoft będą również powiadamiani pocztą e-mail o przejrzeniu i wylogowaniu się za każdym razem, gdy zmiany zostaną proponowane w swoich artykułach.

Komentarz z hasztagiem	Wyniki działania
#sign-off	Automatycznie przypisuje etykietę gotowe do scalenia , aby umożliwić recenzentom w repozytorium sprawdzenie/scalenie żądania ściągnięcia. Jeśli nie jesteś autorem na liście i spróbuj zalogować się na żądanie ściągnięcia publicznego repozytorium przy użyciu #sign-off komentarza, żądanie ściągnięcia zostanie zaktualizowane, aby wskazać, że tylko autor może przypisać etykietę.
#hold-off	Usuwa etykietę gotową do scalenia, jeśli zmienisz zdanie lub popełnisz błąd. W prywatnym repozytorium powoduje to przypisanie etykiety nie scalaj.
#please-close	Zamyka żądanie ściągnięcia, jeśli nie chcesz scalić zmian.
#please-open	Otwiera zamknięte żądanie ściągnięcia lub problem.

Publikowanie

Żądanie ściągnięcia musi zostać scalone przez recenzenta żądania ściągnięcia, zanim zmiany zostaną uwzględnione w następnym zaplanowanym przebiegu publikowania. Zwykle żądania ściągnięcia są przeglądane i scalane w kolejności przesyłania.

Po zatwierdzeniu i scaleniu kontrybucyjnie proces publikowania je pobiera. W zależności od zespołu, który zarządza repozytorium, do którego współtworzysz, czasy publikowania mogą się różnić, ale zazwyczaj występują co najmniej raz w dni powszednie. Artykuły mogą zostać wyświetlone online do 45 minut po opublikowaniu.

Po opublikowaniu zmian będą one na żywo w witrynie Microsoft Learn dla innych użytkowników, od których będą się uczyć!

Następne kroki

I już! Masz udział w zawartości witryny Microsoft Learn!