Gerenciamento de extensão do Azure Arc no Azure Local
Artigo
Aplica-se a: Azure Local, versões 23H2 e 22H2
Este artigo descreve como instalar, atualizar e gerenciar extensões do Azure Arc no Azure Local.
Extensões do Azure Arc gerenciadas pelo cliente no Azure Local
Você pode instalar, desinstalar e atualizar as extensões do Azure Arc em seu Azure Local. O Azure Arc permite executar serviços híbridos, como monitoramento e Windows Admin Center, no portal do Azure.
Aqui estão as extensões individuais que você pode instalar e gerenciar.
Depois de registrar com êxito seu novo Azure Local com o Azure, as extensões gerenciadas pelo Azure são instaladas automaticamente em seu sistema. Estas extensões são essenciais para a funcionalidade e qualidade do seu sistema e não podem ser desinstaladas. Você pode gerenciar o comportamento dessas extensões no portal do Azure navegando até a página Extensões e selecionando o menu Configurações.
Se você tiver um Azure Local existente registrado no Azure sem essas extensões, um banner será exibido na página Visão geral ou Extensões no portal do Azure. Você pode usar as informações no banner para guiá-lo através da instalação dessas extensões.
Você pode instalar extensões na guia Recursos para seus servidores habilitados para Azure Local Arc, conforme mostrado na captura de tela. Você pode usar a guia recursos para instalar a maioria das extensões.
Quando você instala uma extensão no portal do Azure, é uma operação com reconhecimento de cluster. A extensão é instalada em todos os nós do sistema. Se você adicionar mais nós ao seu sistema, todas as extensões instaladas no seu sistema serão automaticamente adicionadas aos novos servidores.
A CLI do Azure está disponível para instalação em ambientes Windows, macOS e Linux. Ele também pode ser executado no Azure Cloud Shell. Para obter mais informações, consulte Guia de início rápido para o Azure Cloud Shell.
Inicie o Azure Cloud Shell e use o Bash para instalar uma extensão seguindo estas etapas:
Configurar parâmetros da sua subscrição, grupo de recursos e 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'))
Para instalar a extensão do Windows Admin Center em todos os sistemas do grupo de recursos, execute o seguinte comando:
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
Para instalar a extensão do Azure Monitor Agent em todos os sistemas do grupo de recursos, execute o seguinte comando:
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
Para instalar a extensão do Azure Site Recovery em todos os sistemas do grupo de recursos, execute o seguinte comando:
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
O Azure PowerShell pode ser executado no Azure Cloud Shell. Este documento detalha como usar o PowerShell no Azure Cloud Shell. Para obter mais informações, consulte Guia de início rápido para o Azure Cloud Shell.
Inicie o Azure Cloud Shell e use o PowerShell para instalar uma extensão seguindo estas etapas:
Configure parâmetros da sua subscrição, grupo de recursos e 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
Para instalar a extensão do Windows Admin Center em todos os sistemas do grupo de recursos, execute o seguinte comando:
Para instalar a extensão do Azure Site Recovery em todos os sistemas do grupo de recursos, crie um arquivo de parâmetro JSON e execute o seguinte comando:
$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
}
Você pode verificar o status de uma extensão em cada servidor na página Extensões exibindo a coluna de status da grade.
A CLI do Azure está disponível para instalação em ambientes Windows, macOS e Linux. Ele também pode ser executado no Azure Cloud Shell. Para obter mais informações, consulte Guia de início rápido para o Azure Cloud Shell.
Inicie o Azure Cloud Shell e use o Bash para verificar o status de uma extensão seguindo estas etapas:
Configurar parâmetros a partir da sua subscrição, grupo de recursos, nome do cluster e nome da extensão
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}"
Para listar todas as extensões em um sistema, execute o seguinte comando:
az stack-hci extension list \
--arc-setting-name "default" \
--cluster-name "${clusterName}" \
--resource-group "${resourceGroup}" \
-o table
Para filtrar uma extensão específica, como AzureMonitorWindowsAgent, execute o seguinte comando:
O Azure PowerShell pode ser executado no Azure Cloud Shell. Este documento detalha como usar o PowerShell no Azure Cloud Shell. Para obter mais informações, consulte Guia de início rápido para o Azure Cloud Shell.
Inicie o Azure Cloud Shell e use o PowerShell para verificar o status de uma extensão seguindo estas etapas:
Configurar parâmetros a partir da sua subscrição, grupo de recursos e nome do 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
Para listar todas as extensões em um sistema, execute o seguinte comando:
Quando publicado pela equipe do editor de extensão, o processo de atualização da extensão substitui a versão de extensão existente por uma recém-suportada. Por padrão, o recurso de atualização automática de extensão é habilitado para todas as extensões implantadas em clusters habilitados para Arco Local do Azure, a menos que você exclua explicitamente as atualizações automáticas.
Atualmente, as atualizações automáticas de extensões são suportadas apenas na extensão do Windows Admin Center, mas mais extensões serão adicionadas no futuro.
Nota
Por padrão, todas as extensões são configuradas para habilitar atualizações automáticas, mesmo que uma extensão não ofereça suporte à atualização automática de extensão. No entanto, essa configuração padrão não terá efeito até que o editor de extensão opte por oferecer suporte à atualização automática de extensão.
Para algumas extensões, você pode habilitar atualizações automáticas por meio do gerenciamento de extensões.
Para habilitar uma atualização automática, navegue até a página Extensões e execute estas etapas:
Escolha a extensão na qual deseja ativar a atualização automática.
Selecione Ativar atualização automática no menu superior
Quando solicitado a confirmar sua intenção, selecione OK.
Para instalar e habilitar a atualização automática para uma extensão específica, execute AzureMonitorWindowsAgent o seguinte comando:
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"
Para instalar e habilitar a atualização automática para uma extensão específica, execute AzureMonitorWindowsAgent o seguinte comando:
$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
Atualização de extensão manual através do portal do Azure
A atualização de extensão manual funciona como a atualização de extensão automática. Em um cluster habilitado para Azure Local Arc, quando você atualiza manualmente uma extensão, o Azure salva a versão selecionada. Em seguida, o Azure tenta atualizar a extensão em todos os nós do cluster para essa versão.
Em alguns servidores, se a atualização da extensão falhar, a plataforma tentará atualizar para a versão selecionada durante a próxima sincronização de nuvem local do Azure.
Use o fluxo de trabalho manual nestes cenários:
Uma nova versão da extensão está disponível e você deseja atualizá-la manualmente.
A opção de atualização automática da extensão está desabilitada e há uma incompatibilidade de versão entre diferentes nós do Azure Local.
Para atualizar manualmente uma extensão, siga estas etapas:
Vá para a página Extensões .
Escolha a extensão que deseja atualizar e selecione Configurações no menu superior.
Escolha a versão mais recente e selecione Salvar.
Desativar a atualização automática de extensão
Você pode desabilitar atualizações automáticas para determinadas extensões no portal do Azure. Para desativar as atualizações automáticas, navegue até a página Extensões e execute estas etapas:
Escolha a extensão na qual deseja desativar a atualização automática.
Selecione Desativar atualização automática no menu superior.
Quando solicitado a confirmar sua intenção, selecione OK.
Verifique o histórico de atualização da extensão
Você pode exibir a guia Log de Atividades em recursos de servidor habilitados para Azure Arc individuais, grupos de recursos e assinaturas para verificar o histórico de atualizações automáticas de extensão para nós individuais. Para obter mais informações, consulte Verificar histórico de atualização automática de extensão.
Atualizações de disponibilidade em primeiro lugar
Para um grupo de clusters habilitados para Arco Local do Azure passando por uma atualização, a plataforma do Azure usou o modelo de atualização de extensão automática para orquestrar atualizações.
Calendário das atualizações automáticas de extensões
Quando uma nova versão de uma extensão com suporte é publicada, ela fica disponível para instalação e atualização manual em servidores habilitados para Azure Arc. As atualizações são emitidas em lotes entre regiões e assinaturas do Azure, portanto, você pode ver uma atualização de extensão ocorrer em alguns servidores antes de outros. Para obter mais informações, consulte Tempo de atualizações automáticas de extensão.
Se uma atualização de extensão falhar, o Azure executará as ações associadas à Reversão automática e tentará novamente na tentativa de reparar a extensão.
Se continuar a ter problemas com uma atualização de extensão, pode desativar a atualização automática de extensão. Quando você desabilita a atualização automática, ela evita novas tentativas do sistema enquanto soluciona o problema. Você pode ativar a atualização automática de extensão novamente quando estiver pronto.
Atualizações com várias extensões
Se várias atualizações de extensão estiverem disponíveis para um nó, elas poderão ser agrupadas em lote. No entanto, cada atualização de extensão é aplicada individualmente no nó. Para obter mais informações, consulte Atualizações de extensão com várias extensões.
Se desejar, você pode desinstalar algumas extensões do seu Azure Local no portal do Azure. Para desinstalar uma extensão, use estas etapas:
Vá para a página Extensões.
Escolha a extensão que deseja desinstalar. O botão de desinstalação não está disponível para extensões gerenciadas pelo Azure.
Selecione Desinstalar no menu superior.
Confirme a intenção e selecione Sim.
Para remover uma extensão específica, execute AzureMonitorWindowsAgent o seguinte comando:
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}"
Para remover uma extensão específica, execute AzureMonitorWindowsAgent o seguinte comando:
$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}"
Solução de problemas de erros de extensão
Status da extensão: Falha
Recomendação: Para uma extensão com um status de falha, selecione o link Falha (Exibir detalhes). Veja todas as informações sobre a falha e aplique as dicas de solução de problemas.
