Gerenciamento de extensão do Azure Arc no Azure Stack HCI
Artigo
Aplica-se a: Azure Stack HCI, versões 23H2 e 22H2
Este artigo descreve como instalar, atualizar e gerenciar extensões do Azure Arc em computadores de servidor do Azure Stack HCI.
Extensões do Azure Arc gerenciadas pelo cliente no Azure Stack HCI
Com o Azure Stack HCI, você pode instalar, desinstalar e atualizar extensões do Azure Arc em seus sistemas do Azure Stack HCI. 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.
Extensões gerenciadas pelo Azure no Azure Stack HCI
Depois de registrar com êxito seu novo cluster do Azure Stack HCI com o Azure, as extensões gerenciadas pelo Azure serão instaladas automaticamente no cluster. Essas extensões são essenciais para a funcionalidade e a qualidade do 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 cluster do Azure Stack HCI existente 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 na faixa para orientá-lo na instalação dessas extensões.
Você pode instalar extensões na guia Funcionalidades para seus servidores habilitados para Azure Stack HCI Arc, conforme mostrado na captura de tela. Você pode usar a guia funcionalidades para instalar a maioria das extensões.
Quando você instala uma extensão no portal do Azure, ela é uma operação com reconhecimento de cluster. A extensão é instalada em todos os servidores do cluster. Se você adicionar mais servidores ao cluster, todas as extensões instaladas no cluster 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 para Cloud Shell do Azure.
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 clusters 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 clusters 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 Site Recovery do Azure em todos os clusters 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
Azure PowerShell pode ser executado no Cloud Shell do Azure. Este documento detalha como usar o PowerShell no Azure Cloud Shell. Para obter mais informações, consulte Início Rápido para Cloud Shell do Azure.
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 clusters no grupo de recursos, execute o seguinte comando:
Para instalar a extensão de Site Recovery do Azure em todos os clusters 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 marcar o status de uma extensão em cada servidor na página Extensões exibindo a coluna 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 para Cloud Shell do Azure.
Inicie o Azure Cloud Shell e use o Bash para marcar o status de uma extensão seguindo estas etapas:
Configurar parâmetros de sua assinatura, 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 cluster, 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:
Azure PowerShell pode ser executado no Cloud Shell do Azure. Este documento detalha como usar o PowerShell no Azure Cloud Shell. Para obter mais informações, consulte Início Rápido para Cloud Shell do Azure.
Inicie o Azure Cloud Shell e use o PowerShell para marcar o status de uma extensão seguindo estas etapas:
Configurar parâmetros de sua assinatura, 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 cluster, execute o seguinte comando:
Quando publicado pela equipe do editor de extensão, o processo de atualização de extensão substitui a versão de extensão existente por uma com suporte recente. 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 Stack HCI Arc, a menos que você opte explicitamente por não fazer upgrades automáticos.
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 terá efeito até que o editor de extensão opte por dar 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ão.
Para habilitar uma atualização automática, navegue até a página Extensões e execute estas etapas:
Escolha a extensão na qual você deseja habilitar a atualização automática.
Selecione Habilitar 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, como AzureMonitorWindowsAgent executar 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, como AzureMonitorWindowsAgent executar 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 de extensão por meio do portal do Azure
A atualização manual da extensão funciona como a Atualização automática de extensão. Em um cluster habilitado para Azure Stack HCI 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 servidores 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 do Azure Stack HCI.
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 em diferentes servidores do cluster do Azure Stack HCI.
Para atualizar manualmente uma extensão, siga estas etapas:
Vá para a página Extensões .
Escolha a extensão que você 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 desabilitar atualizações automáticas, navegue até a página Extensões e execute estas etapas:
Escolha a extensão na qual você deseja desabilitar a atualização automática.
Selecione Desabilitar atualização automática no menu superior.
Quando solicitado a confirmar sua intenção, selecione OK.
Verificar o histórico de atualização da extensão
Você pode exibir a guia Log de Atividades em recursos de servidor, grupos de recursos e assinaturas habilitados para Azure Arc individuais para marcar o histórico de atualizações automáticas de extensão para servidores de cluster 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 Stack HCI Arc que passam por uma atualização, a plataforma do Azure usou o modelo de atualização de extensão automática para orquestrar atualizações.
Tempo de atualizações automáticas de extensão
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 em 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 várias atualizações de extensão estiverem disponíveis para um computador, elas poderão ser agrupadas em lote. No entanto, cada atualização de extensão é aplicada individualmente no computador. Para obter mais informações, consulte Atualizações de extensão com várias extensões.
Se desejado, você pode desinstalar algumas extensões de seus clusters do Azure Stack HCI no portal do Azure. Para desinstalar uma extensão, use estas etapas:
Vá para a página Extensões.
Escolha a extensão que você 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, como AzureMonitorWindowsAgent , execute 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, como AzureMonitorWindowsAgent , execute 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 uma status com falha, selecione o link Falha (Exibir detalhes). Exiba todas as informações sobre a falha e aplique as dicas de solução de problemas.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
