Upgrade spravované instance Azure SQL přímo připojené k Azure Arc pomocí rozhraní příkazového řádku

Článek
11/05/2024

Tento článek popisuje, jak upgradovat spravovanou instanci Azure SQL nasazenou na přímo připojeném kontroleru dat s podporou služby Azure Arc pomocí Azure CLI (az).

Požadavky

Instalace nástrojů

Než budete moct pokračovat s úlohami v tomto článku, nainstalujte:

Azure CLI (az)
Rozšíření arcdata pro Azure CLI

Souvisí arcdata s verzí rozšíření a verzí image. Zkontrolujte, jestli máte správnou arcdata verzi rozšíření odpovídající verzi image, na kterou chcete upgradovat v protokolu verzí.

Omezení

Než bude možné upgradovat spravovanou instanci, musí být kontroler dat Azure Arc upgradován na novou verzi.

Pokud je povolená integrace služby Active Directory, musí být konektor služby Active Directory upgradován na novou verzi, aby bylo možné upgradovat spravovanou instanci.

Před upgradem kontroleru dat musí být spravovaná instance stejná jako konektor kontroleru dat a konektoru služby Active Directory.

V tuto chvíli není k dispozici žádný proces dávkového upgradu.

Upgrade spravované instance

Nejprve můžete provést suchý běh. Suché spuštění ověří schéma verze a zobrazí seznam instancí, které se upgradují. Použijte --dry-run. Příklad:

az sql mi-arc upgrade --resource-group <resource group> --name <instance name> --dry-run

Výstup bude:

Preparing to upgrade sql sqlmi-1 in namespace arc to data controller version.
****Dry Run****1 instance(s) would be upgraded by this commandsqlmi-1 would be upgraded to <version-tag>.

Pro obecné účely

Během upgradu spravované instance SQL pro obecné účely se pod ukončí a znovu vytvoří v nové verzi. To způsobí krátký výpadek při vytváření nového podu. Abyste zajistili minimální přerušení, budete muset do své aplikace integrovat odolnost, například logiku opakování připojení. Přečtěte si přehled pilíře spolehlivosti, kde najdete další informace o návrhu odolnosti a pokynech k opakování pro služby Azure.

Pro důležité obchodní informace

Během upgradu služby SQL Managed Instance Pro důležité obchodní informace s více než jednou replikou:

Pody sekundární repliky se ukončí a znovu zpro zřízení v nové verzi.
Po upgradu replik primární repliky převezme služby při selhání upgradované repliky.
Předchozí primární pod se ukončí a znovu vytvoří v nové verzi a stane se sekundárním

Dojde k krátkému výpadku, když dojde k převzetí služeb při selhání.

Upgrade

Pokud chcete upgradovat spravovanou instanci, použijte následující příkaz:

az sql mi-arc upgrade --resource-group <resource group> --name <instance name> --desired-version <imageTag> [--no-wait]

Příklad:

az sql mi-arc upgrade --resource-group myresource-group --name sql1 --desired-version v1.6.0_2022-05-02 [--no-wait]

Monitor

Průběh upgradu můžete monitorovat pomocí rozhraní příkazového řádku.

Příklad rozhraní příkazového řádku

az sql mi-arc show --resource-group <resource group> --name <instance name>

Výstup

Výstup příkazu zobrazí informace o prostředku. Informace o upgradu budou ve stavu.

Během upgradu State se zobrazí Updating aktuální Running Version verze:

Status:
  Log Search Dashboard:  https://30.88.222.48:5601/app/kibana#/discover?_a=(query:(language:kuery,query:'custom_resource_name:sqlmi-1'))
  Metrics Dashboard:     https://30.88.221.32:3000/d/40q72HnGk/sql-managed-instance-metrics?var-hostname=sqlmi-1-0
  Observed Generation:   2
  Primary Endpoint:      30.76.129.38,1433
  Ready Replicas:        1/1
  Running Version:       v1.5.0_2022-04-05
  State:                 Updating

Po dokončení State upgradu se zobrazí Ready nová Running Version verze:

Status:
  Log Search Dashboard:  https://30.88.222.48:5601/app/kibana#/discover?_a=(query:(language:kuery,query:'custom_resource_name:sqlmi-1'))
  Metrics Dashboard:     https://30.88.221.32:3000/d/40q72HnGk/sql-managed-instance-metrics?var-hostname=sqlmi-1-0
  Observed Generation:   2
  Primary Endpoint:      30.76.129.38,1433
  Ready Replicas:        1/1
  Running Version:       v1.6.0_2022-05-02
  State:                 Ready

Řešení problému

Pokud je požadovaná verze nastavená na konkrétní verzi, úloha bootstrapperu se pokusí upgradovat na tuto verzi, dokud nebude úspěšná. Pokud upgrade proběhne úspěšně, RunningVersion vlastnost specifikace se aktualizuje na novou verzi. Upgrady můžou selhat ve scénářích, jako je nesprávná značka image, nejde se připojit k registru nebo úložišti, nedostatek procesoru nebo paměti přidělené kontejnerům nebo nedostatečné úložiště.

Spuštěním následujícího příkazu zkontrolujte, jestli některý z podů zobrazuje Error stav nebo má velký počet restartování:
```
kubectl get pods --namespace <namespace>
```
Pokud se chcete podívat na události a zjistit, jestli došlo k chybě, spusťte
```
kubectl describe pod <pod name> --namespace <namespace>
```

Pokud chcete získat seznam kontejnerů v podech, spusťte příkaz

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

Pokud chcete získat protokoly kontejneru, spusťte příkaz

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

Pokud chcete zobrazit běžné chyby a jak je vyřešit, přejděte k prostředkům pro řešení potíží.

Sdílet prostřednictvím