Hantering av Azure Arc-tillägg på Azure Stack HCI

Artikel
02/07/2024

Gäller för: Azure Stack HCI, versionerna 23H2 och 22H2

I den här artikeln beskrivs hur du installerar, uppgraderar och hanterar Azure Arc-tillägg på Azure Stack HCI-serverdatorer.

Kundhanterade Azure Arc-tillägg på Azure Stack HCI

Med Azure Stack HCI kan du installera, avinstallera och uppdatera Azure Arc-tillägg på dina Azure Stack HCI-system. 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.

Azure-hanterade tillägg i Azure Stack HCI

När du har registrerat ditt nya Azure Stack HCI-kluster med Azure installeras Azure-hanterade tillägg automatiskt i klustret. Dessa tillägg är viktiga för systemets funktionalitet 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 ett befintligt Azure Stack HCI-kluster som är registrerat 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.

Här är de Azure-hanterade tilläggen:

Installera ett tillägg

Du kan installera tillägg från fliken Funktioner för dina Arc-aktiverade Azure Stack HCI-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 servrar i klustret. Om du lägger till fler servrar i klustret läggs alla tillägg som är installerade i klustret automatiskt till på de nya servrarna.

Azure CLI är tillgängligt för installation i Windows-, macOS- och Linux-miljöer. Den 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'))

Kör följande kommando för att installera Windows Admin Center-tillägget på alla kluster under resursgruppen:

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 kluster 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

Kör följande kommando för att installera Azure Site Recovery-tillägget på alla kluster under resursgruppen:

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

Kör följande kommando för att installera Windows Admin Center-tillägget på alla kluster under resursgruppen:

$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
}

Kör följande kommando för att installera Azure Monitor Agent-tillägget på alla kluster under resursgruppen:

$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}"
}

Om du vill installera Azure Site Recovery-tillägget på alla kluster 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
}

Kontrollera tilläggsstatusen

Du kan kontrollera status för ett tillägg på varje server från sidan Tillägg genom att visa statuskolumnen i rutnätet.

Azure CLI är tillgängligt för installation i Windows-, macOS- och Linux-miljöer. Den 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 status 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}"

Om du vill visa en lista över alla tillägg i ett kluster kör du följande kommando:

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:

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 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 status 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

Om du vill visa en lista över alla tillägg i ett kluster kör du följande kommando:

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

Så här fungerar tilläggsuppgradningen

När tilläggsutgivarteamet har publicerat den ersätter uppgraderingsprocessen för tillägget den befintliga versionen med en som nyligen stöds. Som standard är funktionen för automatisk tilläggsuppgradering aktiverad för alla tillägg som distribueras i Azure Stack HCI Arc-aktiverade kluster, såvida 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.

Anteckning

Som standard är alla tillägg konfigurerade för att aktivera automatiska uppgraderingar, även om ett tillägg inte stöder automatisk uppgradering av tillägg. Den här standardinställningen har dock ingen effekt förrän tilläggsutgivaren väljer att stödja automatisk tilläggsuppgradering.

Aktivera 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 din avsikt 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 Stack HCI Arc-aktiverat kluster sparar Azure den version som du har valt. Azure försöker sedan uppgradera tillägget på alla servrar i klustret till den versionen.

Om uppgraderingen av tillägget misslyckas på vissa servrar försöker plattformen uppgradera till den valda versionen under nästa Azure Stack HCI-molnsynkronisering.

Använd det manuella arbetsflödet i följande scenarier:

En ny version av tillägget är tillgänglig och du vill uppgradera den manuellt.
Tilläggets automatiska uppgraderingsalternativ är inaktiverat och det finns ett versionsmatchningsfel på olika servrar i Azure Stack HCI-klustret.

Så här uppgraderar du ett tillägg manuellt:

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 din avsikt 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 klusterservrar. Mer information finns i Kontrollera uppgraderingshistoriken för automatiska tillägg.

Uppdateringar av tillgänglighet först

För en grupp Azure Stack HCI Arc-aktiverade kluster som genomgår en uppgradering använde Azure-plattformen uppgraderingsmodellen automatisk tilläggsuppgradering för att orkestrera uppgraderingar.

Tidsinställning för automatiska tilläggsuppgraderingar

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.

Information om hur du uppgraderar ett tillägg omedelbart finns i Manuell tilläggsuppgradering via Azure Portal.

Automatisk återställning och återförsök

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 du fortsätter att ha problem med en tilläggsuppgradering kan du inaktivera automatisk tilläggsuppgradering. När du inaktiverar den automatiska uppgraderingen förhindrar det systemförsök när du felsöker problemet. Du kan aktivera automatisk tilläggsuppgradering igen när du är klar.

Uppgraderingar med flera tillägg

Om flera tilläggsuppgraderingar är tillgängliga för en dator kan de batchas tillsammans. Varje tilläggsuppgradering tillämpas dock individuellt på datorn. Mer information finns i Tilläggsuppgraderingar med flera tillägg.

Avinstallera ett tillägg

Om du vill kan du avinstallera vissa tillägg från dina Azure Stack HCI-kluster 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: Misslyckades

Rekommendation: För ett tillägg med statusen Misslyckad väljer du länken Misslyckades (visa information). Visa all information om felet och tillämpa felsökningstipsen.

Nästa steg

Läs mer om hantering av tillägg för virtuella datorer med Azure Arc-aktiverade servrar.

Dela via