Azure Arc-extensiebeheer in Azure Local

Van toepassing op: Azure Local 2311.2 en hoger

In dit artikel wordt uitgelegd hoe u Azure Arc-extensies installeert, upgradet en beheert in Azure Local.

Door de klant beheerde Azure Arc-extensies in Azure Local

U kunt Azure Arc-extensies installeren, verwijderen en bijwerken op uw lokale Azure-locatie. Met Azure Arc kunt u hybride services uitvoeren, zoals bewaking en Windows Admin Center in Azure Portal.

Hier volgen de afzonderlijke extensies die u kunt installeren en beheren.

Door Azure beheerde extensies in Azure Local

Nadat u uw nieuwe Azure Local hebt geregistreerd bij Azure, worden door Azure beheerde extensies automatisch op uw systeem geïnstalleerd. Deze extensies zijn essentieel voor de functionaliteit en kwaliteit van uw systeem en u kunt ze niet verwijderen. U kunt het gedrag van extensies beheren in Azure Portal op de pagina Extensies door het menu Instellingen te selecteren.

Als u een bestaande Lokale Versie van Azure hebt die is geregistreerd bij Azure zonder deze extensies, wordt er een banner weergegeven op de pagina Overzicht of Extensies in Azure Portal. U kunt de informatie in de banner gebruiken om u te begeleiden bij het installeren van deze extensies.

Door Azure beheerde extensies zijn onder andere:

Een extensie installeren

U kunt het tabblad Mogelijkheden gebruiken om extensies te installeren voor uw servers met Lokale Arc van Azure, zoals wordt weergegeven in de schermopname. U kunt dit tabblad gebruiken om de meeste extensies te installeren.

Het installeren van een extensie in Azure Portal is een clusterbewuste bewerking. De extensie wordt geïnstalleerd op alle knooppunten van het systeem. Als u meer knooppunten aan uw systeem toevoegt, worden alle geïnstalleerde extensies automatisch toegevoegd aan de nieuwe servers.

Azure CLI is beschikbaar voor installatie in Windows-, macOS- en Linux-omgevingen. U kunt deze ook uitvoeren in Azure Cloud Shell. Raadpleeg de quickstart voor Azure Cloud Shell voor meer informatie.

Start Azure Cloud Shell en gebruik Bash om een extensie te installeren door de volgende stappen uit te voeren:

Stel parameters in voor uw abonnement, resourcegroep en clusters.

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'))

Installeer de Windows Admin Center-extensie op alle systemen onder de resourcegroep door de volgende opdracht uit te voeren:

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

Installeer de Azure Monitor Agent-extensie op alle systemen onder de resourcegroep door de volgende opdracht uit te voeren:

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

Installeer de Azure Site Recovery-extensie op alle systemen onder de resourcegroep door de volgende opdracht uit te voeren:

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

Voer Azure PowerShell uit in Azure Cloud Shell. Zie Quickstart voor Azure Cloud Shell voor meer informatie.

Start Azure Cloud Shell en gebruik PowerShell om een extensie te installeren door de volgende stappen uit te voeren:

Stel parameters in voor uw abonnement, resourcegroep en clusters.

$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

Installeer de Windows Admin Center-extensie op alle systemen onder de resourcegroep door de volgende opdracht uit te voeren:

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

Installeer de Azure Monitor Agent-extensie op alle systemen onder de resourcegroep door de volgende opdracht uit te voeren:

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

Installeer de Azure Site Recovery-extensie op alle systemen onder de resourcegroep, maak een JSON-parameterbestand en voer vervolgens de volgende opdracht uit:

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

De extensiestatus controleren

U kunt de status van een extensie op elke server controleren op de pagina Extensies door de statuskolom van het raster te bekijken.

Azure CLI is beschikbaar voor installatie in Windows-, macOS- en Linux-omgevingen. Het kan ook worden uitgevoerd in Azure Cloud Shell. Raadpleeg de quickstart voor Azure Cloud Shell voor meer informatie.

Start Azure Cloud Shell en gebruik Bash om de status van een extensie te controleren door de volgende stappen uit te voeren:

Stel parameters in voor uw abonnement, resourcegroep, clusternaam en extensienaam.

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

Voer de volgende opdracht uit om alle extensies op een systeem weer te geven:

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

Voer de volgende opdracht uit om een specifieke extensie uit te filteren, zoals AzureMonitorWindowsAgent:

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 worden uitgevoerd in Azure Cloud Shell. Zie Quickstart voor Azure Cloud Shell voor meer informatie.

Start Azure Cloud Shell en gebruik PowerShell om de status van een extensie te controleren door de volgende stappen uit te voeren:

Parameters instellen vanuit uw abonnement, resourcegroep en clusternaam

$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

Geef alle extensies op een systeem weer door de volgende opdracht uit te voeren:

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

Hoe de extensie-upgrade werkt

Wanneer dit wordt gepubliceerd door het uitgeversteam van de extensie, vervangt het upgradeproces van de extensie de bestaande extensieversie door een nieuw ondersteunde versie. De functie voor automatische uitbreidingsupgrade is standaard ingeschakeld voor alle extensies die zijn geïmplementeerd in clusters met Azure Local Arc, tenzij u expliciet afmeldt voor automatische upgrades.

Op dit moment worden automatische uitbreidingsupgrades alleen ondersteund in de Windows Admin Center-extensie, maar er worden in de toekomst meer extensies toegevoegd.

Notitie

Standaard zijn alle extensies ingesteld om automatische upgrades in te schakelen, maar deze instelling werkt alleen als de uitgever dit ondersteunt. Als een extensie niet is ingesteld om automatische upgrades in te schakelen, vindt de upgrade plaats tijdens het updateproces van de oplossing. Na verloop van tijd worden handmatige uitbreidingsupgrades overgeschakeld naar automatische upgrades.

Automatische extensie-upgrade inschakelen

Voor sommige extensies kunt u automatische upgrades inschakelen via extensiebeheer.

Als u een automatische upgrade wilt inschakelen, gaat u naar de pagina Extensies en voert u de volgende stappen uit:

Kies de extensie waarvoor u automatische upgrade wilt inschakelen.
Selecteer Automatische upgrade inschakelen in het bovenste menu
Wanneer u wordt gevraagd uw intentie te bevestigen, selecteert u OK.

Voer de volgende opdracht uit om automatische upgrade voor een specifieke extensie te installeren en in te schakelen, zoals AzureMonitorWindowsAgent:

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"

Voer de volgende opdracht uit om automatische upgrade voor een specifieke extensie te installeren en in te schakelen, zoals AzureMonitorWindowsAgent:

$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

Handmatige uitbreidingsupgrade via Azure Portal

De handmatige extensie-upgrade werkt als de automatische extensie-upgrade. Wanneer u een extensie handmatig bijwerken, slaat Azure de versie op die u hebt geselecteerd in een cluster met lokale Arc-functionaliteit. Vervolgens probeert Azure de extensie bij te werken op alle knooppunten in het cluster naar die versie. Zorg ervoor dat extensies worden ondersteund voor handmatige upgrade.

Als de upgrade van de extensie op sommige servers mislukt, probeert het platform tijdens de volgende lokale Azure-cloudsynchronisatie een upgrade uit te voeren naar de geselecteerde versie.

Gebruik de handmatige werkstroom in deze scenario's:

Er is een nieuwe versie van de extensie beschikbaar en u wilt deze handmatig bijwerken.
De optie voor automatische upgrade van de extensie is uitgeschakeld en er is een versie die niet overeenkomt met verschillende knooppunten van Azure Local.

Voer de volgende stappen uit om handmatig een extensie bij te werken:

Ga naar de pagina Extensies .
Kies de extensie die u wilt upgraden en selecteer Instellingen in het bovenste menu.
Kies de nieuwste versie en selecteer Opslaan.

Extensies worden niet ondersteund voor handmatige upgrade

Het handmatig bijwerken van Azure Arc-extensies vanaf de pagina Azure Local Machine via Azure Portal kan leiden tot problemen tijdens de implementatie. De extensies die niet handmatig moeten worden bijgewerkt, zijn: AzureEdgeDeviceManagement, AzureEdgeLifecycleManageren AzureEdgeAKVBackupForWindows zoals wordt weergegeven in de afbeelding.

Automatische uitbreidingsupgrade uitschakelen

U kunt automatische upgrades uitschakelen voor bepaalde extensies in Azure Portal. Als u automatische upgrades wilt uitschakelen, gaat u naar de pagina Extensies en voert u de volgende stappen uit:

Kies de extensie waarvoor u de automatische upgrade wilt uitschakelen.
Selecteer Automatische upgrade uitschakelen in het bovenste menu.
Wanneer u wordt gevraagd uw intentie te bevestigen, selecteert u OK.

De upgradegeschiedenis van de extensie controleren

U kunt het tabblad Activiteitenlogboek bekijken op afzonderlijke serverresources, resourcegroepen en abonnementen met Azure Arc om de geschiedenis van automatische uitbreidingsupgrades voor afzonderlijke knooppunten te controleren. Zie De geschiedenis van automatische uitbreidingsupgrades controleren voor meer informatie.

Beschikbaarheid-georiënteerde updates

Voor een groep clusters met azure Local Arc die een upgrade ondergaan, heeft het Azure-platform het model voor automatische uitbreidingsupgrade gebruikt om upgrades te organiseren.

Timing van automatische uitbreidingsupgrades

Wanneer een nieuwe versie van een ondersteunde extensie wordt gepubliceerd, wordt deze beschikbaar voor installatie en handmatige upgrade op servers met Azure Arc. Upgrades worden uitgegeven in batches tussen Azure-regio's en -abonnementen, dus u ziet mogelijk een extensie-upgrade op sommige servers voordat andere. Zie Timing van automatische uitbreidingsupgrades voor meer informatie.

Als u een extensie onmiddellijk wilt upgraden, raadpleegt u Handmatige extensie-upgrade via Azure Portal.

Automatisch terugdraaien en nieuwe pogingen

Als een upgrade van de extensie mislukt, voert Azure de acties uit die zijn gekoppeld aan automatische terugdraaibewerking en nieuwe pogingen in een poging om de extensie te herstellen.

Als u problemen ondervindt met een extensie-upgrade, kunt u de automatische extensie-upgrade uitschakelen. Wanneer u de automatische upgrade uitschakelt, voorkomt het opnieuw proberen van het systeem terwijl u het probleem oplost. U kunt de automatische uitbreidingsupgrade weer inschakelen wanneer u klaar bent.

Upgrades met meerdere extensies

Als er meerdere uitbreidingsupgrades beschikbaar zijn voor een knooppunt, kunnen ze samen worden gebatcheerd. Elke extensie-upgrade wordt echter afzonderlijk toegepast op het knooppunt. Zie Uitbreidingsupgrades met meerdere extensies voor meer informatie.

Een extensie verwijderen

Indien nodig kunt u enkele extensies verwijderen uit uw Lokale Azure-portal in Azure Portal. Als u een extensie wilt verwijderen, voert u de volgende stappen uit:

Ga naar de pagina Extensies.
Kies de extensie die u wilt verwijderen. De knop Verwijderen is niet beschikbaar voor door Azure beheerde extensies.
Selecteer Verwijderen in het bovenste menu.
Bevestig dat u de extensie wilt verwijderen en selecteer Ja.

Voer de volgende opdracht uit om een specifieke extensie te verwijderen, zoals AzureMonitorWindowsAgent:

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