Gestione delle estensioni di Azure Arc in Locale di Azure
Articolo
Si applica a: Azure Local 2311.2 e versioni successive
Questo articolo descrive come installare, aggiornare e gestire le estensioni di Azure Arc in Locale di Azure.
Estensioni Di Azure Arc gestite dal cliente in Locale di Azure
È possibile installare, disinstallare e aggiornare le estensioni di Azure Arc nell'istanza locale di Azure. Azure Arc consente di eseguire servizi ibridi come il monitoraggio e Windows Admin Center nella portale di Azure.
Ecco le singole estensioni che è possibile installare e gestire.
Dopo aver registrato correttamente la nuova istanza locale di Azure con Azure, le estensioni gestite da Azure vengono installate automaticamente nel sistema. 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'istanza locale di Azure esistente registrata in Azure senza queste estensioni, viene visualizzato un banner nella pagina Panoramica o Estensioni del portale di Azure. È possibile usare le informazioni nel banner per guidare l'installazione di queste estensioni.
È possibile installare le estensioni dalla scheda Funzionalità per i server abilitati per Azure Local 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 compatibile con il cluster. L'estensione viene installata in tutti i nodi del sistema. Se si aggiungono altri nodi al sistema, tutte le estensioni installate nel sistema 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 eseguito 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 sistemi 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 sistemi 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 sistemi 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 sistemi nel gruppo di risorse, eseguire il comando seguente:
Per installare l'estensione Azure Site Recovery in tutti i sistemi 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 eseguito 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 sistema, 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 sistema, eseguire il comando seguente:
Quando pubblicato dal team di pubblicazione delle estensioni, il processo di aggiornamento dell'estensione sostituisce la versione dell'estensione esistente con quella appena supportata. Per impostazione predefinita, la funzionalità di aggiornamento automatico delle estensioni è abilitata per tutte le estensioni distribuite nei cluster abilitati per Azure Local Arc, a meno che non si escludono esplicitamente gli aggiornamenti automatici.
Attualmente, gli aggiornamenti automatici delle estensioni sono supportati solo nell'estensione di Windows Admin Center, ma in futuro verranno aggiunte altre estensioni.
Nota
Per impostazione predefinita, tutte le estensioni sono 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 non sceglie di supportare l'aggiornamento automatico dell'estensione.
Per alcune estensioni, è possibile abilitare gli aggiornamenti automatici tramite la gestione delle estensioni.
Per abilitare un aggiornamento automatico, passare alla pagina Estensioni ed eseguire questi passaggi:
Scegliere l'estensione in cui si vuole abilitare l'aggiornamento automatico.
Selezionare Abilita aggiornamento automatico dal menu in alto
Quando viene richiesto di confermare la finalità, selezionare OK.
Per installare e abilitare l'aggiornamento automatico per un'estensione specifica, ad esempio AzureMonitorWindowsAgent eseguire il comando seguente:
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"
Per installare e abilitare l'aggiornamento automatico per un'estensione specifica, ad esempio AzureMonitorWindowsAgent eseguire il comando seguente:
$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
Aggiornamento manuale dell'estensione tramite il portale di Azure
L'aggiornamento manuale dell'estensione funziona come l'aggiornamento automatico dell'estensione. In un cluster abilitato per Azure Local Arc, quando si aggiorna manualmente un'estensione, Azure salva la versione selezionata. Azure tenta quindi di aggiornare l'estensione in tutti i nodi del cluster a tale versione.
In alcuni server, se l'aggiornamento dell'estensione non riesce, la piattaforma tenta di eseguire l'aggiornamento alla versione selezionata durante la successiva sincronizzazione cloud locale di Azure.
Usare il flusso di lavoro manuale in questi scenari:
È disponibile una nuova versione dell'estensione e si vuole aggiornarla manualmente.
L'opzione di aggiornamento automatico dell'estensione è disabilitata ed è presente una mancata corrispondenza della versione tra nodi diversi di Azure Locale.
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.
Disabilitare l'aggiornamento automatico delle estensioni
È possibile disabilitare gli aggiornamenti automatici per determinate estensioni nel 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 nodi. Per altre informazioni, vedere Controllare la cronologia di aggiornamento automatico dell'estensione.
Aggiornamenti basati sulla disponibilità
Per un gruppo di cluster abilitati per Azure Local Arc in fase di aggiornamento, la piattaforma Azure ha usato il modello di aggiornamento automatico delle estensioni per orchestrare gli aggiornamenti.
Temporizzazione degli aggiornamenti automatici 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 rilasciati in batch tra 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 non riesce, Azure esegue le azioni associate al rollback automatico e riprova nel tentativo di ripristinare l'estensione.
Se si continuano a verificarsi problemi con un aggiornamento dell'estensione, è possibile disabilitare l'aggiornamento automatico dell'estensione. Quando si disabilita l'aggiornamento automatico, impedisce i tentativi di sistema durante la risoluzione del problema. È possibile abilitare di nuovo l'aggiornamento automatico dell'estensione quando si è pronti.
Aggiornamenti con più estensioni
Se sono disponibili più aggiornamenti di estensione per un nodo, potrebbero essere raggruppati in batch. Tuttavia, ogni aggiornamento dell'estensione viene applicato singolarmente al nodo. Per altre informazioni, vedere Aggiornamenti delle estensioni con più estensioni.
Se lo si desidera, è possibile disinstallare alcune estensioni dall'istanza locale di Azure nella 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 degli errori delle estensioni
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.
