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

  • Artykuł

W tym artykule opisano sposób uaktualniania bezpośrednio połączonego kontrolera danych z obsługą usługi Azure Arc przy użyciu interfejsu wiersza polecenia platformy Azure (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 (serwera SQL Managed Instance lub PostgreSQL).

Wymagania wstępne

Będziesz potrzebować bezpośrednio połączonego kontrolera danych z elementem imageTag v1.0.0_2021-07-30 lub nowszym.

Aby sprawdzić wersję, uruchom polecenie:

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

Instalowanie narzędzi

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

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 kwadratowych.

Wersja arcdata rozszerzenia i wersja obrazu są powiązane. Sprawdź, czy masz poprawną arcdata wersję rozszerzenia odpowiadającą wersji obrazu, do której chcesz przeprowadzić uaktualnienie w dzienniku wersji.

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.

Uwaga

Niektóre warstwy i tryby usług danych są ogólnie dostępne, a niektóre są dostępne w wersji zapoznawczej. Jeśli instalujesz ogólnie dostępne usługi i usługi w wersji zapoznawczej na tym samym kontrolerze danych, nie możesz przeprowadzić uaktualnienia. Aby uaktualnić, usuń wszystkie wystąpienia bazy danych spoza ga. Listę ogólnie dostępnych usług i usług w wersji zapoznawczej można znaleźć w informacjach o wersji.

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

Uwierzytelnij

Przed rozpoczęciem uaktualniania kontrolera danych usługi Azure Arc musisz nawiązać połączenie z klastrem Kubernetes i uwierzytelnić się w klastrze Kubernetes.

kubectl config use-context <Kubernetes cluster name>

Uaktualnianie kontrolera danych

Najpierw można przeprowadzić suchy przebieg. Przebieg suchy sprawdza, czy rejestr istnieje, schemat wersji i token autoryzacji repozytorium prywatnego (jeśli jest używany). Aby wykonać suchy przebieg, użyj parametru --dry-run w poleceniu az arcdata dc upgrade . Przykład:

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]

Przykład:

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.

Interfejs wiersza polecenia

 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

Rozwiązywanie problemów

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 tag obrazu, nie można nawiązać połączenia z rejestrem lub repozytorium, niewystarczającą ilością procesora CPU lub pamięci przydzieloną do kontenerów lub niewystarczającą ilością 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ć, czy wystąpił błąd, uruchom polecenie

    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>

Aby wyświetlić typowe błędy i sposoby ich rozwiązywania, przejdź do artykułu Rozwiązywanie problemów z zasobami.