Een indirect verbonden Azure Arc-gegevenscontroller upgraden met behulp van de CLI

In dit artikel wordt beschreven hoe u een indirect verbonden gegevenscontroller met Azure Arc kunt upgraden met behulp van de Azure CLI (az).

Tijdens een upgrade van een gegevenscontroller kunnen delen van het gegevensbeheervlak, zoals Aangepaste resourcedefinities (CRD's) en containers, worden bijgewerkt. Een upgrade van de gegevenscontroller veroorzaakt geen downtime voor de gegevensservices.

Prerequisites

U hebt een indirect verbonden gegevenscontroller nodig met de imageTag v1.0.0_2021-07-30 of hoger.

Voer de volgende opdracht uit om de versie te controleren:

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

Install tools

Voordat u verder kunt gaan met de taken in dit artikel, moet u het volgende installeren:

• De Azure CLI (az)
• De arcdata extensie voor Azure CLI

In voorbeelden in dit artikel worden punthaken < ... > gebruikt om waarden te identificeren die u moet vervangen voordat u het script uitvoert. Vervang de vierkante haken en de waarden tussen de haken.

De arcdata extensieversie en de versie van de installatiekopieën zijn gerelateerd. Check that you have the correct arcdata extension version that corresponds to the image version you want to upgrade to in the Version log.

Beschikbare installatiekopieën weergeven en een versie kiezen

Haal de lijst met beschikbare installatiekopieën voor de gegevenscontroller op met de volgende opdracht:

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

Met de bovenstaande opdracht wordt uitvoer geretourneerd zoals in het volgende voorbeeld:

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

Gegevenscontroller upgraden

In deze sectie wordt beschreven hoe u een indirect verbonden gegevenscontroller kunt upgraden.

Zie Gegevensservices met Azure Arc upgraden voor ondersteunde upgradepaden.

Upgrade

U moet verbinding maken met en verifiëren bij een Kubernetes-cluster en een bestaande Kubernetes-context hebben geselecteerd voordat u de upgrade van de Azure Arc-gegevenscontroller start.

U kunt eerst een droogloop uitvoeren. De dry run valideert dat het register bestaat, het versieschema en het autorisatietoken voor de privéopslagplaats (indien gebruikt). Als u een droge uitvoering wilt uitvoeren, gebruikt u de --dry-run parameter in de az arcdata dc upgrade opdracht. For example:

az arcdata dc upgrade --desired-version <version> --k8s-namespace <namespace> --dry-run --use-k8s

De uitvoer voor de voorgaande opdracht is:

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

Als u de gegevenscontroller wilt upgraden, voert u de az arcdata dc upgrade opdracht uit en geeft u de afbeeldingstag op met --desired-version.

az arcdata dc upgrade --name <data controller name> --desired-version <image tag> --k8s-namespace <namespace> --use-k8s

Example:

az arcdata dc upgrade --name arcdc --desired-version v1.7.0_2022-05-24 --k8s-namespace arc --use-k8s

In de uitvoer voor de voorgaande opdracht wordt de status van de stappen weergegeven:

Preparing to upgrade dc arcdc in namespace arc to version <version-tag>.
Preparing to upgrade dc arcdc in namespace arc to version <version-tag>.
Creating service account: arc:cr-upgrade-worker
Creating cluster role: arc:cr-upgrade-worker
Creating cluster role binding: arc:crb-upgrade-worker
Cluster role binding: arc:crb-upgrade-worker created successfully.
Cluster role: arc:cr-upgrade-worker created successfully.
Service account arc:cr-upgrade-worker has been created successfully.
Creating privileged job arc-elevated-bootstrapper-job

De upgradestatus bewaken

De upgrade is een tweedelige procedure. Eerst wordt de controller bijgewerkt en vervolgens wordt de bewakingsstack bijgewerkt. U kunt de voortgang van de upgrade bewaken met CLI.

CLI

 az arcdata dc status show --name <data controller name> --k8s-namespace <namespace> --use-k8s

Wanneer de upgrade is voltooid, is de uitvoer:

Ready

Troubleshooting

Wanneer de gewenste versie is ingesteld op een specifieke versie, probeert de bootstrapper-taak een upgrade uit te voeren naar die versie totdat deze slaagt. Als de upgrade is geslaagd, wordt de RunningVersion eigenschap van de specificatie bijgewerkt naar de nieuwe versie. Upgrades kunnen mislukken voor scenario's zoals een onjuiste installatiekopieëntag, kan geen verbinding maken met register of opslagplaats, onvoldoende CPU of geheugen toegewezen aan de containers of onvoldoende opslag.

1. Voer de onderstaande opdracht uit om te zien of een van de pods een Error status heeft of een groot aantal herstarts heeft:

   kubectl get pods --namespace <namespace>
   

2. Als u gebeurtenissen wilt bekijken om te zien of er een fout is, voert u de opdracht uit

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

3. Als u een lijst met de containers in de pods wilt ophalen, voert u de opdracht uit

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

4. Voer de opdracht uit om de logboeken voor een container op te halen

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

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