Udostępnij przez


Konfigurowanie ustawień aktualizacji usługi dla wystąpień usługi API Management

DOTYCZY: Podstawowa | Standardowa | Premia

W tym artykule przedstawiono sposób konfigurowania ustawień aktualizacji usługi (wersja wstępna) w wystąpieniu Zarządzania API. Platforma Azure okresowo stosuje aktualizacje usługi automatycznie do wystąpień usługi API Management przy użyciu podejścia do wdrażania etapowego. Te aktualizacje obejmują nowe funkcje, ulepszenia zabezpieczeń i ulepszenia niezawodności.

Nie można kontrolować dokładnie, kiedy platforma Azure aktualizuje każde wystąpienie usługi API Management, ale w obszarze wybierania warstw usług można wybrać grupę aktualizacji dla danego wystąpienia, aby otrzymywać aktualizacje wcześniej lub później niż zwykle podczas wdrażania aktualizacji. Możesz również skonfigurować okno obsługi w ciągu dnia, kiedy chcesz, aby instancja otrzymywała aktualizacje.

Aktualizowanie grupy

Grupa aktualizacji (nazywana również kanałem wydania) to zestaw wystąpień, które otrzymują aktualizacje usługi API Management podczas wdrażania produkcyjnego, co może potrwać od kilku dni do kilku tygodni.

Aktualizowanie grupy Description
AI Gateway Early (kanał dystrybucji GenAI) Uzyskuje wczesny dostęp do najnowszych funkcji i aktualizacji bramy AI, zanim dotrą do innych grup aktualizacji.

Łączy najbardziej stabilne aktualizacje usługi głównej z najnowszymi funkcjami specyficznymi dla sztucznej inteligencji. Odbiera inne aktualizacje usługi w ramach grupy późnej aktualizacji, umożliwiając szybsze wdrażanie funkcji związanych ze sztuczną inteligencją.
Wczesny Otrzymuje aktualizacje na wczesnym etapie wdrażania na potrzeby testowania i wczesnego dostępu do nowych funkcji. Ta opcja nie jest zalecana w przypadku wdrożeń produkcyjnych.
Wartość domyślna Otrzymuje aktualizacje w ramach regularnego wdrażania wydania. Ta opcja jest zalecana w przypadku większości usług, w tym wdrożeń produkcyjnych.
Opóźnienie Odbiera aktualizacje później niż poprzednie grupy, zazwyczaj kilka tygodni po początkowym wdrożeniu. Ta opcja jest zalecana tylko w przypadku wdrożeń o znaczeniu krytycznym.

Uwaga / Notatka

  • Platforma Azure wdraża wszystkie aktualizacje przy użyciu struktury bezpiecznych rozwiązań wdrażania (SDP). Aktualizacje wydane na wczesnym etapie wdrażania mogą być mniej stabilne i zastąpione później przez stabilne wersje. Wszystkie wystąpienia zostaną ostatecznie zaktualizowane do najbardziej stabilnych wersji.
  • Wszystkie grupy aktualizacji mogą zawierać funkcje w wersji zapoznawczej. Funkcje w wersji zapoznawczej są wyraźnie widoczne w witrynie Azure Portal i dokumentacji.
  • Funkcje propagują się za pomocą grup aktualizacji w tej sekwencji: AI Gateway Early (tylko funkcje AI) → wczesnedomyślnepóźne.

Na przykład możesz dodać wystąpienie testowe do grupy wczesnej aktualizacji. To wystąpienie otrzymuje aktualizacje przed wystąpieniami produkcyjnymi, które umieszczasz w grupie aktualizacji Domyślna lub Opóźniona. Możesz monitorować wystąpienie testowe pod kątem wszelkich problemów spowodowanych przez aktualizacje, zanim dotrą do wystąpień produkcyjnych. Dowiedz się więcej o wdrożeniach kanarkowych z API Management

Okno obsługi

Okno obsługi to 8-godzinny okres dzienny, w którym Twoje wystąpienie ma otrzymywać aktualizacje. Domyślnie okno konserwacyjne trwa w godzinach od 22:00 wieczorem do 6:00 rano w strefie czasowej wystąpienia.

Przerwy w działaniu usługi są rzadkie podczas aktualizacji, ale możesz zmniejszyć ryzyko, wybierając czas niskiego użycia usługi. Na przykład w przypadku wystąpień produkcyjnych należy ustawić okno obsługi na wieczory w dni powszednie i poranki w weekendy.

Konfigurowanie ustawień aktualizacji usługi

  1. Zaloguj się do portalu Azure i przejdź do instancji usługi Zarządzanie interfejsami API.
  2. W menu po lewej stronie wybierz pozycję Wdrażanie i ustawienia aktualizacji usługi infrastruktury>.
  3. W obszarze Grupa aktualizacji przejrzyj bieżące ustawienie i wybierz pozycję Edytuj , aby ją zmienić.
  4. W oknie Konserwacja przejrzyj bieżące ustawienia i wybierz pozycję Edytuj , aby je zmienić. Dla każdego dnia można wybrać domyślne okno, inne standardowe okno lub niestandardowe okno według dnia.

Dowiedz się, kiedy wystąpienia otrzymują aktualizacje

Oto jak dowiedzieć się więcej na temat oczekiwanych lub w toku aktualizacji usług.

  • Aktualizacje usługi API Management są ogłaszane w repozytorium GitHub usługi API Management. Subskrybuj, aby otrzymywać powiadomienia z tego repozytorium, aby wiedzieć, kiedy rozpoczynają się wdrożenia aktualizacji.

  • Użyj dziennika aktywności platformy Azure, aby monitorować aktualizacje usług, które mają miejsce w wystąpieniu usługi API Management. Zdarzenie "Zaplanowana konserwacja" jest emitowane po rozpoczęciu aktualizacji.

    Zaplanowane zdarzenie konserwacyjne w dzienniku aktywności w portalu.

    Aby otrzymywać powiadomienia automatycznie, skonfiguruj alert w dzienniku aktywności.

  • Domyślnie aktualizacje są wdrażane w regionach w następujących fazach: Regiony usługi Azure EUAP, a następnie Zachodnie środkowe stany USA, a następnie pozostałe regiony w kilku kolejnych fazach. Sekwencja regionów zaktualizowanych w późniejszych fazach wdrażania różni się od usługi do usługi. Można oczekiwać co najmniej 24 godzin między poszczególnymi fazami wdrożenia produkcyjnego.

  • W obrębie regionu wystąpienia usługi API Management w warstwie Premium otrzymują aktualizacje kilka godzin później niż w innych warstwach usług.

Wskazówka

Jeśli wystąpienie usługi API Management jest wdrażane w wielu lokalizacjach (regionach), czas aktualizacji jest określany przez lokalizację podstawową wystąpienia.

Strategie wdrażania kanarkowego

Możesz użyć wystąpienia usługi API Management przypisanego do określonej grupy aktualizacji (jeśli ta opcja jest dostępna) lub wdrożonego w określonym regionie platformy Azure jako wdrożenie kanarkowe, które odbiera aktualizacje wcześniej niż twoje wystąpienia produkcyjne.

  • Dodaj wystąpienie do grupy wczesnego dostępu — użyj wystąpienia usługi API Management w grupie wczesnego dostępu, aby zweryfikować aktualizacje na wcześniejszym etapie wdrożenia produkcyjnego. To wystąpienie jest skutecznie twoim wdrożeniem kanarowym.

  • Wdrażanie w regionie kanargu — jeśli masz dostęp do regionu euap platformy Azure, użyj wystąpienia, aby zweryfikować aktualizacje zaraz po wydaniu potoku produkcyjnego. Dowiedz się więcej o procesie żądania dostępu do regionu świadczenia usługi Azure.

    Uwaga / Notatka

    Ze względu na ograniczenia pojemności w regionach EUAP możesz nie być w stanie skalować wystąpień usługi API Management w razie potrzeby.

  • Wdrażanie w regionie pilotażowym — użyj instancji w regionie Zachodnio-centralne USA, aby zasymulować środowisko produkcyjne lub użyj jej w środowisku produkcyjnym dla niekrytycznego ruchu interfejsu API. Chociaż ten region otrzymuje aktualizacje po regionach EUAP, wdrożenie w tym regionie ma większe szanse na zidentyfikowanie regresji specyficznych dla konfiguracji Twojej usługi.

  • Wdrażanie zduplikowanych instancji w regionie — jeśli Twoje obciążenie produkcyjne jest instancją w warstwie Premium w określonym regionie, rozważ wdrożenie podobnie skonfigurowanej instancji w niższej warstwie, która otrzymuje aktualizacje wcześniej. Na przykład skonfiguruj wystąpienie przedprodukcyjne w warstwie Deweloper, aby zweryfikować aktualizacje.

  • Dowiedz się , jak monitorować wystąpienie usługi API Management.
  • Dowiedz się więcej o innych sposobach na obserwowanie wystąpienia usługi API Management.