Gerenciamento de extensões 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 que você execute 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. Essas 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 registrado no Azure sem essas extensões, uma faixa será exibida na página Visão geral ou Extensões no portal do Azure. Você pode usar as informações no banner para orientá-lo na instalação dessas extensões.
Você pode instalar extensões da guia Recursos para seus servidores habilitados para Azure Arc Local, conforme mostrado na captura de tela. Você pode usar a guia de 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 sistema serão adicionadas automaticamente 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 Início Rápido do Azure Cloud Shell.
Inicie o Azure Cloud Shell e use o Bash para instalar uma extensão seguindo estas etapas:
Configurar parâmetros de sua assinatura, 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 Windows Admin Center em todos os sistemas no 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 Agente do Azure Monitor em todos os sistemas no 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 no 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 Início Rápido do Azure Cloud Shell.
Inicie o Azure Cloud Shell e use o PowerShell para instalar uma extensão seguindo estas etapas:
Configure parâmetros de sua assinatura, 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 Windows Admin Center em todos os sistemas no grupo de recursos, execute o seguinte comando:
Para instalar a extensão do Azure Site Recovery em todos os sistemas no 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 Início Rápido do 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 da assinatura, do grupo de recursos, do nome do cluster e do 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 Início Rápido do 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 da assinatura, do grupo de recursos e do 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 da extensão, o processo de atualização da extensão substitui a versão da extensão existente por uma recém-suportada. Por padrão, o recurso de atualização automática de extensão está habilitado para todas as extensões implantadas em clusters habilitados para Azure Local Arc, a menos que você recuse explicitamente as atualizações automáticas.
Atualmente, as atualizações automáticas de extensão só têm suporte na extensão Windows Admin Center, mas mais extensões serão adicionadas no futuro.
Observação
Por padrão, todas as extensões são configuradas para habilitar atualizações automáticas, mesmo que uma extensão não dê suporte à atualização automática de extensão. No entanto, essa configuração padrão não tem efeito até que o editor da extensão opte por dar suporte à atualização automática da 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 manual da extensão por meio do portal do Azure
A atualização manual da extensão funciona como a atualização automática da extensão. 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.
Desabilitar 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 o histórico de atualização automática de extensão.
Atualizações com priorização de disponibilidade
Para um grupo de clusters habilitados para Azure Local Arc que estão passando por uma atualização, a plataforma do Azure usou o modelo de atualização de extensão automática para orquestrar atualizações.
Tempo 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 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 Azure Local no portal do Azure. Para desinstalar uma extensão, siga 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 da extensão
Status da extensão: Falha
Recomendação: para uma extensão com um status de falha, selecione o link Falha (Exibir detalhes). Visualize todas as informações sobre a falha e aplique as dicas de solução de problemas.
