Gestione delle estensioni di Azure Arc in Azure Stack HCI
Articolo
Si applica a: Azure Stack HCI, versioni 23H2 e 22H2
Questo articolo descrive come installare, aggiornare e gestire le estensioni di Azure Arc nei computer server Azure Stack HCI.
Estensioni di Azure Arc gestite dal cliente in Azure Stack HCI
Con Azure Stack HCI è possibile installare, disinstallare e aggiornare le estensioni di Azure Arc nei sistemi Azure Stack HCI. Azure Arc consente di eseguire servizi ibridi come monitoraggio e Windows Admin Center nell'portale di Azure.
Ecco le singole estensioni che è possibile installare e gestire.
Dopo aver registrato correttamente il nuovo cluster Azure Stack HCI con Azure, le estensioni gestite da Azure vengono installate automaticamente nel cluster. Queste estensioni sono essenziali per la funzionalità e la qualità del sistema e non possono essere disinstallate. È possibile gestire il comportamento di queste estensioni nel portale di Azure passando alla pagina Estensioni e selezionando il menu Impostazioni.
Se si dispone di un cluster HCI di Azure Stack esistente registrato in Azure senza queste estensioni, viene visualizzato un banner nella pagina Panoramica o estensioni nell'portale di Azure. È possibile usare le informazioni nel banner per guidarvi tramite l'installazione di queste estensioni.
È possibile installare le estensioni dalla scheda Funzionalità per i server abilitati per Azure Stack HCI Arc, come illustrato nello screenshot. È possibile usare la scheda funzionalità per installare la maggior parte delle estensioni.
Quando si installa un'estensione nella portale di Azure, si tratta di un'operazione con riconoscimento del cluster. L'estensione viene installata in tutti i server del cluster. Se si aggiungono altri server al cluster, tutte le estensioni installate nel cluster vengono aggiunte automaticamente ai nuovi server.
L'interfaccia della riga di comando di Azure è disponibile per l'installazione in ambienti Windows, macOS e Linux. Può essere eseguita anche in Azure Cloud Shell. Per altre informazioni, vedere Avvio rapido per Azure Cloud Shell.
Avviare Azure Cloud Shell e usare Bash per installare un'estensione seguendo questa procedura:
Configurare i parametri dalla sottoscrizione, dal gruppo di risorse e dai 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'))
Per installare l'estensione Windows Admin Center in tutti i cluster nel gruppo di risorse, eseguire il comando seguente:
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
Per installare l'estensione agente di Monitoraggio di Azure in tutti i cluster nel gruppo di risorse, eseguire il comando seguente:
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
Per installare l'estensione azure Site Recovery in tutti i cluster nel gruppo di risorse eseguire il comando seguente:
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 può essere eseguito in Azure Cloud Shell. Questo documento illustra in dettaglio come usare PowerShell in Azure Cloud Shell. Per altre informazioni, vedere Avvio rapido per Azure Cloud Shell.
Avviare Azure Cloud Shell e usare PowerShell per installare un'estensione seguendo questa procedura:
Configurare i parametri dalla sottoscrizione, dal gruppo di risorse e dai 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
Per installare l'estensione Windows Admin Center in tutti i cluster nel gruppo di risorse, eseguire il comando seguente:
Per installare l'estensione di Azure Site Recovery in tutti i cluster nel gruppo di risorse, creare un file di parametri JSON e quindi eseguire il comando seguente:
$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
}
È possibile controllare lo stato di un'estensione in ogni server dalla pagina Estensioni visualizzando la colonna di stato della griglia.
L'interfaccia della riga di comando di Azure è disponibile per l'installazione in ambienti Windows, macOS e Linux. Può essere eseguita anche in Azure Cloud Shell. Per altre informazioni, vedere Avvio rapido per Azure Cloud Shell.
Avviare Azure Cloud Shell e usare Bash per controllare lo stato di un'estensione seguendo questa procedura:
Configurare i parametri dalla sottoscrizione, dal gruppo di risorse, dal nome del cluster e dal nome dell'estensione
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}"
Per elencare tutte le estensioni in un cluster, eseguire il comando seguente:
az stack-hci extension list \
--arc-setting-name "default" \
--cluster-name "${clusterName}" \
--resource-group "${resourceGroup}" \
-o table
Per filtrare un'estensione specifica come AzureMonitorWindowsAgent, eseguire il comando seguente:
Azure PowerShell può essere eseguito in Azure Cloud Shell. Questo documento illustra in dettaglio come usare PowerShell in Azure Cloud Shell. Per altre informazioni, vedere Avvio rapido per Azure Cloud Shell.
Avviare Azure Cloud Shell e usare PowerShell per controllare lo stato di un'estensione seguendo questa procedura:
Configurare i parametri dalla sottoscrizione, dal gruppo di risorse e dal nome del 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
Per elencare tutte le estensioni in un cluster, eseguire il comando seguente:
Quando pubblicato dal team di pubblicazione dell'estensione, il processo di aggiornamento dell'estensione sostituisce la versione dell'estensione esistente con una nuova versione supportata. Per impostazione predefinita, la funzionalità di aggiornamento automatico dell'estensione è abilitata per tutte le estensioni distribuite nei cluster abilitati per Azure Stack HCI Arc, a meno che non si espliciti esplicitamente rifiutare gli aggiornamenti automatici.
Attualmente, gli aggiornamenti automatici delle estensioni sono supportati solo nell'estensione Windows Admin Center, ma altre estensioni verranno aggiunte in futuro.
Nota
Per impostazione predefinita, tutte le estensioni vengono configurate per abilitare gli aggiornamenti automatici, anche se un'estensione non supporta l'aggiornamento automatico dell'estensione. Tuttavia, questa impostazione predefinita non ha alcun effetto finché il server di pubblicazione dell'estensione sceglie di supportare l'aggiornamento automatico dell'estensione.
In alcuni server, se l'aggiornamento dell'estensione ha esito negativo, la piattaforma tenta di eseguire l'aggiornamento alla versione selezionata durante la successiva sincronizzazione cloud di Azure Stack HCI.
Usare il flusso di lavoro manuale in questi scenari:
Una nuova versione dell'estensione è disponibile e si vuole aggiornarla manualmente.
L'opzione di aggiornamento automatico dell'estensione è disabilitata e si verifica una mancata corrispondenza tra server diversi del cluster Azure Stack HCI.
Per aggiornare manualmente un'estensione, seguire questa procedura:
Passare alla pagina Estensioni .
Scegliere l'estensione da aggiornare e selezionare Impostazioni dal menu in alto.
Scegliere la versione più recente e selezionare Salva.
È possibile disabilitare gli aggiornamenti automatici per determinate estensioni nella portale di Azure. Per disabilitare gli aggiornamenti automatici, passare alla pagina Estensioni ed eseguire questa procedura:
Scegliere l'estensione in cui si vuole disabilitare l'aggiornamento automatico.
Selezionare Disabilita aggiornamento automatico dal menu in alto.
Quando viene richiesto di confermare la finalità, selezionare OK.
Controllare la cronologia dell'aggiornamento dell'estensione
È possibile visualizzare la scheda Log attività in singole risorse server abilitate per Azure Arc, gruppi di risorse e sottoscrizioni per controllare la cronologia degli aggiornamenti automatici delle estensioni per i singoli server del cluster. Per altre informazioni, vedere Controllare la cronologia degli aggiornamenti automatici dell'estensione.
Aggiornamenti per la prima disponibilità
Per un gruppo di cluster abilitati per Azure Stack HCI Arc durante un aggiornamento, la piattaforma Azure ha usato il modello di aggiornamento dell'estensione automatico per orchestrare gli aggiornamenti.
Tempi di aggiornamento automatico delle estensioni
Quando viene pubblicata una nuova versione di un'estensione supportata, diventa disponibile per l'installazione e l'aggiornamento manuale nei server abilitati per Azure Arc. Gli aggiornamenti vengono emessi in batch in aree e sottoscrizioni di Azure, quindi potrebbe verificarsi un aggiornamento dell'estensione in alcuni server prima di altri. Per altre informazioni, vedere Intervallo degli aggiornamenti automatici delle estensioni.
Se un aggiornamento dell'estensione ha esito negativo, Azure esegue le azioni associate al rollback automatico e riprova in un tentativo di ripristino dell'estensione.
Se per un computer sono disponibili più aggiornamenti di estensione, potrebbero essere in batch. Tuttavia, ogni aggiornamento dell'estensione viene applicato singolarmente nel computer. Per altre informazioni, vedere Aggiornamenti delle estensioni con più estensioni.
Se necessario, è possibile disinstallare alcune estensioni dai cluster Azure Stack HCI nel portale di Azure. Per disinstallare un'estensione, seguire questa procedura:
Passare alla pagina Estensioni.
Scegliere l'estensione da disinstallare. Il pulsante di disinstallazione non è disponibile per le estensioni gestite da Azure.
Selezionare Disinstalla dal menu in alto.
Confermare la finalità e selezionare Sì.
Per rimuovere un'estensione specifica come AzureMonitorWindowsAgent eseguire il comando seguente:
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}"
Per rimuovere un'estensione specifica come AzureMonitorWindowsAgent eseguire il comando seguente:
$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}"
Risoluzione dei problemi di errori di estensione
Stato dell'estensione: Non riuscito
Raccomandazione: per un'estensione con stato non riuscito, selezionare il collegamento Non riuscito (Visualizza dettagli). Visualizzare tutte le informazioni sull'errore e applicare i suggerimenti per la risoluzione dei problemi.
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedere https://aka.ms/ContentUserFeedback.