Gestion des extensions Azure Arc sur Azure Stack HCI

Article
01/31/2024

S’applique à : Azure Stack HCI, versions 23H2 et 22H2

Cet article explique comment installer, mettre à niveau et gérer des extensions Azure Arc sur des machines serveur Azure Stack HCI.

Extensions Azure Arc gérées par le client sur Azure Stack HCI

Avec Azure Stack HCI, vous pouvez installer, désinstaller et mettre à jour des extensions Azure Arc sur vos systèmes Azure Stack HCI. Azure Arc vous permet d’exécuter des services hybrides tels que la supervision et la Windows Admin Center dans le Portail Azure.

Voici les extensions individuelles que vous pouvez installer et gérer.

Extensions gérées par Azure dans Azure Stack HCI

Une fois que vous avez correctement inscrit votre nouveau cluster Azure Stack HCI auprès d’Azure, les extensions gérées par Azure sont automatiquement installées sur votre cluster. Ces extensions sont essentielles pour la fonctionnalité et la qualité de votre système et ne peuvent pas être désinstallées. Vous pouvez gérer le comportement de ces extensions dans le Portail Azure en accédant à la page Extensions et en sélectionnant le menu Paramètres.

Si vous avez un cluster Azure Stack HCI existant inscrit auprès d’Azure sans ces extensions, une bannière s’affiche sur la page Vue d’ensemble ou Extensions dans le Portail Azure. Vous pouvez utiliser les informations de la bannière pour vous guider dans l’installation de ces extensions.

Voici les extensions gérées par Azure :

Installer une extension

Vous pouvez installer des extensions à partir de l’onglet Fonctionnalités pour vos serveurs Avec Azure Stack HCI Arc, comme illustré dans la capture d’écran. Vous pouvez utiliser l’onglet Fonctionnalités pour installer la plupart des extensions.

Lorsque vous installez une extension dans le Portail Azure, il s’agit d’une opération prenant en charge le cluster. L’extension est installée sur tous les serveurs du cluster. Si vous ajoutez d’autres serveurs à votre cluster, toutes les extensions installées sur votre cluster sont automatiquement ajoutées aux nouveaux serveurs.

Azure CLI est disponible pour l’installation dans les environnements Windows, macOS et Linux. Il peut également être exécuté dans Azure Cloud Shell. Pour plus d’informations, consultez Démarrage rapide pour Azure Cloud Shell.

Lancez Azure Cloud Shell et utilisez Bash pour installer une extension en suivant ces étapes :

Configurer les paramètres de votre abonnement, groupe de ressources et 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'))

Pour installer l’extension Windows Admin Center sur tous les clusters sous le groupe de ressources, exécutez la commande suivante :

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

Pour installer l’extension Agent Azure Monitor sur tous les clusters sous le groupe de ressources, exécutez la commande suivante :

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

Pour installer l’extension Azure Site Recovery sur tous les clusters sous le groupe de ressources, exécutez la commande suivante :

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 peut être exécuté dans Azure Cloud Shell. Ce document explique en détail comment utiliser PowerShell dans Azure Cloud Shell. Pour plus d’informations, consultez Démarrage rapide pour Azure Cloud Shell.

Lancez Azure Cloud Shell et utilisez PowerShell pour installer une extension en procédant comme suit :

Configurez les paramètres de votre abonnement, groupe de ressources et 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

Pour installer l’extension Windows Admin Center sur tous les clusters sous le groupe de ressources, exécutez la commande suivante :

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

Pour installer l’extension Agent Azure Monitor sur tous les clusters sous le groupe de ressources, exécutez la commande suivante :

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

Pour installer l’extension Azure Site Recovery sur tous les clusters sous le groupe de ressources, créez un fichier de paramètres JSON, puis exécutez la commande suivante :

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

Vérifier l’état de l’extension

Vous pouvez case activée le status d’une extension sur chaque serveur à partir de la page Extensions en affichant la colonne status de la grille.

Lancez Azure Cloud Shell et utilisez Bash pour case activée l’status d’une extension en procédant comme suit :

Configurer les paramètres de votre abonnement, groupe de ressources, nom de cluster et nom d’extension

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

Pour répertorier toutes les extensions d’un cluster, exécutez la commande suivante :

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

Pour filtrer une extension spécifique comme AzureMonitorWindowsAgent, exécutez la commande suivante :

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

Lancez Azure Cloud Shell et utilisez PowerShell pour case activée la status d’une extension en procédant comme suit :

Configurer les paramètres de votre abonnement, groupe de ressources et nom de 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

Pour répertorier toutes les extensions d’un cluster, exécutez la commande suivante :

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

Fonctionnement de la mise à niveau de l’extension

Lorsqu’il est publié par l’équipe de l’éditeur d’extension, le processus de mise à niveau de l’extension remplace la version d’extension existante par une nouvelle version prise en charge. Par défaut, la fonctionnalité de mise à niveau automatique des extensions est activée pour toutes les extensions déployées sur des clusters Avec Azure Stack HCI Arc, sauf si vous refusez explicitement les mises à niveau automatiques.

Actuellement, les mises à niveau automatiques d’extension sont uniquement prises en charge dans l’extension Windows Admin Center, mais d’autres extensions seront ajoutées à l’avenir.

Notes

Par défaut, toutes les extensions sont configurées pour activer les mises à niveau automatiques, même si une extension ne prend pas en charge la mise à niveau automatique de l’extension. Toutefois, ce paramètre par défaut n’a pas d’effet tant que l’éditeur d’extension choisit de prendre en charge la mise à niveau automatique d’extension.

Activer la mise à niveau automatique des extensions

Pour certaines extensions, vous pouvez activer les mises à niveau automatiques via la gestion des extensions.

Pour activer une mise à niveau automatique, accédez à la page Extensions et effectuez les étapes suivantes :

Choisissez l’extension sur laquelle vous souhaitez activer la mise à niveau automatique.
Sélectionnez Activer la mise à niveau automatique dans le menu supérieur.
Lorsque vous êtes invité à confirmer votre intention, sélectionnez OK.

Pour installer et activer la mise à niveau automatique pour une extension spécifique, par exemple AzureMonitorWindowsAgent , exécutez la commande suivante :

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"

Pour installer et activer la mise à niveau automatique pour une extension spécifique, par exemple AzureMonitorWindowsAgent , exécutez la commande suivante :

$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

Mise à niveau manuelle de l’extension via le Portail Azure

La mise à niveau manuelle de l’extension fonctionne comme la mise à niveau automatique de l’extension. Sur un cluster Azure Stack HCI Arc, lorsque vous mettez à niveau manuellement une extension, Azure enregistre la version que vous avez sélectionnée. Azure tente ensuite de mettre à niveau l’extension sur tous les serveurs du cluster vers cette version.

Sur certains serveurs, si la mise à niveau de l’extension échoue, la plateforme tente de mettre à niveau vers la version sélectionnée lors de la prochaine synchronisation cloud Azure Stack HCI.

Utilisez le flux de travail manuel dans les scénarios suivants :

Une nouvelle version de l’extension est disponible et vous souhaitez la mettre à niveau manuellement.
L’option de mise à niveau automatique de l’extension est désactivée et il existe une incompatibilité de version entre les différents serveurs du cluster Azure Stack HCI.

Pour mettre à niveau manuellement une extension, procédez comme suit :

Accédez à la page Extensions .
Choisissez l’extension à mettre à niveau et sélectionnez Paramètres dans le menu supérieur.
Choisissez la dernière version, puis sélectionnez Enregistrer.

Désactiver la Mise à niveau automatique des extensions

Vous pouvez désactiver les mises à niveau automatiques pour certaines extensions dans le Portail Azure. Pour désactiver les mises à niveau automatiques, accédez à la page Extensions et effectuez les étapes suivantes :

Choisissez l’extension sur laquelle vous souhaitez désactiver la mise à niveau automatique.
Sélectionnez Désactiver la mise à niveau automatique dans le menu supérieur.
Lorsque vous êtes invité à confirmer votre intention, sélectionnez OK.

Vérifier l’historique de mise à niveau de l’extension

Vous pouvez afficher l’onglet Journal d’activité sur des ressources de serveur, des groupes de ressources et des abonnements avec Azure Arc individuels pour case activée l’historique des mises à niveau automatiques des extensions pour des serveurs de cluster individuels. Pour plus d’informations, consultez Vérifier l’historique de mise à niveau automatique des extensions.

Mises à jour selon la première disponibilité

Pour un groupe de clusters avec Azure Stack HCI Arc en cours de mise à niveau, la plateforme Azure a utilisé le modèle de mise à niveau automatique de l’extension pour orchestrer les mises à niveau.

Minutage des mises à niveau automatiques des extensions

Lorsqu’une nouvelle version d’une extension prise en charge est publiée, elle devient disponible pour l’installation et la mise à niveau manuelle sur les serveurs avec Azure Arc. Les mises à niveau étant émises par lots dans les régions et abonnements Azure, vous pouvez voir une mise à niveau d’extension sur certains serveurs avant d’autres. Pour plus d’informations, consultez Minutage des mises à niveau automatiques des extensions.

Pour mettre à niveau immédiatement une extension, consultez Mise à niveau manuelle de l’extension via le Portail Azure.

Restauration automatique et nouvelles tentatives

Si une mise à niveau d’extension échoue, Azure effectue les actions associées à la restauration automatique et tente à nouveau de réparer l’extension.

Si vous continuez à rencontrer des problèmes avec une mise à niveau d’extension, vous pouvez désactiver la mise à niveau automatique de l’extension. Lorsque vous désactivez la mise à niveau automatique, cela empêche les nouvelles tentatives du système pendant que vous résolvez le problème. Vous pouvez réactiver la mise à niveau automatique de l’extension lorsque vous êtes prêt.

Mises à niveau avec plusieurs extensions

Si plusieurs mises à niveau d’extension sont disponibles pour une machine, elles peuvent être regroupées. Toutefois, chaque mise à niveau d’extension est appliquée individuellement sur l’ordinateur. Pour plus d’informations, consultez Mises à niveau d’extension avec plusieurs extensions.

Désinstaller une extension

Si vous le souhaitez, vous pouvez désinstaller certaines extensions de vos clusters Azure Stack HCI dans le Portail Azure. Pour désinstaller une extension, procédez comme suit :

Accédez à la page Extensions.
Choisissez l’extension que vous souhaitez désinstaller. Le bouton Désinstaller n’est pas disponible pour les extensions gérées par Azure.
Sélectionnez Désinstaller dans le menu supérieur.
Confirmez l’intention et sélectionnez Oui.

Pour supprimer une extension spécifique, par exemple AzureMonitorWindowsAgent , exécutez la commande suivante :

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

Pour supprimer une extension spécifique, par exemple AzureMonitorWindowsAgent , exécutez la commande suivante :

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

Résolution des problèmes liés aux erreurs d’extension

État de l’extension : Échec

Recommandation : Pour une extension dont l’status a échoué, sélectionnez le lien Échec (Afficher les détails). Affichez toutes les informations sur l’échec et appliquez les conseils de résolution des problèmes.

Étape suivante

Découvrez la gestion des extensions de machine virtuelle avec des serveurs avec Azure Arc.

Partager via