Udostępnij za pośrednictwem

Pojęcia związane z bramami wdrażania

  • Artykuł

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

Bramy wdrażania w usłudze Azure Pipelines są dodawane do potoków wdrażania, aby zapewnić, że wdrożenia spełniają określone kryteria przed kontynuowaniem. Bramy są niezbędne do zapewnienia, że wdrożenia są niezawodne i bezpieczne, wymuszając rygorystyczne kontrole prowadzące do bardziej stabilnych i bezpiecznych wydań oprogramowania.

Bramy są definiowane w warunkach przed wdrożeniem i po wdrożeniu etapu wydania. Zapewniają mechanizm do automatycznego zbierania sygnałów kondycji z usług zewnętrznych, takich jak Azure Functions lub interfejsy API REST, aby kontrolować promocję wydań na podstawie tych sygnałów. Bramy działają z zatwierdzeniami, aby upewnić się, że odpowiedni interesariusze zatwierdzają wydanie, a wydanie spełnia niezbędne kryteria jakości i zgodności.

Przypadki użycia

Oto niektóre typowe przypadki użycia bram wdrożeniowych:

  • zarządzanie zdarzeniami: przed kontynuowaniem wdrażania upewnij się, że zostały spełnione określone kryteria. Na przykład upewnij się, że wdrożenie ma miejsce tylko wtedy, gdy nie istnieją żadne usterki o priorytcie zerowym.
  • Szukaj zatwierdzeń: integracja z usługą Microsoft Teams lub Slack w celu powiadamiania użytkowników zewnętrznych, takich jak audytorzy, lub menedżerów IT dotyczących wdrożenia i oczekiwania na ich zatwierdzenia.
  • walidacja jakości: Metryki potoku zapytań, takie jak współczynnik zdawalności lub pokrycie kodu, wdrażaj tylko wtedy, gdy znajdują się w ustalonym progu.
  • skanowanie zabezpieczeń: przeprowadź kontrole zabezpieczeń, takie jak skanowanie artefaktów, podpisywanie kodu i sprawdzanie zasad. Brama wdrożenia może zainicjować skanowanie i poczekać na jego zakończenie lub po prostu sprawdzić, czy zostało zakończone.
  • Doświadczenie użytkownika względem punktu odniesienia: użyj zbierania danych produktu, aby zapewnić regresje doświadczenia użytkownika względem stanu punktu odniesienia. Metryki doświadczenia użytkownika przed wdrożeniem mogą być używane jako punkt odniesienia.
  • zarządzanie zmianami: przed kontynuowaniem wdrażania poczekaj na ukończenie procedur zarządzania zmianami w systemie, takim jak ServiceNow.
  • Stan zdrowia infrastruktury: Przeprowadź monitorowanie i zweryfikuj zgodność infrastruktury z regułami po wdrożeniu lub poczekaj na pożądane wykorzystanie zasobów oraz pozytywny raport zabezpieczeń.

Większość parametrów zdrowotnych zmienia się w czasie, regularnie zmieniając swój stan z dobrego stanu zdrowia na zły stan zdrowia i z powrotem do dobrego stanu zdrowia. Aby uwzględnić takie odmiany, wszystkie bramy są okresowo ponownie oceniane, dopóki wszystkie z nich nie zostaną wykonane w tym samym czasie. Wykonanie wydania i wdrożenie nie będzie kontynuowane, dopóki wszystkie bramy nie zakończą się powodzeniem w tym samym przedziale czasowym i przed skonfigurowanym limitem czasu.

Definiowanie bramy dla etapu

Bramy można włączyć na początku etapu (warunki przed wdrożeniem) lub na końcu etapu (warunki po wdrożeniu) lub dla obu tych warunków. Aby uzyskać więcej informacji, zobacz Konfigurowanie bram.

Opóźnienie przed oceną jest opóźnieniem czasowym u początku procesu oceny bram, które umożliwia bramom inicjację, stabilizację i początek dostarczania dokładnych wyników dla aktualnego wdrożenia. Aby uzyskać więcej informacji, zobacz przepływy oceny Gate.

Zrzut ekranu przedstawiający funkcję opóźnienia przed oceną w zaporach.

  • Dla bram przedwdrożenia , opóźnienie stanowiłoby czas wymagany do zarejestrowania wszystkich usterek dotyczących wdrażanych artefaktów.
  • W przypadku bram po wdrożeniuopóźnienie to maksymalny czas potrzebny na osiągnięcie stałego stanu operacyjnego wdrożonej aplikacji, czas potrzebny na wykonanie wszystkich wymaganych testów na wdrożonym etapie i czas potrzebny na zarejestrowanie zdarzeń po wdrożeniu.

Domyślnie dostępne są następujące bramy:

  • Wywołaj funkcję platformy Azure: wyzwalanie wykonywania funkcji platformy Azure i zapewnienie pomyślnego ukończenia. Aby uzyskać więcej informacji, zobacz zadanie funkcji Azure .
  • Wykonywanie zapytań o alerty usługi Azure mMnitor: Obserwuj skonfigurowane reguły alertów usługi Azure Monitor dla aktywnych alertów. Aby uzyskać więcej informacji, zobacz zadanie usługi Azure Monitor.
  • Wywołaj interfejs API REST: wykonaj wywołanie interfejsu API REST i kontynuuj, jeśli zwróci on pomyślną odpowiedź. Aby uzyskać więcej informacji, zobacz Wywołaj zadanie interfejsu API REST.
  • Wykonywanie zapytań o elementy robocze: upewnij się, że liczba pasujących elementów roboczych zwróconych z zapytania mieści się w progu. Aby uzyskać więcej informacji, zobacz zadanie "Query Work Items" .
  • Sprawdź zgodność usługi Azure Policy: Ocena zgodności usługi Azure Policy z zasobami w zakresie danej subskrypcji i grupy zasobów oraz opcjonalnie na określonym poziomie zasobów. Aby uzyskać więcej informacji, zobacz zadanie zgodności z polityką Azure .

Zrzut ekranu przedstawiający bramy domyślne.

Możesz również utworzyć własne bramy przy użyciu rozszerzeń witryny Marketplace.

Opcje oceny, które mają zastosowanie do wszystkich bram, to:

  • czas między ponowną oceną bram. Przedział czasu między kolejnymi ocenami bram. W każdym interwale próbkowania nowe żądania są wysyłane współbieżnie do każdej bramy, a nowe wyniki są oceniane. Zaleca się, aby interwał próbkowania był większy niż najdłuższy typowy czas odpowiedzi skonfigurowanych bram, aby umożliwić czas odebrania wszystkich odpowiedzi na ocenę.
  • limit czasu, po którym bramy kończą się niepowodzeniem. Maksymalny okres oceny dla wszystkich bram. Wdrożenie zostanie odrzucone, jeśli osiągnięty zostanie limit czasu, zanim wszystkie bramy odniosą sukces w tym samym interwale próbkowania.
  • Gates i zatwierdzenia. Wybierz wymaganą kolejność wykonywania dla etapów i zatwierdzeń, jeśli skonfigurowano oba. W przypadku warunków przed wdrożeniem ustawieniem domyślnym jest najpierw wyświetlanie monitów o ręczne zatwierdzenia użytkownika, a następnie ocena bram. Dzięki temu system unika oceny funkcji bram, jeśli użytkownik odrzuci wydanie. W warunkach po wdrożeniu domyślnie ocenia się bramy i prosi o ręczne zatwierdzenia tylko wtedy, gdy wszystkie bramy przejdą pomyślnie, zapewniając, że osoby zatwierdzające mają wszystkie informacje wymagane do zaakceptowania wydania.

Aby uzyskać więcej informacji na temat analizy bram, zobacz Wyświetlanie dzienników zatwierdzeń i Monitorowanie i śledzenie wdrożeń.

Przykłady przepływu oceny bramy

Na poniższym diagramie przedstawiono przepływ oceny bramy, w którym po początkowym okresie opóźnienia stabilizacji i trzech interwałach próbkowania wdrożenie jest zatwierdzane.

Zrzut ekranu przedstawiający diagram przepływu oceny bram.

Na poniższym diagramie przedstawiono przebieg oceny bramek, gdzie po początkowym okresie opóźnienia stabilizacji nie wszystkie bramki działały prawidłowo w każdym odstępie próbkowania. W takim przypadku po wygaśnięciu limitu czasu wdrożenie zostanie odrzucone.

Zrzut ekranu przedstawiający przykłady zatwierdzeń i błędów bram.