Habilitar o gerenciamento de convidados para VMs migradas (visualização)

Artigo
11/23/2024

Aplica-se a: Azure Local, versão 23H2

Este artigo descreve como habilitar o gerenciamento de convidados após a migração para máquinas virtuais (VMs) Arc em execução no Azure Local, versão 23H2.

Para obter mais informações sobre outros cenários, consulte Manage Arc VMs on Azure Local.

As propriedades de saída podem variar dependendo se as VMs foram migradas ou não.

Importante

Este recurso está atualmente em visualização. Veja Termos de Utilização Complementares da Pré-visualizações do Microsoft Azure para obter os termos legais que se aplicam às funcionalidades do Azure que estão na versão beta, na pré-visualização ou que ainda não foram lançadas para disponibilidade geral.

Pré-requisitos

Antes de começar, conclua o seguinte:

Você tem acesso a uma instância local do Azure implantada e registrada, com um Arc Resource Bridge e um local personalizado configurados.
Seu sistema está executando o Azure Local, versão 23H2, versão 2405 ou posterior.
A CLI do Azure é instalada na instância Local do Azure. Para obter instruções, consulte Instalar a CLI do Azure para Windows.

Adicione a extensão stack-hci-vm do Azure executando o PowerShell como administrador:

Para adicionar a extensão stack-hci-vm , execute o seguinte cmdlet:
```
az extension add --name stack-hci-vm --upgrade 
```

Para verificar a instalação e verificar se a versão stack-hci-vm é 1.1.5 ou posterior:

PS C:\Users\AzureStackAdminD> az version
{
    "azure-cli": ”2.60.0”,
    "azure-cli-core": ”2.60.0”,
    "azure-cli-telemetry": "1.1.0",
    "extensions": {
        "aksarc": ‘1. 2.20" ,
        "arcappliance": "1.1.1", 
        "connectedk8s": "1.6. 2‘ ,
        "customlocation": "0.1.3",
        "k8s-extension": "1.4. 5" ,
        "stack-hci-vm": "1.1.8"
}

Familiarize-se com VMs Arc e recursos e considerações de gerenciamento de convidados - consulte Habilitar gerenciamento de convidados.

Habilitar o agente convidado em VMs migradas

Todas as VMs Hyper-V geração 1 devem ser desligadas antes de prosseguir com as etapas a seguir. Não há esse requisito para VMs Hyper-V geração 2, elas podem estar ligadas ou desligadas e espera-se que ambos os estados de energia funcionem.

Etapa 1: Verifique o estado de energia das VMs migradas da seguinte maneira:

Para o Hyper-V Geração 1, verifique se a VM está parada. Consulte o Apêndice para a mensagem de erro se ela não for interrompida.

Usando o portal do Azure (recomendado)
1. Para interromper a migração da VM do portal do Azure, selecione Parar na página de detalhes da VM:
1. Aguarde e atualize a página para ver se o Status da VM é mostrado como Parado.
Utilizar a CLI do Azure
1. Conecte-se à máquina local do Azure e abra uma janela do PowerShell. Faça logon com a CLI do Azure.
```
az login --use-device-code --tenant $tenantId
```
2. Verifique o estado de energia da VM usando a CLI do Azure da seguinte maneira:
```
az stack-hci-vm show --name $vmName --resource-group $rgName --query "properties.status"
```
  Saída de exemplo:
```
PS C : \Users\AzureStackAdminD> az stack-hci-vm show --name <VM name> --resource-group <resource group> --query "properties.status"
{
    "errorCode":
    "errorMessage" :
    "powerstate": "Stopped",
    "provisioningstatus": null
}
```
Para VMs Hyper-V geração 2, verifique se o status de energia mostrado no portal do Azure corresponde ao estado real de energia da VM migrada no Gerenciador do Hyper-V, independentemente de estar Ativada ou Desativada:

Vista do portal do Azure

Modo de exibição do Gerenciador do Hyper-V

Etapa 2: Anexe o ISO para o agente convidado na VM migrada da seguinte maneira:

Conecte-se a uma máquina Local do Azure e execute o seguinte comando no PowerShell, onde $vmName é o nome da VM migrada para ter o agente convidado habilitado e $rgName é o nome do grupo de recursos onde essa VM reside no Azure:

az stack-hci-vm update --name $vmName --resource-group $rgName --enable-vm-config-agent true

Resultado do exemplo:

PS C:\Users\AzureStackAdminD> az stack-hci-vm update --name $vmName -enable-vm-config-agent true --resource-group $resourceGroup
{
"endTime": "2024-08-19T22:01:22.1060463z",
"error": {},
"extendedLocation": null ,
"id": "<ID>",
"identity": null,
"name": "<Name>",
"properties": null,
"resourceld": "<Resource ID>",
"startTime": "2024-08-19T22: 01:09.4898702z" ,
"status": "Succeeded",
"systemData" : null,
"type": null
}

Estado de exemplo da VM com o ISO anexado, visualizado a partir do sistema Azure Local:

Etapa 3: Ative a VM migrada, se necessário, no portal do Azure e verifique se ela tem conectividade de rede pública da seguinte maneira:

Verifique se o Status da VM no portal do Azure está em execução:

Verifique se o powerState da VM está em execução executando o seguinte comando em sua máquina local do Azure em uma janela do PowerShell:

az stack-hci-vm show --name $vmName --resource-group $rgName --query “properties.status”

PS C: \Users\AzureStackAdminD> az stack-hci-vm show --name <Name> --resource-group <Resource group> --query "properties.status" 
{
"errorCode":
"errorMessage":
"powerState": "Running",
"provisioningStatus": null
}

Etapa 4: Instale o ISO do agente convidado na VM migrada da seguinte maneira:

Conecte-se à VM usando suas etapas específicas do sistema operacional aplicáveis.
Estabeleça conectividade de rede pública na VM.

Execute o seguinte comando para habilitar o agente convidado na VM com base no sistema operacional que você está usando:

Se estiver no Linux, abra o Terminal e execute:

sudo -- sh -c 'mkdir /mociso && mount -L mocguestagentprov /mociso && bash /mociso/install.sh && umount /mociso && rm -df /mociso'

Saída de exemplo (Linux):

migration@migration-virtual-machine: $ sudo -- sh -c 'mkdir /mociso && mount -L mocguestagentprov /nociso && bash /mociso/install.sh && umount /mociso && rm -df/mociso && eject LABEL=mocguestagentprov'
[sudo] password for migration:
mount: /moctso: WARNING: device write-protected, mounted read-only.
Loading configuration version 've.16.5'...
The agent could not find the '/opt/mocguestagent/v0.16.5/config.yaml' config file. Looking for older versions to upgrade from...
Service installed.
Service started.
The guest agent was successfully installed.

Se estiver no Windows, abra o PowerShell como administrador e execute:

  $d=Get-Volume -FileSystemLabel mocguestagentprov;$p=Join-Path ($d.DriveLetter+':\') 'install.ps1';powershell $p

Saída de exemplo (Windows):

PS C:\Users\Administrator> $d=Get-Volume -FilesystemLabel mocguestagentprov;$p=Join-Path ($d.DriveLetter+':\') 'install ps1';powershell $p

Directory : C : \ProgramData\mocguestagent


Mode	LastWriteTime	Length Name
----    -------------   -----------
d------	8/19/2024	5:46 PM	certs
Loading configuration version 'v0.16.5'...
The agent could not find the 'C:\ProgramData\mocguestagent\v0.16.5\config.yaml' config file. Looking for older versions to upgrade from...
Service installed.
Service started.
The guest agent was successfully installed.

Habilite o gerenciamento de hóspedes

Você pode habilitar o gerenciamento de convidados depois que o agente convidado estiver sendo executado da seguinte maneira:

Habilite o gerenciamento de convidados da sua instância Local do Azure executando o seguinte comando na CLI do Azure:

az stack-hci-vm update --name $vmName --resource-group $rgName --enable-agent true

Saída de exemplo:

PS C:\Users\AzureStackAdminD> az stack-hci-vm update --name $vmName --resource-group $resourceGroup --enable-agent true
{
"endTime": "2024-08-19T22:59:13.9583373Z”,
"error": {},
"extendedLocation" : null,
"id": "/<ID>",
"identity": null,
"name": "<Name>",
"properties": null,
"resourceld": "<Resource ID",
"startTime": "2024-08-19t22:28:23.8158331Z",
"status": "Succeeded",
"systemData": null,
"type": null
}

Verifique o status da ativação do gerenciamento de convidados no portal do Azure:
Agora você está pronto para adicionar as extensões do Azure de sua escolha.

Se você encontrar algum problema, entre em contato com o Suporte da Microsoft e forneça seus logs e detalhes de implantação.

Anexo

Se você esqueceu de desativar a VM Hyper-V Geração 1 antes de executar o comando update com --enable-vm-config-agent true, o comando update falhará e a VM poderá se tornar não gerenciável no portal do Azure:

PS C:\Users\AzureStackAdminD> az stack-hci-vm update --name <VM name> -- resource-group <Resource group> --enable-vm-config-agent true
(Failed) moc-operator virtualmachine serviceclient returned an error while reconciling: rpc error: code = Unknown dasc = AddlSODisk for IsoFile mocguestagentprov.iso failed. Error: ErrorCode[32768] ErrorDescription[<VM name>' failed to add device 'Synthetic DVD Drive'. (Virtual machine ID <VM ID>)] ErrorSummaryDescription [Failed to add device 'Synthetic DVD Drive'.]: WMI Error 0x00008000: Failed
Code: Failed
Message: moc-operator virtualmachine serviceclient returned an error while reconciling: rpc error: code = Unknown desc = AddlSODisk for IsoFile mocguestagentprov.iso failed. Error: ErrorCode[32768] ErrorDescription['<VM name>' failed to add device 'Synthetic DVD Drive'. (Virtual machine ID <VM ID>)] ErrorSummaryDescription [Failed to add device 'Synthetic DVD Drive'.]: WMI Error 0x00008000: Failed

Para resolver isso, pare a VM no portal do Azure selecionando Parar. Se isso não funcionar, execute o seguinte comando da CLI do Azure:

az stack-hci-vm stop --name $vmName --resource-group $rgName

Você pode ver um erro de provisionamento de recurso com falha no portal do Azure com as seleções Iniciar, Reiniciar e Parar desabilitadas, mas o Gerenciador do Hyper-V deve mostrar que a VM está realmente parada:

az stack-hci-vm update --name $vmName --resource-group $rgName --enable-vm-config-agent true

Próximos passos

Se você tiver algum problema, consulte Solucionar problemas de migração do VMware.

Partilhar via