Uaktualnianie wystąpienia rdzeni pakietów w lokacji — szablon usługi ARM

Każda prywatna lokacja 5G Core platformy Azure zawiera wystąpienie podstawowe pakietu, które jest natywną implementacją natywną dla chmury standardu 5GPP zdefiniowanego standardem 5G Next Generation Core (5G NGC lub 5GC). Należy okresowo uaktualnić wystąpienia rdzeni pakietów, aby uzyskać dostęp do najnowszych funkcji usługi Azure Private 5G Core i obsługiwać prywatną sieć mobilną. W tym przewodniku z instrukcjami dowiesz się, jak uaktualnić wystąpienie rdzeni pakietów przy użyciu szablonu usługi Azure Resource Manager (szablonu usługi ARM).

Szablon usługi Azure Resource Manager to plik JavaScript Object Notation (JSON), który definiuje infrastrukturę i konfigurację projektu. W szablonie używana jest składnia deklaratywna. Możesz opisać zamierzone wdrożenie bez konieczności pisania sekwencji poleceń programowania w celu utworzenia wdrożenia.

Jeśli wdrożenie zawiera wiele lokacji, zalecamy najpierw uaktualnienie rdzeni pakietów w jednej lokacji i zapewnienie pomyślnego uaktualnienia przed uaktualnieniem rdzeni pakietów w pozostałych lokacjach.

Jeśli środowisko spełnia wymagania wstępne, znasz szablony usługi ARM i planujesz uaktualnienie, wybierz przycisk Wdróż na platformie Azure . Szablon zostanie otwarty w witrynie Azure Portal.

Button to deploy the Resource Manager template to Azure.

Wymagania wstępne

  • Musisz mieć uruchomiony rdzeń pakietów. Użyj metryk platformy Azure Monitor lub pulpitów nawigacyjnych rdzeni pakietów, aby potwierdzić, że wystąpienie podstawowe pakietu działa normalnie.
  • Upewnij się, że możesz zalogować się do witryny Azure Portal przy użyciu konta z dostępem do aktywnej subskrypcji użytej do utworzenia prywatnej sieci komórkowej. To konto musi mieć wbudowaną rolę Współautor lub Właściciel w zakresie subskrypcji.
  • Zidentyfikuj nazwę lokacji hostujące wystąpienie rdzenia pakietów, które chcesz uaktualnić.
  • Jeśli używasz identyfikatora Entra firmy Microsoft do uwierzytelniania dostępu do lokalnych narzędzi do monitorowania, upewnij się, że maszyna lokalna ma podstawowy dostęp kubectl do klastra Kubernetes z włączoną obsługą usługi Azure Arc. Wymaga to podstawowego pliku kubeconfig, który można uzyskać, postępując zgodnie z podstawowym dostępem do przestrzeni nazw.

Przegląd szablonu

Szablon używany w tym przewodniku Szybki start jest jednym z szablonów szybkiego startu platformy Azure. Aby wyświetlić szablon, zobacz azuredeploy.json.

Szablon modyfikuje wersję istniejącego zasobu Microsoft.MobileNetwork/packetCoreControlPlanes . Powoduje to odinstalowanie i ponowne zainstalowanie rdzenia pakietów przy użyciu nowej wersji zasobu. Podczas tego procesu nie są modyfikowane żadne inne zasoby, chyba że zmienisz również konfigurację nowej wersji. Zasób zapewnia konfigurację funkcji sieci płaszczyzny sterowania wystąpienia podstawowego pakietu, w tym konfigurację adresu IP dla interfejsu N2.

Planowanie uaktualnienia

Zalecamy uaktualnienie wystąpienia podstawowego pakietu podczas okna obsługi, aby zminimalizować wpływ uaktualnienia na usługę.

Podczas planowania uaktualnienia upewnij się, że pozwalasz wystarczająco dużo czasu na uaktualnienie i ewentualne wycofanie w przypadku wystąpienia jakichkolwiek problemów. Uaktualnienie i wycofanie rdzeni pakietów może potrwać do dwóch godzin.

Ponadto należy wziąć pod uwagę następujące kwestie dotyczące kroków przed uaktualnieniem i po uaktualnieniu, które mogą być konieczne podczas planowania okna obsługi:

  • Zapoznaj się z informacjami o wersji podstawowej pakietu dla wersji rdzeni pakietów, do której jest uaktualniane i czy jest obsługiwana przez wersję, do której jest obecnie uruchomiona usługa Azure Stack Edge (ASE).
  • Jeśli wersja środowiska ASE jest niezgodna z wersją podstawową pakietu, do której chcesz przeprowadzić uaktualnienie, musisz najpierw uaktualnić środowisko ASE. Aby uzyskać najnowszą dostępną wersję środowiska ASE, zobacz Aktualizowanie procesora GPU usługi Azure Stack Edge Pro.
    • Jeśli obecnie używasz wersji podstawowej pakietu obsługiwanej przez środowisko ASE, możesz niezależnie uaktualnić środowisko ASE i rdzeń pakietów.
    • Jeśli obecnie używasz wersji podstawowej pakietu, do której uaktualniasz środowisko ASE, nie jest obsługiwane, możliwe, że rdzeń pakietów nie będzie działać normalnie z nową wersją środowiska ASE. W takim przypadku zalecamy zaplanowanie okna obsługi, które pozwala na uaktualnienie środowiska ASE i rdzenia pakietów. Zapoznaj się z artykułem Aktualizowanie procesora GPU usługi Azure Stack Edge Pro, aby dowiedzieć się, jak długo trwa uaktualnienie środowiska ASE.
  • Przygotuj plan testowania z wszelkimi krokami, które należy wykonać, aby zweryfikować wdrożenie po uaktualnieniu. Ten plan powinien obejmować testowanie niektórych zarejestrowanych urządzeń i sesji i wykonanie go w ramach weryfikacji uaktualnienia.
  • Zapoznaj się z informacjami o przywracaniu kopii zapasowej wdrożenia i Sprawdź uaktualnienie kroków po uaktualnieniu, które należy wykonać, aby upewnić się, że wdrożenie jest w pełni funkcjonalne. Upewnij się, że plan uaktualniania umożliwia wystarczającą ilość czasu na wykonanie tych kroków.

Uaktualnianie wystąpienia rdzeni pakietów

Tworzenie kopii zapasowych informacji o wdrożeniu

Poniższa lista zawiera dane, które zostaną utracone podczas uaktualniania rdzeni pakietów. Wykonaj kopię zapasową wszystkich informacji, które chcesz zachować; po uaktualnieniu można użyć tych informacji do ponownego skonfigurowania wystąpienia podstawowego pakietu.

  1. W zależności od metody uwierzytelniania podczas logowania się do rozproszonego śledzenia i pulpitów nawigacyjnych rdzeni pakietów:
    • Jeśli używasz identyfikatora Entra firmy Microsoft, zapisz kopię pliku YAML obiektu tajnego Kubernetes utworzonego w artykule Create Kubernetes Secret Objects (Tworzenie obiektów tajnych Kubernetes).
    • Jeśli używasz lokalnych nazw użytkowników i haseł i chcesz nadal używać tych samych poświadczeń, zapisz kopię bieżących haseł w bezpiecznej lokalizacji. 
  2. Wszystkie ślady są usuwane podczas uaktualniania i nie można ich pobrać. Jeśli chcesz zachować wszelkie ślady, przed kontynuowaniem wyeksportuj je i zapisz je bezpiecznie.
  3. Wszelkie dostosowania wprowadzone na pulpitach nawigacyjnych rdzeni pakietów nie zostaną przeniesione przez uaktualnienie. Zapoznaj się z artykułem Eksportowanie pulpitu nawigacyjnego w dokumentacji narzędzia Grafana, aby zapisać kopię zapasową pulpitów nawigacyjnych.
  4. Większość interfejsów użytkownika automatycznie zarejestruje się ponownie i ponownie utworzy wszystkie sesje po zakończeniu uaktualniania. Jeśli masz jakiekolwiek specjalne urządzenia, które wymagają ręcznego odzyskiwania po awarii rdzeni pakietu, zbierz listę tych interfejsów użytkownika i ich kroki odzyskiwania.

Uaktualnianie środowiska ASE

Jeśli określono plan uaktualnienia , który należy uaktualnić środowisko ASE, wykonaj kroki opisane w temacie Aktualizowanie procesora GPU usługi Azure Stack Edge Pro.

Uaktualnianie rdzeni pakietów

  1. Wybierz następujący link, aby zalogować się do platformy Azure i otworzyć szablon.

    Button to deploy the Resource Manager template to Azure.

  2. Wybierz lub wprowadź następujące wartości, korzystając z informacji pobranych w sekcji Wymagania wstępne.

    • Subskrypcja: wybierz subskrypcję platformy Azure użytą do utworzenia prywatnej sieci mobilnej.
    • Grupa zasobów: wybierz grupę zasobów zawierającą zasób sieci komórkowej reprezentujący prywatną sieć komórkową.
    • Region: wybierz region, w którym wdrożono prywatną sieć komórkową.
    • Istniejący rdzeń pakietów: wybierz nazwę wystąpienia rdzeni pakietów, które chcesz uaktualnić.
    • Nowa wersja: wprowadź wersję, do której chcesz uaktualnić wystąpienie podstawowe pakietu.

    Screenshot of the Azure portal showing the configuration fields for the upgrade ARM template.

    Uwaga

    Jeśli pojawi się ostrzeżenie dotyczące niezgodności między wybraną wersją rdzeni pakietów a bieżącą wersją usługi Azure Stack Edge, najpierw należy uaktualnić środowisko ASE. Wybierz pozycję Uaktualnij środowisko ASE z poziomu wiersza polecenia i postępuj zgodnie z instrukcjami w temacie Aktualizowanie procesora GPU usługi Azure Stack Edge Pro. Po zakończeniu aktualizowania środowiska ASE wróć do początku tego kroku, aby uaktualnić rdzeń pakietów.

  3. Wybierz pozycję Przejrzyj i utwórz.

  4. Platforma Azure zweryfikuje wprowadzone wartości konfiguracji. Powinien zostać wyświetlony komunikat informujący o tym, że wartości przeszły walidację.

    Jeśli walidacja zakończy się niepowodzeniem, zostanie wyświetlony komunikat o błędzie, a karty Konfiguracja zawierające nieprawidłową konfigurację zostaną oflagowane. Wybierz karty oflagowane i użyj komunikatów o błędach, aby poprawić nieprawidłową konfigurację przed powrotem do karty Przeglądanie i tworzenie .

  5. Po zweryfikowaniu konfiguracji wybierz pozycję Utwórz , aby uaktualnić wystąpienie podstawowe pakietu. W witrynie Azure Portal zostanie wyświetlony ekran potwierdzenia po uaktualnieniu wystąpienia podstawowego pakietu.

Przeglądanie wdrożonych zasobów

  1. Wybierz pozycję Przejdź do grupy zasobów.

    Screenshot of the Azure portal showing a deployment confirmation for the ARM template.

  2. Wybierz zasób płaszczyzny sterowania rdzenia pakietów reprezentujący funkcję płaszczyzny sterowania wystąpienia rdzenia pakietów w lokacji.

  3. Sprawdź pole Wersja pod nagłówkiem Konfiguracja, aby potwierdzić, że jest wyświetlana nowa wersja oprogramowania.

Przywracanie informacji o wdrożeniu kopii zapasowej

Skonfiguruj ponownie wdrożenie przy użyciu informacji zebranych w temacie Tworzenie kopii zapasowej informacji o wdrożeniu.

  1. W zależności od metody uwierzytelniania podczas logowania się do rozproszonego śledzenia i pulpitów nawigacyjnych rdzeni pakietów:

  2. Jeśli wykonano kopię zapasową wszystkich podstawowych pulpitów nawigacyjnych pakietów, postępuj zgodnie z instrukcjami importowania pulpitu nawigacyjnego w dokumentacji narzędzia Grafana, aby je przywrócić.

  3. Jeśli masz interfejsy użytkownika, które wymagają ręcznego odzyskiwania po awarii rdzeni pakietu, wykonaj kroki odzyskiwania.

Weryfikowanie uaktualnienia

Po zakończeniu uaktualniania sprawdź, czy wdrożenie działa normalnie.

  1. Użyj metryk platformy usługi Azure Monitor lub pulpitów nawigacyjnych rdzeni pakietów, aby potwierdzić, że wystąpienie podstawowe pakietu działa normalnie.
  2. Wykonaj plan testowania przygotowany w temacie Planowanie uaktualnienia.

Wycofywanie

Jeśli po uaktualnieniu wystąpią problemy, możesz wycofać wystąpienie podstawowe pakietu do poprzedniej wersji.

W tym kroku wycofasz rdzeń pakietów przy użyciu żądania interfejsu API REST. Postępuj zgodnie z instrukcjami wycofywania — witryna Azure Portal , jeśli zamiast tego chcesz wycofać się przy użyciu witryny Azure Portal.

Jeśli którakolwiek z opcji konfiguracji ustawionych podczas uruchamiania nowszej wersji wystąpienia pakietu podstawowego nie jest obsługiwana w wersji, do której chcesz przywrócić, musisz przywrócić poprzednią konfigurację, zanim będzie można wykonać wycofywanie. Zapoznaj się z informacjami o wersji podstawowej pakietu, aby uzyskać informacje o tym, kiedy wprowadzono nowe funkcje.

  1. Upewnij się, że masz kopię zapasową informacji o wdrożeniu. Jeśli musisz ponownie utworzyć kopię zapasową, wykonaj kroki tworzenia kopii zapasowej informacji o wdrożeniu.

  2. Wykonaj żądanie POST wycofania.

    Napiwek

    Aby uzyskać więcej informacji na temat korzystania z interfejsów API REST, zobacz Dokumentacja interfejsu API REST platformy Azure.

  3. Wykonaj kroki opisane w artykule Przywracanie informacji o wdrożeniu kopii zapasowej, aby ponownie skonfigurować wdrożenie.

  4. Wykonaj kroki opisane w artykule Weryfikowanie uaktualnienia , aby sprawdzić, czy wycofanie zakończyło się pomyślnie.

Następne kroki

Zakończono uaktualnianie wystąpienia podstawowego pakietu.

  • Jeśli wdrożenie zawiera wiele lokacji, uaktualnij wystąpienie rdzeni pakietów w innej lokacji.
  • Monitorowanie wdrożenia przy użyciu metryk platformy usługi Azure Monitor lub pulpitów nawigacyjnych rdzeni pakietów.