Konfigurowanie zasad rozgałęziania dla usługi zewnętrznej

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

Zasady gałęzi to zaawansowana funkcja zapewniająca wysoką jakość kodu w repozytorium przez ustanowienie wymagań dotyczących wszystkich żądań ściągnięcia. Usługi zewnętrzne mogą używać interfejsu API stanu żądania ściągnięcia do publikowania szczegółowych informacji o stanie żądań ściągnięcia. Zasady gałęzi dla usług zewnętrznych umożliwiają tym usługom innych firm uczestnictwo w przepływie pracy żądania ściągnięcia i ustalenie wymagań dotyczących zasad. Ten artykuł przeprowadzi Cię przez proces konfigurowania zasad gałęzi dla usługi, która publikuje stan żądania ściągnięcia. Aby uzyskać więcej informacji na temat stanu żądania ściągnięcia, zobacz Dostosowywanie i rozszerzanie przepływów pracy żądań ściągnięcia ze stanem żądania ściągnięcia.

Wymagania wstępne

  • Organizacja w usłudze Azure DevOps z repozytorium Git. Jeśli nie masz organizacji, zarejestruj się, aby przekazać i udostępnić kod w bezpłatnych nieograniczonych prywatnych repozytoriach Git.
  • Usługa, która publikuje stan żądania ściągnięcia. Zobacz Tworzenie serwera stanu żądania ściągnięcia.

Konfigurowanie zasad gałęzi

  1. Przejdź do obszaru Gałęzie kodu>i znajdź gałąź, w której chcesz skonfigurować zasady (zazwyczaj main lub develop). Z menu kontekstowego wybierz opcję Zasady gałęzi .

    Wybierz pozycję Zasady gałęzi z menu kontekstowego

  2. Przewiń w dół, aby znaleźć kontrole stanu. Wybierz przycisk +.

    Wybierz przycisk Dodaj zasady

  3. Wybierz usługę, dla której chcesz utworzyć zasady z listy. Jeśli stan został wcześniej opublikowany, możesz wybrać go z listy; jeśli są to nowe zasady, możesz wpisać nazwę zasad.

    Wybierz zasady z listy

    • Wymaganie zasad określa, czy te zasady są opcjonalne, czy wymagane do ukończenia żądań ściągnięcia do gałęzi.
    • Autoryzowana tożsamość jest używana do wymuszania tego stanu tylko z określonej tożsamości będzie liczone do realizacji zasad.
    • Warunki resetowania są używane do określania, kiedy stan zaksięgowany nie jest już prawidłowy. Jeśli stan opublikowany jest specyficzny dla najnowszego kodu (tj. kompilacji), zaznacz pole Resetuj stan zawsze, gdy zmienią się nowe zmiany , aby zresetować stan po zmianie gałęzi źródłowej.
    • Opcjonalnie ustaw filtr Ścieżka. Dowiedz się więcej o filtrach ścieżek w zasadach gałęzi.
    • Możliwość stosowania zasad określa, czy te zasady mają zastosowanie natychmiast po utworzeniu żądania ściągnięcia, czy też zasady mają zastosowanie tylko po opublikowaniu pierwszego stanu w żądaniu ściągnięcia.
    • Domyślna nazwa wyświetlana umożliwia określenie opcjonalnej nazwy wyświetlanej dla zasad.

Tworzenie nowego żądania ściągnięcia

  1. Utwórz nowe żądanie ściągnięcia w gałęzi, w której zdefiniowano zasady. Aby uzyskać więcej informacji, zobacz Tworzenie żądania ściągnięcia.

  2. Po utworzeniu żądania ściągnięcia nowe zasady zostaną wyświetlone w sekcji Zasady widoku szczegółów żądania ściągnięcia. Początkowo zasady będą wyświetlane jako nie ustawione do momentu opublikowania stanu usługi zewnętrznej.

    Stan zasad jest widoczny w sekcji Zasady

    Po opublikowaniu stanu usługi zasady zostaną odpowiednio zaktualizowane. Ukończenie zostanie zablokowane do momentu zatwierdzenia żądania ściągnięcia przez zasady.

    Aktualizacje stanu zasad

    Po spełnieniu kryteriów zasad, a usługa opublikuje stan, żądanie ściągnięcia succeeded zostanie zatwierdzone, a ukończenie zostanie odblokowane.

    Stan zasad zatwierdzony i odblokowany

Podsumowanie

W tym artykule przedstawiono sposób konfigurowania zasad gałęzi dla usługi zewnętrznej.