Správa rozšíření Azure Arc ve službě Azure Stack HCI

Platí pro: Azure Stack HCI verze 23H2 a 22H2

Tento článek popisuje, jak nainstalovat, upgradovat a spravovat rozšíření Azure Arc na serverových počítačích Azure Stack HCI.

Rozšíření Azure Arc spravovaná zákazníkem ve službě Azure Stack HCI

Se službou Azure Stack HCI můžete instalovat, odinstalovat a aktualizovat rozšíření Azure Arc ve svých systémech Azure Stack HCI. Azure Arc umožňuje v Azure Portal spouštět hybridní služby, jako je monitorování a Windows Admin Center.

Tady jsou jednotlivá rozšíření, která můžete nainstalovat a spravovat.

• Agent monitorování Azure
• Azure Site Recovery
• Windows Admin Center

Rozšíření spravovaná Azure ve službě Azure Stack HCI

Po úspěšné registraci nového clusteru Azure Stack HCI v Azure se do clusteru automaticky nainstalují rozšíření spravovaná v Azure. Tato rozšíření jsou nezbytná pro funkčnost a kvalitu systému a nelze je odinstalovat. Chování těchto rozšíření můžete spravovat v Azure Portal tak, že přejdete na stránku Rozšíření a vyberete nabídku Nastavení.

Pokud máte existující cluster Azure Stack HCI, který je zaregistrovaný v Azure bez těchto rozšíření, zobrazí se na stránce Přehled nebo Rozšíření v Azure Portal banner. Informace v banneru vás povedou instalací těchto rozšíření.

Tady jsou rozšíření spravovaná Azure:

• Telemetrie a diagnostika
• Rozšíření Remote Support Arc

Instalace rozšíření

Azure Portal

Rozšíření můžete nainstalovat z karty Schopnosti pro servery s podporou Azure Stack HCI Arc, jak je znázorněno na snímku obrazovky. K instalaci většiny rozšíření můžete použít kartu schopností.

Když nainstalujete rozšíření do Azure Portal, jedná se o operaci pracující s clusterem. Rozšíření se nainstaluje na všechny servery clusteru. Pokud do clusteru přidáte další servery, všechna rozšíření nainstalovaná v clusteru se automaticky přidají na nové servery.

Azure CLI

Azure CLI je k dispozici k instalaci v prostředích s Windows, macOS a Linuxem. Dá se také spustit v Azure Cloud Shell. Další informace najdete v tématu Rychlý start pro Azure Cloud Shell.

Spusťte Azure Cloud Shell a pomocí Bash nainstalujte rozšíření podle těchto kroků:

1. Nastavení parametrů z předplatného, skupiny prostředků a clusterů

   subscription="00000000-0000-0000-0000-000000000000" # Replace with your subscription ID
   resourceGroup="hcicluster-rg" # Replace with your resource group name
   
   az account set --subscription "${subscription}"
   
   clusters=($(az graph query -q "resources | where type == 'microsoft.azurestackhci/clusters'| where resourceGroup =~ '${resourceGroup}' | project name" | jq -r '.data[].name'))
   

2. Pokud chcete nainstalovat rozšíření Windows Admin Center do všech clusterů ve skupině prostředků, spusťte následující příkaz:

   extensionName="AdminCenter"
   extensionType="AdminCenter"
   extensionPublisher="Microsoft.AdminCenter"
   settingsConfig="{'port':'6516'}"
   connectivityProps="{enabled:true}"
   
   for cluster in ${clusters}; do
       echo "Enabling Connectivity for cluster $currentCluster"
       az stack-hci arc-setting update \
           --resource-group ${resourceGroup} \
           --cluster-name ${cluster} \
           --name "default" \
           --connectivity-properties ${connectivityProps}
   
       echo "Installing extension: ${extensionName} on cluster: ${cluster}"
       az stack-hci extension create \
           --arc-setting-name "default" \
           --cluster-name "${cluster}" \
           --resource-group "${resourceGroup}" \
           --name "${extensionName}" \
           --auto-upgrade "true" \
           --publisher "${extensionPublisher}" \
           --type "${extensionType}" \
           --settings "${settingsConfig}"
   done
   

3. Pokud chcete nainstalovat rozšíření agenta Azure Monitoru do všech clusterů ve skupině prostředků, spusťte následující příkaz:

   extensionName="AzureMonitorWindowsAgent"
   extensionType="AzureMonitorWindowsAgent"
   extensionPublisher="Microsoft.Azure.Monitor"
   
   for cluster in ${clusters}; do
       echo "Installing extension: ${extensionName} on cluster: ${cluster}"
   
       az stack-hci extension create \
           --arc-setting-name "default" \
           --cluster-name "${cluster}" \
           --resource-group "${resourceGroup}" \
           --name "${extensionName}" \
           --auto-upgrade "true" \
           --publisher "${extensionPublisher}" \
           --type "${extensionType}"
   done
   

4. Pokud chcete nainstalovat rozšíření Azure Site Recovery na všechny clustery ve skupině prostředků, spusťte následující příkaz:

   asrSubscription="00000000-0000-0000-0000-000000000000" # Replace with your ASR subscription ID
   asrResourceGroup="asr-rg" # Replace with your ASR resource group
   asrVaultName="asr-vault" # Replace with your ASR vault name
   asrLocation="East US" # Replace with your ASR Location
   asrSiteId="00000000-0000-0000-0000-000000000000" # Replace with your ASR Site ID
   asrSiteName="asr-site" # Replace with your Site Name
   asrSitePolicyId="/subscriptions/${asrSubscription}/resourceGroups/${asrResourceGroup}/providers/Microsoft.RecoveryServices/vaults/${asrVaultName}/replicationPolicies/s-cluster-policy" # Replace with your Site Policy name
   
   extensionName="ASRExtension"
   extensionType="Windows"
   extensionPublisher="Microsoft.SiteRecovery.Dra"
   jsonFile="./tmp-asr.json" #Temp JSON file
   
   echo "{\"SubscriptionId\": \"${asrSubscription}\", \"Environment\": \"AzureCloud\",\"ResourceGroup\": \"${asrResourceGroup}\",\"Location\": \"${asrLocation}\",\"SiteId\": \"${asrSiteId}\", \"SiteName\": \"${asrSiteName}\", \"PolicyId\": \"${asrSitePolicyId}\", \"PrivateEndpointStateForSiteRecovery\": \"None\" }" > ${jsonFile}
   
   for cluster in ${clusters}; do
       echo "Installing extension: ${extensionName} on cluster: ${cluster}"
   
       az stack-hci extension create \
           --arc-setting-name "default" \
           --cluster-name "${cluster}" \
           --resource-group "${resourceGroup}" \
           --name "${extensionName}" \
           --auto-upgrade "true" \
           --publisher "${extensionPublisher}" \
           --type "${extensionType}" \
           --settings "${jsonFile}"
   done
   

Azure PowerShell

Azure PowerShell můžete spustit v Azure Cloud Shell. Tento dokument podrobně popisuje, jak používat PowerShell v Azure Cloud Shell. Další informace najdete v tématu Rychlý start pro Azure Cloud Shell.

Spusťte Azure Cloud Shell a pomocí PowerShellu nainstalujte rozšíření podle těchto kroků:

1. Nastavení parametrů z předplatného, skupiny prostředků a clusterů:

   $subscription = "00000000-0000-0000-0000-000000000000" # Replace with your subscription ID
   $resourceGroup = "hcicluster-rg" # Replace with your resource group name
   
   Set-AzContext -Subscription "${subscription}"
   $clusters = Get-AzResource -ResourceType "Microsoft.AzureStackHCI/clusters" -ResourceGroupName ${resourceGroup} | Select-Object -Property Name
   

2. Pokud chcete nainstalovat rozšíření Windows Admin Center do všech clusterů ve skupině prostředků, spusťte následující příkaz:

   $extensionName = "AdminCenter"
   $extensionType = "AdminCenter"
   $extensionPublisher = "Microsoft.AdminCenter"
   $settingsConfig = @{"port" = 6516 }
   
   foreach ($cluster in $clusters) {
       $clusterName = ${cluster}.Name
   
       Write-Output ("Enable connectivity for cluster ${clusterName}")
       Invoke-AzRestMethod `
           -Method PATCH `
           -SubscriptionId ${subscription} `
           -ResourceGroupName ${resourceGroup} `
           -ResourceProviderName "Microsoft.AzureStackHCI" `
           -ResourceType ("clusters/" + ${clusterName} + "/arcSettings") `
           -Name "default" `
           -ApiVersion "2023-02-01" `
           -Payload (@{"properties" = @{ "connectivityProperties" = @{ "enabled" = $true } } } | ConvertTo-Json -Depth 5)
   
   
       Write-Output ("Installing Extension '${extensionName}' on cluster ${clusterName}")
   
       New-AzStackHciExtension `
           -ClusterName "${clusterName}" `
           -ResourceGroupName "${resourceGroup}" `
           -ArcSettingName "default" `
           -Name "${extensionName}" `
           -ExtensionParameterPublisher "${extensionPublisher}" `
           -ExtensionParameterType "${extensionType}" `
           -ExtensionParameterSetting ${settingsConfig} `
           -NoWait
   }
   

3. Pokud chcete nainstalovat rozšíření agenta Azure Monitoru do všech clusterů ve skupině prostředků, spusťte následující příkaz:

   $extensionName = "AzureMonitorWindowsAgent"
   $extensionType = "AzureMonitorWindowsAgent"
   $extensionPublisher = "Microsoft.Azure.Monitor"
   
   foreach ($cluster in $clusters) {
       $clusterName = ${cluster}.Name
   
       Write-Output ("Installing Extension '${extensionType}/${extensionPublisher}' on cluster ${clusterName}")
   
       New-AzStackHciExtension `
           -ClusterName "${clusterName}" `
           -ResourceGroupName "${resourceGroup}" `
           -ArcSettingName "default" `
           -Name "${extensionName}" `
           -ExtensionParameterPublisher "${extensionPublisher}" `
           -ExtensionParameterType "${extensionType}"
   }
   

4. Pokud chcete nainstalovat rozšíření Azure Site Recovery do všech clusterů ve skupině prostředků, vytvořte soubor parametrů JSON a spusťte následující příkaz:

   $settings = @{
       SubscriptionId = "<Replace with your Subscription Id>"
       Environment = "<Replace with the cloud environment type. For example: AzureCloud>"
       ResourceGroup = "<Replace with your Site Recovery Vault resource group>"
       ResourceName = "<Replace with your Site Recovery Vault Name>"
       Location = "<Replace with your Site Recovery Azure Region>"
       SiteId = "<Replace with the ID of your recovery site>"
       SiteName = "<Replace with your recovery site name>"
       PolicyId = "<Replace with resource ID of your recovery site policy>"
       PrivateEndpointStateForSiteRecovery = "None"
   }
   
   $extensionName = "ASRExtension"
   $extensionType = "Windows"
   $extensionPublisher = "Microsoft.SiteRecovery.Dra"
   
   foreach ($cluster in $clusters) {
       $clusterName = ${cluster}.Name
   
       Write-Output ("Installing Extension '${extensionType}/${extensionPublisher}' on cluster ${clusterName}")
   
       New-AzStackHciExtension `
           -ClusterName "${clusterName}" `
           -ResourceGroupName "${resourceGroup}" `
           -ArcSettingName "default" `
           -Name "${extensionName}" `
           -ExtensionParameterPublisher "${extensionPublisher}" `
           -ExtensionParameterType "${extensionType}" `
           -ExtensionParameterSetting ${settings} `
           -NoWait
   }
   

Kontrola stavu rozšíření

Azure Portal

Stav rozšíření na každém serveru můžete zkontrolovat na stránce Rozšíření zobrazením sloupce stav v mřížce.

Azure CLI

Azure CLI je k dispozici k instalaci v prostředích s Windows, macOS a Linuxem. Dá se také spustit v Azure Cloud Shell. Další informace najdete v tématu Rychlý start pro Azure Cloud Shell.

Spusťte Azure Cloud Shell a pomocí Bash zkontrolujte stav rozšíření podle těchto kroků:

1. Nastavení parametrů z předplatného, skupiny prostředků, názvu clusteru a názvu rozšíření

   subscription="00000000-0000-0000-0000-000000000000" # Replace with your subscription ID
   resourceGroup="hcicluster-rg" # Replace with your resource group name
   clusterName="HCICluster" # Replace with your cluster name
   extensionName="AzureMonitorWindowsAgent" # Replace with the extension name
   
   az account set --subscription "${subscription}"
   

2. Pokud chcete zobrazit seznam všech rozšíření v clusteru, spusťte následující příkaz:

   az stack-hci extension list \
   --arc-setting-name "default" \
   --cluster-name "${clusterName}" \
   --resource-group "${resourceGroup}" \
   -o table
   

3. Pokud chcete vyfiltrovat konkrétní rozšíření, jako je AzureMonitorWindowsAgent, spusťte následující příkaz:

   az stack-hci extension list \
   --arc-setting-name "default" \
   --cluster-name "${clusterName}" \
   --resource-group "${resourceGroup}" \
   --query "[?name=='${extensionName}'].{Name:name, ManagedBy:managedBy, ProvisionStatus:provisioningState, State:aggregateState, Type:extensionParameters.type}" \
   -o table
   

Azure PowerShell

Azure PowerShell můžete spustit v Azure Cloud Shell. Tento dokument podrobně popisuje, jak používat PowerShell v Azure Cloud Shell. Další informace najdete v tématu Rychlý start pro Azure Cloud Shell.

Spusťte Azure Cloud Shell a pomocí PowerShellu zkontrolujte stav rozšíření podle těchto kroků:

1. Nastavení parametrů z předplatného, skupiny prostředků a názvu clusteru

   $subscription = "00000000-0000-0000-0000-000000000000" # Replace with your subscription ID
   $resourceGroup = "hcicluster-rg" # Replace with your resource group name
   
   Set-AzContext -Subscription "${subscription}"
   $clusters = Get-AzResource -ResourceType "Microsoft.AzureStackHCI/clusters" -ResourceGroupName ${resourceGroup} | Select-Object -Property Name
   

2. Pokud chcete zobrazit seznam všech rozšíření v clusteru, spusťte následující příkaz:

   foreach ($cluster in $clusters) {
       $clusterName = ${cluster}.Name
       Get-AzStackHciExtension `
           -ClusterName "${clusterName}" `
           -ResourceGroupName "${resourceGroup}" `
           -ArcSettingName "default"|Format-Table -Property Name, ParameterType, ParameterPublisher, ParameterEnableAutomaticUpgrade, ProvisioningState
   }
   

Jak upgrade rozšíření funguje

Při publikování týmem vydavatele rozšíření proces upgradu rozšíření nahradí stávající verzi rozšíření nově podporovanou verzí. Ve výchozím nastavení je funkce automatického upgradu rozšíření povolená pro všechna rozšíření nasazená v clusterech s podporou Azure Stack HCI Arc, pokud se výslovně nevyhlásíte z automatických upgradů.

V současné době jsou automatické upgrady rozšíření podporovány pouze v rozšíření Windows Admin Center, ale další rozšíření budou přidána v budoucnu.

Poznámka

Ve výchozím nastavení jsou všechna rozšíření nastavená tak, aby umožňovala automatické upgrady, i když rozšíření automatický upgrade rozšíření nepodporuje. Toto výchozí nastavení ale nemá žádný vliv, dokud se vydavatel rozšíření nerozhodne podporovat automatický upgrade rozšíření.

Povolení automatického upgradu rozšíření

Azure Portal

U některých rozšíření můžete povolit automatické upgrady prostřednictvím správy rozšíření.

Pokud chcete povolit automatický upgrade, přejděte na stránku Rozšíření a proveďte tyto kroky:

1. Zvolte rozšíření, pro které chcete povolit automatický upgrade.

2. V horní nabídce vyberte Povolit automatický upgrade .

   

3. Po zobrazení výzvy k potvrzení záměru vyberte OK.

   

Azure CLI

Pokud chcete nainstalovat a povolit automatický upgrade pro konkrétní rozšíření, jako je například AzureMonitorWindowsAgent spuštěním následujícího příkazu:

clusterName="HCICluster" # Replace with your cluster name
resourceGroup="hcicluster-rg" # Replace with your resource group name

extensionName="AzureMonitorWindowsAgent"
extensionPublisher="Microsoft.Azure.Monitor"
extensionType="AzureMonitorWindowsAgent"

az stack-hci extension create \
    --name "${extensionName}" \
    --arc-setting-name "default" \
    --cluster-name "${clusterName}" \
    --resource-group "${resourceGroup}" \
    --publisher ${extensionPublisher} \
    --type ${extensionType} \
    --auto-upgrade "true"

Azure PowerShell

Pokud chcete nainstalovat a povolit automatický upgrade pro konkrétní rozšíření, jako je například AzureMonitorWindowsAgent spuštěním následujícího příkazu:

$clusterName = "HCICluster" # Replace with your cluster name
$resourceGroup = "hcicluster-rg" # Replace with your resource group name

$extensionName = "AzureMonitorWindowsAgent"
$extensionType = "AzureMonitorWindowsAgent"
$extensionPublisher = "Microsoft.Azure.Monitor"

New-AzStackHciExtension `
    -ClusterName "${clusterName}" `
    -ResourceGroupName "${resourceGroup}" `
    -ArcSettingName "default" `
    -Name "${extensionName}" `
    -ExtensionParameterPublisher "${extensionPublisher}" `
    -ExtensionParameterType "${extensionType}" `
    -ExtensionParameterEnableAutomaticUpgrade

Ruční upgrade rozšíření prostřednictvím Azure Portal

Ruční upgrade rozšíření funguje stejně jako automatický upgrade rozšíření. Když v clusteru s podporou Služby Azure Stack HCI Arc ručně upgradujete rozšíření, Azure uloží vybranou verzi. Azure se pak pokusí upgradovat rozšíření na všech serverech v clusteru na danou verzi.

Pokud upgrade rozšíření na některých serverech selže, platforma se během příští cloudové synchronizace Azure Stack HCI pokusí upgradovat na vybranou verzi.

Ruční pracovní postup použijte v těchto scénářích:

• Je k dispozici nová verze rozšíření a chcete ho upgradovat ručně.

• Možnost automatického upgradu rozšíření je zakázaná a na různých serverech clusteru Azure Stack HCI dochází k neshodě verzí.

Pokud chcete rozšíření upgradovat ručně, postupujte takto:

1. Přejděte na stránku Rozšíření .

2. Zvolte rozšíření, které chcete upgradovat, a v horní nabídce vyberte Nastavení .

   

3. Zvolte nejnovější verzi a vyberte Uložit.

Zákaz automatického upgradu rozšíření

Automatické upgrady pro určitá rozšíření můžete v Azure Portal zakázat. Pokud chcete zakázat automatické upgrady, přejděte na stránku Rozšíření a proveďte tyto kroky:

1. Zvolte rozšíření, pro které chcete zakázat automatický upgrade.

2. V horní nabídce vyberte Zakázat automatický upgrade .

   

3. Po zobrazení výzvy k potvrzení záměru vyberte OK.

   

Kontrola historie upgradu rozšíření

Na kartě Protokol aktivit můžete zobrazit jednotlivé serverové prostředky, skupiny prostředků a předplatná s podporou Azure Arc a zkontrolovat historii automatických upgradů rozšíření pro jednotlivé servery clusteru. Další informace najdete v tématu Kontrola historie automatického upgradu rozšíření.

Aktualizace s první dostupností

U skupiny clusterů s podporou Azure Stack HCI Arc, které procházejí upgradem, platforma Azure k orchestraci upgradů použila model automatického upgradu rozšíření .

Načasování automatických upgradů rozšíření

Když je publikovaná nová verze podporovaného rozšíření, bude k dispozici pro instalaci a ruční upgrade na serverech s podporou Azure Arc. Upgrady se vydávají v dávkách napříč oblastmi a předplatnými Azure, takže může dojít k upgradu rozšíření na některých serverech před jinými. Další informace najdete v tématu Časování automatických upgradů rozšíření.

Pokud chcete rozšíření upgradovat okamžitě, přečtěte si téma Ruční upgrade rozšíření prostřednictvím Azure Portal.

Automatické vrácení zpět a opakování

Pokud upgrade rozšíření selže, Azure provede akce spojené s automatickým vrácením zpět a pokusí se rozšíření opravit znovu.

Pokud budete mít s upgradem rozšíření dál potíže, můžete automatický upgrade rozšíření zakázat. Když zakážete automatický upgrade, zabráníte při řešení potíží opakovaným pokusům systému. Až budete připraveni , můžete automatický upgrade rozšíření znovu povolit .

Upgrady s více rozšířeními

Pokud je pro počítač k dispozici více upgradů rozšíření, můžou být dávkové. Každý upgrade rozšíření se ale na počítači použije samostatně. Další informace najdete v tématu Upgrady rozšíření s více rozšířeními.

Odinstalace rozšíření

Azure Portal

V případě potřeby můžete některá rozšíření z clusterů Azure Stack HCI odinstalovat v Azure Portal. Pokud chcete odinstalovat rozšíření, postupujte takto:

1. Přejděte na stránku Rozšíření.

2. Zvolte rozšíření, které chcete odinstalovat. Tlačítko odinstalovat není k dispozici pro rozšíření spravovaná Azure.

   

3. V horní nabídce vyberte Odinstalovat .

4. Potvrďte záměr a vyberte Ano.

   

Azure CLI

Pokud chcete odebrat konkrétní rozšíření, jako je například AzureMonitorWindowsAgent , spusťte následující příkaz:

extensionName="AzureMonitorWindowsAgent" # Replace with the extension name
resourceGroup="hcicluster-rg" # Replace with your resource group name
clusterName="HCICluster" # Replace with your cluster name

az stack-hci extension delete \
--arc-setting-name "default" \
--name "${extensionName}" \
--cluster-name "${clusterName}" \
--resource-group "${resourceGroup}"

Azure PowerShell

Pokud chcete odebrat konkrétní rozšíření, jako je například AzureMonitorWindowsAgent , spusťte následující příkaz:

$clusterName = "HCICluster" # Replace with your cluster name
$resourceGroup = "hcicluster-rg" # Replace with your resource group name

$extensionName = "AzureMonitorWindowsAgent"

Remove-AzStackHciExtension `
    -ClusterName "${clusterName}" `
    -ResourceGroupName "${resourceGroup}" `
    -ArcSettingName "default" `
    -Name "${extensionName}"

Řešení chyb rozšíření

Stav rozšíření: Selhalo

Doporučení: U rozšíření se stavem selhání vyberte odkaz Selhání (zobrazit podrobnosti). Prohlédněte si všechny informace o selhání a použijte tipy pro řešení potíží.

Další krok

Přečtěte si o správě rozšíření virtuálních počítačů pomocí serverů s podporou Azure Arc.