Den här artikeln beskriver hur du installerar, uppgraderar och hanterar Azure Arc-tillägg på Azure Local.
Kundhanterade Azure Arc-tillägg på Azure Local
Du kan installera, avinstallera och uppdatera Azure Arc-tillägg på din Azure Local. Med Azure Arc kan du köra hybridtjänster som övervakning och Windows Admin Center i Azure Portal.
Här är de enskilda tillägg som du kan installera och hantera.
När du har registrerat din nya Azure Local med Azure installeras Azure-hanterade tillägg automatiskt på systemet. Dessa tillägg är viktiga för systemets funktioner och kvalitet och kan inte avinstalleras. Du kan hantera beteendet för dessa tillägg i Azure Portal genom att gå till sidan Tillägg och välja menyn Inställningar.
Om du har en befintlig Azure Local som är registrerad i Azure utan dessa tillägg visas en banderoll på sidan Översikt eller Tillägg i Azure Portal. Du kan använda informationen i banderollen för att hjälpa dig att installera dessa tillägg.
Du kan installera tillägg från fliken Funktioner för dina Azure Local Arc-aktiverade servrar enligt skärmbilden. Du kan använda fliken Funktioner för att installera de flesta tillägg.
När du installerar ett tillägg i Azure Portal är det en klustermedveten åtgärd. Tillägget installeras på alla noder i systemet. Om du lägger till fler noder i systemet läggs alla tillägg som är installerade på systemet automatiskt till på de nya servrarna.
Azure CLI är tillgängligt för installation i Windows-, macOS- och Linux-miljöer. Det kan också köras i Azure Cloud Shell. Mer information finns i Snabbstart för Azure Cloud Shell.
Starta Azure Cloud Shell och använd Bash för att installera ett tillägg enligt följande steg:
Konfigurera parametrar från din prenumeration, resursgrupp och kluster
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'))
Om du vill installera Windows Admin Center-tillägget på alla system under resursgruppen kör du följande kommando:
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
Kör följande kommando för att installera Azure Monitor Agent-tillägget på alla system under resursgruppen:
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
Om du vill installera Azure Site Recovery-tillägget på alla system under resursgruppen kör du följande kommando:
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 kan köras i Azure Cloud Shell. Det här dokumentet beskriver hur du använder PowerShell i Azure Cloud Shell. Mer information finns i Snabbstart för Azure Cloud Shell.
Starta Azure Cloud Shell och använd PowerShell för att installera ett tillägg enligt följande steg:
Konfigurera parametrar från din prenumeration, resursgrupp och kluster:
$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
Om du vill installera Windows Admin Center-tillägget på alla system under resursgruppen kör du följande kommando:
Om du vill installera Azure Site Recovery-tillägget på alla system under resursgruppen skapar du en JSON-parameterfil och kör sedan följande kommando:
$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
}
Du kan kontrollera statusen för ett tillägg på varje server från sidan Tillägg genom att visa statuskolumneni rutnätet.
Azure CLI är tillgängligt för installation i Windows-, macOS- och Linux-miljöer. Det kan också köras i Azure Cloud Shell. Mer information finns i Snabbstart för Azure Cloud Shell.
Starta Azure Cloud Shell och använd Bash för att kontrollera statusen för ett tillägg enligt följande steg:
Konfigurera parametrar från din prenumeration, resursgrupp, klusternamn och tilläggsnamn
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}"
Kör följande kommando för att lista alla tillägg i ett system:
az stack-hci extension list \
--arc-setting-name "default" \
--cluster-name "${clusterName}" \
--resource-group "${resourceGroup}" \
-o table
Om du vill filtrera bort ett specifikt tillägg som AzureMonitorWindowsAgentkör du följande kommando:
Azure PowerShell kan köras i Azure Cloud Shell. Det här dokumentet beskriver hur du använder PowerShell i Azure Cloud Shell. Mer information finns i Snabbstart för Azure Cloud Shell.
Starta Azure Cloud Shell och använd PowerShell för att kontrollera statusen för ett tillägg enligt följande steg:
Konfigurera parametrar från din prenumeration, resursgrupp och klusternamn
$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
Kör följande kommando för att lista alla tillägg i ett system:
När tilläggets utgivarteam har publicerat tillägget ersätter uppgraderingsprocessen den befintliga tilläggsversionen med en ny version som stöds. Som standard är funktionen för automatisk tilläggsuppgradering aktiverad för alla tillägg som distribueras i Azure Local Arc-aktiverade kluster om du inte uttryckligen avanmäler dig från automatiska uppgraderingar.
För närvarande stöds automatiska tilläggsuppgraderingar endast i Windows Admin Center-tillägget, men fler tillägg kommer att läggas till i framtiden.
Kommentar
Som standard är alla tillägg konfigurerade för att aktivera automatiska uppgraderingar, även om ett tillägg inte stöder den automatiska tilläggsuppgradering. Den här standardinställningen har dock ingen effekt förrän tilläggsutgivaren väljer att stödja automatisk tilläggsuppgradering.
För vissa tillägg kan du aktivera automatiska uppgraderingar via tilläggshantering.
Om du vill aktivera en automatisk uppgradering går du till sidan Tillägg och utför följande steg:
Välj det tillägg som du vill aktivera automatisk uppgradering på.
Välj Aktivera automatisk uppgradering på den översta menyn
När du uppmanas att bekräfta avsikten väljer du OK.
Om du vill installera och aktivera automatisk uppgradering för ett specifikt tillägg som AzureMonitorWindowsAgent kör du följande kommando:
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"
Om du vill installera och aktivera automatisk uppgradering för ett specifikt tillägg som AzureMonitorWindowsAgent kör du följande kommando:
$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
Manuell uppgradering av tillägg via Azure Portal
Den manuella tilläggsuppgradering fungerar som automatisk tilläggsuppgradering. När du uppgraderar ett tillägg manuellt i ett Azure Local Arc-aktiverat kluster sparar Azure den version som du har valt. Azure försöker sedan uppgradera tillägget på alla noder i klustret till den versionen.
Om tilläggsuppgradningen misslyckas på vissa servrar försöker plattformen uppgradera till den valda versionen under nästa Azure Local Cloud-synkronisering.
Använd det manuella arbetsflödet i följande scenarier:
En ny version av tillägget är tillgänglig och du vill uppgradera det manuellt.
Tilläggets automatiska uppgraderingsalternativ är inaktiverat och det finns ett versionsmatchningsfel mellan olika noder i Azure Local.
Om du vill uppgradera ett tillägg manuellt följer du dessa steg:
Gå till sidan Tillägg .
Välj det tillägg som du vill uppgradera och välj Inställningar på den översta menyn.
Välj den senaste versionen och välj Spara.
Inaktivera automatisk tilläggsuppgradering
Du kan inaktivera automatiska uppgraderingar för vissa tillägg i Azure Portal. Om du vill inaktivera automatiska uppgraderingar går du till sidan Tillägg och utför följande steg:
Välj det tillägg som du vill inaktivera den automatiska uppgraderingen på.
Välj Inaktivera automatisk uppgradering på den översta menyn.
När du uppmanas att bekräfta avsikten väljer du OK.
Kontrollera uppgraderingshistoriken för tillägget
Du kan visa fliken Aktivitetslogg på enskilda Azure Arc-aktiverade serverresurser, resursgrupper och prenumerationer för att kontrollera historiken för automatiska tilläggsuppgraderingar för enskilda noder. Mer information finns i Kontrollera automatisk uppgraderingshistorik för tillägg.
När en ny version av ett tillägg som stöds publiceras blir den tillgänglig för installation och manuell uppgradering på Azure Arc-aktiverade servrar. Uppgraderingar utfärdas i batchar i Azure-regioner och prenumerationer, så du kan se att en tilläggsuppgradering sker på vissa servrar före andra. Mer information finns i Tidsinställning för automatiska tilläggsuppgraderingar.
Om en tilläggsuppgradering misslyckas utför Azure de åtgärder som är associerade med automatisk återställning och återförsök i ett försök att reparera tillägget.
Om flera tilläggsuppgraderingar är tillgängliga för en nod kan de grupperas tillsammans. Varje tilläggsuppgradering tillämpas dock individuellt på noden. Mer information finns i Tilläggsuppgraderingar med flera tillägg.
Om du vill kan du avinstallera vissa tillägg från Azure Local i Azure Portal. Använd följande steg för att avinstallera ett tillägg:
Gå till sidan Tillägg.
Välj det tillägg som du vill avinstallera. Avinstallationsknappen är inte tillgänglig för Azure-hanterade tillägg.
Välj Avinstallera på den översta menyn.
Bekräfta avsikten och välj Ja.
Om du vill ta bort ett specifikt tillägg som AzureMonitorWindowsAgent kör du följande kommando:
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}"
Om du vill ta bort ett specifikt tillägg som AzureMonitorWindowsAgent kör du följande kommando:
$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}"
Felsöka tilläggsfel
Tilläggsstatus: Det gick inte
Rekommendation: För ett tillägg med statusen Misslyckad väljer du länken Misslyckades (Visa information). Visa all information om felet och använd felsökningstipsen.
