Techniki rozwiązywania problemów z błędami instalacji programu Helm podczas wdrażania konteneryzowanej funkcji sieciowej (CNF) programu Azure Operator Service Manager (AOSM)

Pliki CDF mogą być tak proste, jak pojedynczy pakiet helm z niewielką liczbą parametrów konfiguracji lub tak złożone, jak dziesiątki pakietów helm z tysiącami parametrów konfiguracji. W tym artykule opisano szereg typowych kroków rozwiązywania problemów dotyczących debugowania błędów instalacji narzędzia Helm.

Upewnij się, że pakiet helm jest poprawnie instalowany przy użyciu bezpośrednich poleceń helm

System AOSM nie może zainstalować systemu CNF utworzonego na podstawie nieprawidłowych wykresów helm lub nieprawidłowo skonfigurowanych values.yaml plików. Istnieją dwa podstawowe wymagania wstępne:

• Każdy wykres helm zawarty w systemie CNF musi zostać przekazany helm template w przypadku podania zestawu wartości używanych do wdrożenia wykresu
• helm install polecenie musi zakończyć się powodzeniem po uruchomieniu bezpośrednio w klastrze Kubernetes połączonym z usługą Azure Arc

Przetestuj, czy wykresy helm spełniają te wymagania wstępne. Upewnij się, że testujesz przy użyciu tych samych wartości narzędzia Helm, które mają być używane podczas wdrażania za pośrednictwem usługi AOSM.

• Możesz nawiązać połączenie z klastrem Kubernetes usługi Azure Operator Nexus przy użyciu połączenia klastra i zainstalować pakiet Helm w celu zainstalowania wykresów helm.

Upewnij się, że szablon usługi ARM funkcji sieciowej (NF) ma --atomic ustawioną wartość false

Domyślnie usługa AOSM usuwa nieudane instalacje z klastra w celu zmniejszenia użycia zasobów. Zapobiega to szczegółowemu debugowaniu w scenariuszach awarii. Szablon arm systemu plików NF obsługuje zastępowanie tego zachowania. Skorzystaj z tego przewodnika z instrukcjami, aby skonfigurować rozwiązanie AOSM w celu pozostawienia nieudanych instalacji.

Upewnij się, że szablon funkcji sieciowej (NF) usługi Azure Resource Manager (ARM) używa wstrzykiwania magazynu artefaktów

Usługa AOSM obsługuje dołączanie wykresów helm bezobsługowe. Ta funkcja jest skonfigurowana w szablonie arm systemu plików NF i jest automatycznie włączona w przypadku dołączenia systemu CNF przy użyciu rozszerzenia AOSM interfejsu wiersza polecenia Az.

1. Pobierz szablon arm systemu plików NF z magazynu artefaktów.
2. Upewnij się, że roleOverrideValues właściwość elementu Microsoft.HybridNetwork/networkFunctions zawiera następujący fragment kodu. Ten fragment kodu używa fikcyjnego systemu CNF firmy Contoso utworzonego na podstawie trzech niezależnych wykresów helm. Te wykresy helm są modelowane jako trzy aplikacje funkcji sieciowych w wersji definicji funkcji sieciowej (NFDV). Szablon usługi ARM powinien zawierać jeden element w tablicy roleOverrideValues dla każdej aplikacji funkcji sieciowej w systemie plików NFDV.

roleOverrideValues: ["{\"name\": \"Contoso-one\", \"deployParametersMappingRuleProfile\": {\"applicationEnablement\": \"Enabled\", \"helmMappingRuleProfile\": {\"options\": {\"installOptions\": {\"injectArtifactStoreDetails\":\"true\"}},{\"upgradeOptions\": {\"injectArtifactStoreDetails\":\"true\"}}}}},{\"name\": \"Contoso-two\", \"deployParametersMappingRuleProfile\": {\"applicationEnablement\": \"Enabled\", \"helmMappingRuleProfile\": {\"options\": {\"installOptions\": {\"injectArtifactStoreDetails\":\"true\"}},{\"upgradeOptions\": {\"injectArtifactStoreDetails\":\"true\"}}}}},{\"name\": \"Contoso-three\", \"deployParametersMappingRuleProfile\": {\"applicationEnablement\": \"Enabled\", \"helmMappingRuleProfile\": {\"options\": {\"installOptions\": {\"injectArtifactStoreDetails\":\"true\"}},{\"upgradeOptions\": {\"injectArtifactStoreDetails\":\"true\"}}}}}"]

Jeśli szablon usługi ARM nie zawiera \"injectArtifactStoreDetails\":\"true\" ustawienia dla każdej aplikacji funkcji sieciowej, zmodyfikuj szablon usługi ARM, aby uwzględnić ustawienie dla każdej aplikacji funkcji sieciowej w systemie plików NFDV i przekaż szablon usługi ARM do magazynu artefaktów.

Wyświetlanie błędu wdrażania sns przy użyciu witryny Azure Portal usługi AOSM

1. Uzyskiwanie dostępu do witryny Azure Portal i otwieranie grupy zasobów wdrożonej w usłudze sieci lokacji (SNS)
2. Wybierz stronę Wdrożenia z menu Grupa zasobów
3. Otwórz stronę wdrożenia dla wdrożenia odpowiadającego nieudanym wdrożeniu SNS i wybierz przycisk szczegóły błędu

Wyświetlanie błędu wdrożenia systemu plików NF przy użyciu witryny Azure Portal usługi AOSM

1. Uzyskiwanie dostępu do witryny Azure Portal i otwieranie grupy zasobów wdrożonej w usłudze SNS
2. Otwórz omówienie sns i kliknij link do właściwości Resources
3. Wybierz stronę Wdrożenia z menu Grupa zasobów.
4. Wybierz przycisk szczegółów błędu dla wdrożenia odpowiadającego nieudanym wdrożeniu systemu plików NF

Wyświetlanie parametrów wdrażania funkcji sieciowych przy użyciu witryny Azure Portal usługi AOSM

1. Uzyskiwanie dostępu do witryny Azure Portal i otwieranie grupy zasobów wdrożonej w usłudze SNS
2. Otwórz omówienie sns i kliknij link do właściwości Resources
3. Otwórz przegląd NF i kliknij przycisk Otwórz widok jako JSON dla właściwości Wartości wdrożenia

Ten widok przedstawia wartości, które zostały przekazane do operacji wdrażania NF. Te wartości są uwzględniane w poleceniu używanym helm install do wdrażania systemu plików NF. Błędnie skonfigurowane, nieoczekiwane, brakujące lub niepoprawnie sformatowane wartości mogą spowodować helm install niepowodzenie polecenia.

Wyświetlanie parametrów wdrażania składnika funkcji sieciowej przy użyciu witryny Azure Portal usługi AOSM

1. Uzyskiwanie dostępu do witryny Azure Portal i otwieranie grupy zasobów wdrożonej w usłudze SNS
2. Otwórz omówienie sns i kliknij link do właściwości Resources
3. Otwórz przegląd systemu plików NF i przejdź do strony Składniki z menu zasobów.
4. Naciśnij pozycję Otwórz widok jako kod JSON dla interesującego składnika.

Ten widok przedstawia wartości przekazane do wykresu helm w poleceniu helm install . Każda wartość jest przekazywana helm install do polecenia przy użyciu polecenia --set. Błędnie skonfigurowane, nieoczekiwane, brakujące lub niepoprawnie sformatowane wartości mogą spowodować helm install niepowodzenie polecenia.