Správa rozšíření Azure Arc v místním prostředí Azure
Článek
Platí pro: Azure Local 2311.2 a novější
Tento článek popisuje, jak nainstalovat, upgradovat a spravovat rozšíření Azure Arc v Azure Local.
Rozšíření Azure Arc spravovaná zákazníkem v Azure Local
Rozšíření Azure Arc můžete nainstalovat, odinstalovat a aktualizovat v místním prostředí Azure. Azure Arc umožňuje spouštět hybridní služby, jako je monitorování a Centrum pro správu Windows na webu Azure Portal.
Tady jsou jednotlivá rozšíření, která můžete nainstalovat a spravovat.
Jakmile úspěšně zaregistrujete nové místní prostředí Azure s Azure, rozšíření spravovaná v Azure se automaticky nainstalují do systému. 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 na webu Azure Portal tak, že přejdete na stránku Rozšíření a vyberete nabídku Nastavení .
Pokud máte existující místní Azure, který je zaregistrovaný v Azure bez těchto rozšíření, zobrazí se banner na stránce Přehled nebo Rozšíření na webu Azure Portal. Informace v banneru můžete použít k tomu, abyste vás provedli instalací těchto rozšíření.
Rozšíření můžete nainstalovat na kartě Možnosti pro servery s podporou Azure Local Arc, jak je znázorněno na snímku obrazovky. K instalaci většiny rozšíření můžete použít kartu schopností.
Když na webu Azure Portal nainstalujete rozšíření, jedná se o operaci pracující s clusterem. Rozšíření se nainstaluje na všechny uzly systému. Pokud do systému přidáte další uzly, všechna rozšíření nainstalovaná v systému se automaticky přidají na nové servery.
Azure CLI je k dispozici k instalaci v prostředích s Windows, macOS a Linuxem. Dá se spustit také v Azure Cloud Shellu. Další informace najdete v rychlém startu pro Azure Cloud Shell.
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'))
Pokud chcete nainstalovat rozšíření Windows Admin Center do všech systémů 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
Pokud chcete nainstalovat rozšíření agenta Azure Monitoru do všech systémů 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
Pokud chcete nainstalovat rozšíření Azure Site Recovery do všech systémů 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 je možné spustit v Azure Cloud Shellu. Tento dokument podrobně popisuje, jak používat PowerShell v Azure Cloud Shellu. Další informace najdete v rychlém startu pro Azure Cloud Shell.
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
Pokud chcete nainstalovat rozšíření Windows Admin Center do všech systémů ve skupině prostředků, spusťte následující příkaz:
Pokud chcete nainstalovat rozšíření Azure Site Recovery do všech systémů 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
}
Stav rozšíření na každém serveru můžete zkontrolovat na stránce Rozšíření zobrazením sloupce stavu mřížky.
Azure CLI je k dispozici k instalaci v prostředích s Windows, macOS a Linuxem. Dá se spustit také v Azure Cloud Shellu. Další informace najdete v rychlém startu pro Azure Cloud Shell.
Spusťte Azure Cloud Shell a pomocí bashe zkontrolujte stav rozšíření následujícím postupem:
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}"
Pokud chcete zobrazit seznam všech rozšíření v systému, spusťte následující příkaz:
az stack-hci extension list \
--arc-setting-name "default" \
--cluster-name "${clusterName}" \
--resource-group "${resourceGroup}" \
-o table
Pokud chcete vyfiltrovat konkrétní rozšíření, například AzureMonitorWindowsAgent, spusťte následující příkaz:
Azure PowerShell je možné spustit v Azure Cloud Shellu. Tento dokument podrobně popisuje, jak používat PowerShell v Azure Cloud Shellu. Další informace najdete v rychlém startu pro Azure Cloud Shell.
Spusťte Azure Cloud Shell a pomocí PowerShellu zkontrolujte stav rozšíření následujícím postupem:
Nastavení parametrů z vašeho 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
Pokud chcete zobrazit seznam všech rozšíření v systému, spusťte následující příkaz:
Když publikuje tým 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 místní služby Azure Arc, pokud se explicitně nevyhlásíte z automatických upgradů.
V současné době se automatické upgrady rozšíření podporují jenom v rozšíření Windows Admin Center, ale v budoucnu se přidají další rozšíření.
Poznámka:
Ve výchozím nastavení jsou všechna rozšíření nastavená tak, aby umožňovala automatické upgrady, ale toto nastavení funguje jenom v případě, že ho vydavatel podporuje. Pokud rozšíření není nastavené tak, aby umožňovalo automatické upgrady, proběhne upgrade během procesu aktualizace řešení. V průběhu času se ruční upgrady rozšíření převedou na automatické upgrady.
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 následující kroky:
Zvolte rozšíření, pro které chcete povolit automatický upgrade.
V horní nabídce vyberte Povolit automatický upgrade .
Po zobrazení výzvy k potvrzení záměru vyberte OK.
Pokud chcete nainstalovat a povolit automatický upgrade pro konkrétní rozšíření, 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"
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"
Pokud chcete nainstalovat a povolit automatický upgrade pro konkrétní rozšíření, 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"
$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 webu Azure Portal
Ruční upgrade rozšíření funguje podobně jako automatický upgrade rozšíření. Když ručně upgradujete rozšíření v clusteru s podporou Místního arc Azure, Azure uloží vybranou verzi. Azure se pak pokusí upgradovat rozšíření na všech uzlech v clusteru na danou verzi.
Pokud upgrade rozšíření na některých serverech selže, platforma se během další synchronizace místního cloudu Azure pokusí upgradovat na vybranou verzi.
V těchto scénářích použijte ruční pracovní postup:
K dispozici je nová verze rozšíření a chcete ji upgradovat ručně.
Možnost automatického upgradu rozšíření je zakázaná a v různých uzlech Azure Local došlo k neshodě verzí.
Pokud chcete rozšíření upgradovat ručně, postupujte takto:
Přejděte na stránku Rozšíření .
Zvolte rozšíření, které chcete upgradovat, a v horní nabídce vyberte Nastavení .
Zvolte nejnovější verzi a vyberte Uložit.
Zakázání automatického upgradu rozšíření
Automatické upgrady pro určitá rozšíření můžete zakázat na webu Azure Portal. Pokud chcete zakázat automatické upgrady, přejděte na stránku Rozšíření a proveďte následující kroky:
Zvolte rozšíření, u kterého chcete zakázat automatický upgrade.
V horní nabídce vyberte Zakázat automatický upgrade .
Po zobrazení výzvy k potvrzení záměru vyberte OK.
Kontrola historie upgradu rozšíření
Kartu Protokol aktivit můžete zobrazit na jednotlivých serverových prostředcích, skupinách prostředků a předplatných s podporou služby Azure Arc a zkontrolovat historii automatických upgradů rozšíření pro jednotlivé uzly. Další informace najdete v tématu Kontrola historie automatického upgradu rozšíření.
Aktualizace první dostupnosti
U skupiny clusterů s podporou Místního arc Azure, u které probíhá upgrade, platforma Azure k orchestraci upgradů použila model automatického upgradu rozšíření.
Načasování automatických upgradů rozšíření
Když se publikuje nová verze podporovaného rozšíření, bude dostupná 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 na některých serverech může dojít k upgradu rozšíření před ostatními. Další informace najdete v tématu Časování automatických upgradů rozšíření.
Pokud se upgrade rozšíření nezdaří, Azure provede akce spojené s automatickým vrácením zpět a opakováním pokusu o opravu rozšíření.
Pokud máte s upgradem rozšíření dál problémy, můžete zakázat automatický upgrade rozšíření. Když automatický upgrade zakážete, zabrání při řešení tohoto problému opakování systému. Až budete připraveni, můžete automatický upgrade rozšíření znovu povolit.
Upgrady s více rozšířeními
Pokud je pro uzel k dispozici více upgradů rozšíření, můžou se seskupit dohromady. Každý upgrade rozšíření se ale na uzlu použije jednotlivě. Další informace najdete v tématu Upgrady rozšíření s více rozšířeními.
V případě potřeby můžete odinstalovat některá rozšíření z místního prostředí Azure na webu Azure Portal. K odinstalaci rozšíření použijte tento postup:
Přejděte na stránku Rozšíření.
Zvolte rozšíření, které chcete odinstalovat. Tlačítko pro odinstalaci není dostupné pro rozšíření spravovaná v Azure.
V horní nabídce vyberte Odinstalovat .
Potvrďte záměr a vyberte Ano.
Pokud chcete odebrat konkrétní rozšíření, 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}"
Pokud chcete odebrat konkrétní rozšíření, 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í: Selhání
Doporučení: Pro rozšíření se stavem selhání vyberte odkaz Selhání (zobrazit podrobnosti). Zobrazte všechny informace o selhání a použijte tipy pro řešení potíží.
