Uaktualnianie bezpośrednio połączonego kontrolera danych usługi Azure Arc przy użyciu interfejsu wiersza polecenia

W tym artykule opisano sposób uaktualniania bezpośrednio połączonego kontrolera danych obsługującego Azure Arc przy użyciu Azure CLI (az).

Podczas uaktualniania kontrolera danych można uaktualnić części płaszczyzny sterowania danymi, takie jak niestandardowe definicje zasobów (CRD) i kontenery. Uaktualnienie kontrolera danych nie spowoduje przestoju usług danych.

Prerequisites

Będziesz potrzebować bezpośrednio połączonego kontrolera danych z modułem imageTag w wersji v1.0.0_2021-07-30 lub nowszej.

Aby sprawdzić wersję, wykonaj:

kubectl get datacontrollers -n <namespace> -o custom-columns=BUILD:.spec.docker.imageTag

Install tools

Przed kontynuowaniem zadań w tym artykule należy zainstalować następujące elementy:

• Interfejs wiersza polecenia platformy Azure (az)
• arcdata Rozszerzenie interfejsu wiersza polecenia platformy Azure

Przykłady w tym artykule używają nawiasów kątowych < ... > do identyfikowania wartości, które należy zastąpić przed uruchomieniem skryptu. Zastąp nawiasy i wartości wewnątrz nawiasów.

Wersja arcdata rozszerzenia i wersja obrazu są powiązane. Check that you have the correct arcdata extension version that corresponds to the image version you want to upgrade to in the Version log.

Wyświetlanie dostępnych obrazów i wybieranie wersji

Pobierz listę dostępnych obrazów kontrolera danych za pomocą następującego polecenia:

az arcdata dc list-upgrades --k8s-namespace <namespace> 

Powyższe polecenie zwraca dane wyjściowe, takie jak w poniższym przykładzie:

Found 2 valid versions.  The current datacontroller version is v1.0.0_2021-07-30.
v1.1.0_2021-11-02
v1.0.0_2021-07-30

Uaktualnianie kontrolera danych

W tej sekcji pokazano, jak uaktualnić bezpośrednio połączony kontroler danych.

Aby uzyskać obsługiwane ścieżki uaktualniania, zobacz Uaktualnianie usług danych obsługiwanych przez Azure Arc.

Authenticate

Przed rozpoczęciem uaktualniania kontrolera danych usługi Azure Arc musisz nawiązać połączenie z klastrem Kubernetes, uwierzytelnić się oraz wybrać istniejący kontekst Kubernetes.

kubectl config use-context <Kubernetes cluster name>

Uaktualnianie kontrolera danych

Najpierw można przeprowadzić próbny przebieg. Test próbny sprawdza, czy rejestr istnieje, weryfikuje schemat wersji i token autoryzacji repozytorium prywatnego (jeśli jest używany). Aby wykonać próbny przebieg, użyj parametru --dry-run w poleceniu az arcdata dc upgrade. For example:

az arcdata dc upgrade --resource-group <resource group> --name <data controller name> --desired-version <version> --dry-run [--no-wait]

Dane wyjściowe powyższego polecenia to:

Preparing to upgrade dc arcdc in namespace arc to version <version-tag>.
****Dry Run****
Arcdata Control Plane would be upgraded to: <version-tag>

Po uaktualnieniu rozszerzenia kontrolera danych usługi Arc uruchom az arcdata dc upgrade polecenie , określając tag obrazu za --desired-versionpomocą polecenia .

az arcdata dc upgrade --resource-group <resource group> --name <data controller name> --desired-version <version> [--no-wait]

Example:

az arcdata dc upgrade --resource-group rg-arcds --name dc01 --desired-version v1.7.0_2022-05-24 [--no-wait]

Monitorowanie stanu uaktualnienia

Postęp uaktualniania można monitorować za pomocą interfejsu wiersza polecenia.

CLI

 az arcdata dc status show --resource-group <resource group>

Uaktualnienie jest dwuczęściowym procesem. Najpierw kontroler zostanie uaktualniony, a następnie stos monitorowania zostanie uaktualniony. Po zakończeniu uaktualniania dane wyjściowe będą następujące:

Ready

Troubleshooting

Gdy żądana wersja zostanie ustawiona na określoną wersję, zadanie programu inicjujące podejmie próbę uaktualnienia do tej wersji, dopóki nie zakończy się pomyślnie. Jeśli uaktualnienie zakończy się pomyślnie, RunningVersion właściwość specyfikacji zostanie zaktualizowana do nowej wersji. Uaktualnienia mogą zakończyć się niepowodzeniem w scenariuszach, takich jak nieprawidłowy znacznik obrazu, brak możliwości nawiązania połączenia z rejestrem lub repozytorium, niewystarczająca ilość procesora CPU lub pamięci przydzielonej do kontenerów, lub niewystarczająca ilość miejsca do magazynowania.

1. Uruchom poniższe polecenie, aby sprawdzić, czy którykolwiek z zasobników ma Error stan lub ma dużą liczbę ponownych uruchomień:

   kubectl get pods --namespace <namespace>
   

2. Aby sprawdzić w Zdarzeniach, czy wystąpił błąd, uruchom

   kubectl describe pod <pod name> --namespace <namespace>
   

3. Aby uzyskać listę kontenerów w zasobnikach, uruchom polecenie

   kubectl get pods <pod name> --namespace <namespace> -o jsonpath='{.spec.containers[*].name}*'
   

4. Aby pobrać dzienniki dla kontenera, uruchom polecenie

   kubectl logs <pod name> <container name> --namespace <namespace>
   

To view common errors and how to troubleshoot them go to Troubleshooting resources.