Rozwiązywanie problemów z uaktualnieniem poprawki pomocniczej dodatku usługi Istio service mesh

Artykuł
04/30/2024

W tym artykule omówiono scenariusze rozwiązywania problemów i ograniczenia w procesach pomocniczego uaktualniania i wycofywania poprawek dla dodatku usługi Istio service mesh w usłudze Microsoft Azure Kubernetes Service (AKS).

Uwaga

Istio używa terminu "poprawki", aby zaimplementować proces uaktualniania kanarek i rozróżnić wersje. Każde oznaczenie wersji (napisane jako x-y) odpowiada oznaczeniu wersji major.minor (x.y). Możesz kontrolować poprawkę płaszczyzny sterowania, ale nie możesz kontrolować określonej wersji poprawki w pasmie poprawek.

Wymagania wstępne

Interfejs wiersza polecenia platformy Azure.
Narzędzie Kubernetes kubectl lub podobne narzędzie do nawiązywania połączenia z klastrem. Aby zainstalować narzędzie kubectl przy użyciu interfejsu wiersza polecenia platformy Azure, uruchom polecenie az aks install-cli .

Macierz rozwiązywania problemów

W poniższej tabeli przedstawiono różne problemy oraz różne scenariusze i rozwiązania tych problemów.

Scenariusz	Problem	Rozwiązanie
Obciążenia płaszczyzny danych są usuwane z siatki.	Poprawki płaszczyzny danych i płaszczyzny sterowania nie odpowiadały przed ukończeniem lub wycofaniem uaktualnienia.	Wykonaj następujące czynności: Zmień etykietę przestrzeni nazw, które zawierają obciążenia, określając poprawkę, która ma istnieć po zakończeniu uaktualnienia lub wycofaniu. W tym celu uruchom polecenie kubectl label : kubectl label namespace default istio.io/rev=asm-x-y --overwrite Uruchom ponownie odpowiednie wdrożenia obciążeń, aby wyzwolić ponowne uruchomienie przyczepki poprawnej poprawki. W tym celu uruchom polecenie kubectl rollout restart : kubectl rollout restart deployment <deployment name> Sprawdź, czy obrazy przyczepki istnieją. W tym celu uruchom polecenie kubectl get : kubectl get pods --namespace <namespace> --output yaml \| grep mcr.microsoft.com/oss/istio/proxyv2:
Zasobniki płaszczyzny sterowania są w stanie oczekiwania.	Zasobniki nie mają pojemności.	Sprawdź stan zasobników, uruchamiając polecenie kubectl describe . Jeśli problemem jest pojemność, możesz skalować klaster w górę, aby dodać kolejny węzeł. Aby uzyskać więcej informacji, zobacz Ręczne skalowanie liczby węzłów w klastrze Azure Kubernetes Service (AKS).
Polecenie az aks mesh get-upgrades zwraca brak dostępnych uaktualnień.	Najnowsza poprawka istio może być niezgodna z bieżącą wersją klastra usługi AKS.	Aby dowiedzieć się, czy istnieją nowsze poprawki Istio, możesz użyć polecenia az aks mesh get-revisions . Dane wyjściowe zawierają listę zgodnych wersji klastra dla każdej poprawki istio. W związku z tym można określić, czy uaktualnienie klastra jest konieczne.

Scenariusz

Problem

Rozwiązanie

Obciążenia płaszczyzny danych są usuwane z siatki.

Poprawki płaszczyzny danych i płaszczyzny sterowania nie odpowiadały przed ukończeniem lub wycofaniem uaktualnienia.

Wykonaj następujące czynności:

Zmień etykietę przestrzeni nazw, które zawierają obciążenia, określając poprawkę, która ma istnieć po zakończeniu uaktualnienia lub wycofaniu. W tym celu uruchom polecenie kubectl label :
```
kubectl label namespace default istio.io/rev=asm-x-y --overwrite
```
Uruchom ponownie odpowiednie wdrożenia obciążeń, aby wyzwolić ponowne uruchomienie przyczepki poprawnej poprawki. W tym celu uruchom polecenie kubectl rollout restart :
```
kubectl rollout restart deployment <deployment name>
```

Sprawdź, czy obrazy przyczepki istnieją. W tym celu uruchom polecenie kubectl get :

kubectl get pods --namespace <namespace> --output yaml | grep mcr.microsoft.com/oss/istio/proxyv2:

Zasobniki płaszczyzny sterowania są w stanie oczekiwania.

Zasobniki nie mają pojemności.

Sprawdź stan zasobników, uruchamiając polecenie kubectl describe . Jeśli problemem jest pojemność, możesz skalować klaster w górę, aby dodać kolejny węzeł. Aby uzyskać więcej informacji, zobacz Ręczne skalowanie liczby węzłów w klastrze Azure Kubernetes Service (AKS).

Polecenie az aks mesh get-upgrades zwraca brak dostępnych uaktualnień.

Najnowsza poprawka istio może być niezgodna z bieżącą wersją klastra usługi AKS.

Aby dowiedzieć się, czy istnieją nowsze poprawki Istio, możesz użyć polecenia az aks mesh get-revisions . Dane wyjściowe zawierają listę zgodnych wersji klastra dla każdej poprawki istio. W związku z tym można określić, czy uaktualnienie klastra jest konieczne.

Uwaga

Aby uniknąć niezamierzonego zachowania i uszkodzonych funkcji, a także upewnić się, że otrzymujesz aktualizacje luk w zabezpieczeniach, zdecydowanie zalecamy uaktualnienie do obsługiwanej i aktualnej wersji usługi AKS i poprawki dodatku Istio. Należy pamiętać, że poprawka dodatku powinna również znajdować się w obsługiwanym zakresie wersji platformy Kubernetes dla danego klastra aks. Jak podkreślono w sekcji Uaktualnianie wersji pomocniczej w artykule dotyczącym uaktualniania istio, możesz uruchomić az aks mesh get-revisions polecenia i az aks mesh get-upgrades , aby dowiedzieć się więcej o dostępnych poprawkach dodatków, uaktualnieniach i informacjach o zgodności.

Ograniczenia

Obniżenie wersji do starszej wersji (poza procesem wycofywania kanarek) jest niedozwolone.
Pomijanie z jednej poprawki do niekonsekwencyjnej poprawki jest dozwolone tylko wtedy, gdy usługa AKS nie obsługuje już zarówno bieżącej poprawki, jak i następnej poprawki uaktualnienia. W tym momencie jedynym dostępnym uaktualnieniem jest najniższa obsługiwana poprawka.
Etykieta Istio sidecar.istio.io/inject nie włącza wstrzykiwania przyczepki dla dodatku Istio. Etykieta istio.io/rev musi być używana podczas etykietowania i ponownego oznaczania przestrzeni nazw podczas uaktualniania kanarek.
Etykietowanie musi odbywać się na poziomie przestrzeni nazw, a nie na poziomie każdego wdrożenia. Jeśli chcesz mieć możliwość indywidualnego przerzucania zasobników, możesz ponownie uruchomić poszczególne wdrożenia zamiast używać etykietowania zasobników.
Jeśli używasz dodatku Istio Shared MeshConfig, musisz skopiować lub przenieść ustawienia meshConfig do nowej mapy ConfigMap przed przeprowadzeniem uaktualnienia kanarek. Aby uzyskać więcej informacji, zobacz Konfiguracja i uaktualnienia usługi Mesh.
Dodatek Istio wdraża zasobniki bramy ruchu przychodzącego Istio i wdrożenia na poprawkę. Jeśli przeprowadzasz uaktualnienie kanarkowe i masz dwie poprawki płaszczyzny sterowania zainstalowane w klastrze, może być konieczne rozwiązywanie problemów z wieloma zasobnikami bramy ruchu przychodzącego w obu poprawkach.

Informacje

Zastrzeżenie dotyczące innych firm

Produkty innych firm omówione w tym artykule są wytwarzane przez producentów niezależnych od firmy Microsoft. Firma Microsoft nie udziela żadnych gwarancji, dorozumianych ani żadnego innego rodzaju, w odniesieniu do wydajności lub niezawodności tych produktów.

Wyłączenie odpowiedzialności za kontakty z osobami trzecimi

Firma Microsoft udostępnia informacje kontaktowe innych firm, które ułatwiają znalezienie dodatkowych informacji na ten temat. Informacje te mogą zostać zmienione bez powiadomienia. Firma Microsoft nie gwarantuje dokładności informacji kontaktowych innych firm.

Skontaktuj się z nami, aby uzyskać pomoc

Jeśli masz pytania lub potrzebujesz pomocy, utwórz wniosek o pomoc techniczną lub zadaj pytanie w społeczności wsparcia dla platformy Azure. Możesz również przesłać opinię o produkcie do społeczności opinii platformy Azure.

Udostępnij za pośrednictwem