Uaktualnianie agentów platformy Kubernetes z obsługą usługi Azure Arc

  • Artykuł

Platforma Kubernetes z obsługą usługi Azure Arc zapewnia zarówno automatyczne, jak i ręczne uaktualnianie agentów, dzięki czemu agenci są uaktualniane do najnowszej wersji. Jeśli wyłączysz automatyczne uaktualnianie i zamiast tego polegasz na ręcznym uaktualnieniu, zasady obsługi wersji będą stosowane dla agentów usługi Arc i bazowych klastrów Kubernetes.

Przełącz automatyczne uaktualnianie podczas łączenia klastra z usługą Azure Arc

Platforma Kubernetes z obsługą usługi Azure Arc zapewnia swoim agentom gotowe możliwości automatycznego uaktualniania. Po włączeniu automatycznego uaktualniania agent sonduje platformę Azure co godzinę, aby sprawdzić dostępność nowszej wersji. Gdy nowsza wersja stanie się dostępna, wyzwala uaktualnienie pakietu Helm dla agentów usługi Azure Arc.

Po połączeniu klastra z usługą Azure Arc ustawieniem domyślnym jest włączenie automatycznego uaktualniania.

Następujące polecenie łączy klaster z usługą Azure Arc z włączonym automatycznym uaktualnianiem:

az connectedk8s connect --name AzureArcTest1 --resource-group AzureArcTest

Ważne

Upewnij się, że zezwalasz na łączność ze wszystkimi wymaganymi punktami końcowymi. W szczególności łączność z dl.k8s.io programem jest wymagana w przypadku automatycznych uaktualnień.

Aby zrezygnować z automatycznego uaktualniania, określ --disable-auto-upgrade parametr podczas łączenia klastra z usługą Azure Arc.

Następujące polecenie łączy klaster z usługą Azure Arc z wyłączoną funkcją automatycznego uaktualniania:

az connectedk8s connect --name AzureArcTest1 --resource-group AzureArcTest --disable-auto-upgrade

Napiwek

Jeśli planujesz wyłączyć automatyczne uaktualnianie, należy pamiętać o zasadach obsługi wersji dla platformy Kubernetes z obsługą usługi Azure Arc.

Przełączanie automatycznego uaktualniania włączonego lub wyłączonego po połączeniu klastra z usługą Azure Arc

Po połączeniu klastra z usługą Azure Arc można zmienić wybór automatycznego uaktualniania przy użyciu az connectedk8s update polecenia i ustawienia --auto-upgrade na true lub false.

Następujące polecenie powoduje wyłączenie automatycznego uaktualniania dla połączonego klastra:

az connectedk8s update --name AzureArcTest1 --resource-group AzureArcTest --auto-upgrade false

Ręczne uaktualnianie agentów

Jeśli wyłączono automatyczne uaktualnianie, możesz ręcznie zainicjować uaktualnienia agentów przy użyciu az connectedk8s upgrade polecenia . W tym celu należy określić wersję, do której chcesz uaktualnić.

Platforma Kubernetes z obsługą usługi Azure Arc jest zgodna ze standardowym schematemMAJOR.MINOR.PATCH obsługi wersji semantycznych dla przechowywania wersji agentów. Każda liczba w wersji wskazuje ogólną zgodność z poprzednią wersją:

  • Wersje główne zmieniają się w przypadku wystąpienia niezgodnych aktualizacji interfejsu API lub zgodności z poprzednimi wersjami.
  • Wersje pomocnicze zmieniają się, gdy zmiany funkcji są zgodne z poprzednimi wersjami do innych wersji pomocniczych.
  • Wersje poprawek zmieniają się po wprowadzeniu poprawek usterek zgodnych z poprzednimi wersjami.

Chociaż harmonogram może się różnić, nowa wersja pomocnicza agentów Kubernetes z obsługą usługi Azure Arc jest zwalniana mniej więcej raz na miesiąc.

Następujące polecenie ręcznie uaktualnia agentów do wersji 1.8.14:

az connectedk8s upgrade -g AzureArcTest1 -n AzureArcTest --agent-version 1.8.14

Sprawdzanie wersji agenta

Aby wyświetlić listę połączonych klastrów i zgłoszoną wersję agenta, użyj następującego polecenia:

az connectedk8s list --query '[].{name:name,rg:resourceGroup,id:id,version:agentVersion}'

Sprawdzanie, czy automatyczne uaktualnianie jest włączone w klastrze

Aby sprawdzić, czy klaster jest włączony do automatycznego uaktualniania, uruchom następujące polecenie kubectl. Należy pamiętać, że konfiguracja automatycznego uaktualniania nie jest dostępna w publicznym interfejsie API dla platformy Kubernetes z obsługą usługi Azure Arc.

kubectl -n azure-arc get cm azure-clusterconfig -o jsonpath="{.data['AZURE_ARC_AUTOUPDATE']}"

Zasady obsługi wersji

Podczas tworzenia żądań pomocy technicznej dla platformy Kubernetes z włączoną usługą Azure Arc obowiązują następujące zasady pomocy technicznej dotyczące wersji:

  • Agenci kubernetes z obsługą usługi Azure Arc mają okno pomocy technicznej "N-2", gdzie "N" to najnowsza wersja pomocnicza agentów.

    • Jeśli na przykład platforma Kubernetes z obsługą usługi Azure Arc wprowadza obecnie 0.28.a, wersje 0.28.a, 0.28.b, 0.27.c, 0.27.d, 0.26.e i 0.26.f są obsługiwane.

  • Klastry Kubernetes łączące się z usługą Azure Arc mają okno obsługi "N-2", gdzie "N" to najnowsza stabilna wersja pomocnicza nadrzędnego rozwiązania Kubernetes.

    • Jeśli na przykład platforma Kubernetes wprowadza dzisiaj 1.20.a, wersje 1.20.a, 1.20.b, 1.19.c, 1.19.d, 1.18.e i 1.18.f są obsługiwane.

Jeśli tworzysz wniosek o pomoc techniczną i używasz wersji spoza zasad pomocy technicznej (starszych niż "N-2" obsługiwanych wersji agentów i nadrzędnych klastrów Kubernetes), zostanie wyświetlony monit o uaktualnienie klastrów i agentów do obsługiwanej wersji.

Następne kroki