Habilitar o gerenciamento de convidados para VMs migradas (versão prévia)

Artigo
11/23/2024

Aplica-se a: Azure Local 2311.2 e posterior

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

Para obter mais informações sobre outros cenários, consulte Gerenciar VMs do Arc no Azure Local.

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

Importante

Esse recurso está em VERSÃO PRÉVIA no momento. Veja os Termos de Uso Complementares para Versões Prévias do Microsoft Azure para obter termos legais que se aplicam aos recursos do Azure que estão em versão beta, versão prévia ou que, de outra forma, ainda não foram lançados em disponibilidade geral.

Pré-requisitos

Antes de começar, faça o seguinte:

Você tem acesso a uma instância local do Azure implantada e registrada, com uma ponte de recursos do Arc 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 as VMs do Arc e os recursos e considerações de gerenciamento de convidados – consulte Habilitar o gerenciamento de convidados.

Habilitar o agente convidado em VMs migradas

Todas as VMs do 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 ativadas ou desativadas 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 obter a mensagem de erro se ela não for interrompida.

Usando o portal do Azure (recomendado)
1. Para interromper a VM migrada 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.
Usar a CLI do Azure
1. Conecte-se ao computador local do Azure e abra uma janela do PowerShell. Entre 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 do Hyper-V geração 2, verifique se o status de energia mostrado no portal do Azure corresponde ao estado de energia real da VM migrada no Gerenciador do Hyper-V, independentemente de estar Ativado ou Desativado:

Exibição do portal do Azure

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

Etapa 2: anexe o ISO do agente convidado na VM migrada da seguinte maneira:

Conecte-se a um computador local do Azure e execute o seguinte comando no PowerShell, em que $vmName é o nome da VM migrada para ter o agente convidado habilitado e $rgName é o nome do grupo de recursos em que essa VM reside no Azure:

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

Saída de 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, exibido no sistema local do Azure:

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 no computador 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 as 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'

Exemplo de saída (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.

Habilitar o gerenciamento de convidados

Você pode ativar o gerenciamento de convidados depois que o agente convidado estiver em execução da seguinte maneira:

Habilite o gerenciamento de convidados da 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 habilitaçã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.

Apêndice

Se você esqueceu de desativar a VM do Hyper-V Geração 1 antes de executar o comando de atualização com --enable-vm-config-agent true, o comando de atualização falhará e a VM poderá se tornar incontrolá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 na CLI do Azure:

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

Você pode ver um erro Falha no provisionamento do recurso 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óximas etapas

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

Compartilhar via