Migrar recursos de IaaS do clássico para o Azure Resource Manager usando o PowerShell

Aplica-se a: ✔️ VMs do Linux ✔️ VMs do Windows

Estas etapas mostram como usar os comandos do Azure PowerShell para migrar os recursos de IaaS (infraestrutura como serviço) do modelo de implantação clássico para o Modelo de implantação do Azure Resource Manager.

Se quiser, você também poderá migrar recursos usando a CLI do Azure.

• Para obter informações sobre cenários de migração com suporte, confira Migração de recursos de IaaS com suporte da plataforma do clássico ao Azure Resource Manager.
• Para obter orientação e um passo a passo sobre a migração, confira Análise técnica aprofundada sobre a migração com suporte da plataforma do clássico ao Azure Resource Manager.
• Examine os erros de migração mais comuns.

Este é um fluxograma para identificar a ordem em que as etapas precisam ser executadas durante um processo de migração.

Etapa 1: Planejar a migração

Veja a seguir algumas das práticas que recomendamos para avaliar se recursos de IaaS devem ser migrados do modelo clássico para o Resource Manager:

• Leia os recursos e configurações com e sem suporte. Caso você tenha máquinas virtuais que usam recursos ou configurações sem suporte, aguarde até que o suporte do recurso/configuração seja anunciado. Como alternativa, se isso atender às suas necessidades, remova esse recurso ou mude a configuração para habilitar a migração.
• Se você tiver scripts automatizados que implantam sua infraestrutura e aplicativos atualmente, tente criar uma configuração de teste semelhante usando esses scripts para migração. Você também pode configurar ambientes de exemplo usando o portal do Azure.

Etapa 2: instalar a versão mais recente do PowerShell

Há duas opções principais para instalar o Azure PowerShell, a Galeria do PowerShell e o WebPI (Web Platform Installer). WebPI recebe atualizações mensais. A Galeria do PowerShell receberá atualizações continuamente. Este artigo tem base no Azure PowerShell versão 2.1.0.

Para obter instruções de instalação, consulte Como instalar e configurar o Azure PowerShell.

Etapa 3: certifique-se de que você é administrador da assinatura

Para executar essa migração, você deve ser adicionado como coadministrador da assinatura no portal do Azure.

1. Entre no portal do Azure.
2. No menu Hub, selecione Assinatura. Caso não visualize essa opção, selecione Todos os serviços.
3. Localize a entrada de assinatura apropriada, em seguida, examine o campo MINHA FUNÇÃO. Para um coadministrador, o valor deve ser administrador da conta.

Se você não conseguir adicionar um coadministrador, contate um administrador de serviços ou o coadministrador da assinatura para ser adicionado.

Etapa 4: definir a assinatura e se inscrever para a migração

Primeiro, inicie um prompt do PowerShell. Para a migração, configure o ambiente tanto para o modelo clássico quanto para o Resource Manager.

Entre em sua conta para o modelo do Gerenciador de Recursos.

    Connect-AzAccount

Obtenha as assinaturas disponíveis usando o comando a seguir:

    Get-AzSubscription | Sort Name | Select Name

Defina sua assinatura do Azure para a sessão atual. Este exemplo define o nome da assinatura padrão como Minha Assinatura do Azure. Substitua o nome da assinatura de exemplo pelo nome da sua própria assinatura.

    Select-AzSubscription –SubscriptionName "My Azure Subscription"

Registre-se no provedor de recursos de migração usando o comando a seguir:

    Register-AzResourceProvider -ProviderNamespace Microsoft.ClassicInfrastructureMigrate

Aguarde cinco minutos para concluir o registro. Verifique o status da aprovação com o comando a seguir:

    Get-AzResourceProvider -ProviderNamespace Microsoft.ClassicInfrastructureMigrate

Verifique se RegistrationState é Registered antes de continuar.

Antes de alternar para o modelo de implantação clássico, verifique se há vCPUs de máquina virtual do Azure Resource Manager suficientes na região do Azure da sua implantação ou rede virtual atual. Você pode usar o seguinte comando do PowerShell para verificar a quantidade atual de vCPUs no Azure Resource Manager. Para saber mais sobre cotas de vCPUs, veja Limites e o Azure Resource Manager.

Este exemplo verifica a disponibilidade na região Oeste dos EUA. Substitua o nome da região de exemplo pelo nome da sua própria região.

    Get-AzVMUsage -Location "West US"

Agora, entre em sua conta do modelo de implantação clássico.

    Add-AzureAccount

Obtenha as assinaturas disponíveis usando o comando a seguir:

    Get-AzureSubscription | Sort SubscriptionName | Select SubscriptionName

Defina sua assinatura do Azure para a sessão atual. Este exemplo define a assinatura padrão como Minha Assinatura do Azure. Substitua o nome da assinatura de exemplo pelo nome da sua própria assinatura.

    Select-AzureSubscription –SubscriptionName "My Azure Subscription"

Etapa 5: Executar comandos para migrar os recursos de IaaS

• Migrar VMs em um serviço de nuvem (não em rede virtual)
• Migrar VMs em uma rede virtual
• Migrar uma conta de armazenamento

Etapa 5a: opção 1 – Migrar máquinas virtuais em um serviço de nuvem (não em uma rede virtual)

Obtenha a lista de serviços de nuvem com o comando a seguir. Em seguida, escolha o serviço de nuvem que você deseja migrar. Se as VMs no serviço de nuvem estiverem em uma rede virtual, ou se tiverem funções Web ou de trabalho, o comando retornará uma mensagem de erro.

    Get-AzureService | ft Servicename

Obtenha o nome da implantação do serviço de nuvem. Neste exemplo, o nome do serviço é Meu Serviço. Substitua o nome do serviço de exemplo pelo nome de seu próprio serviço.

    $serviceName = "My Service"
    $deployment = Get-AzureDeployment -ServiceName $serviceName
    $deploymentName = $deployment.DeploymentName

Prepare as máquinas virtuais no serviço de nuvem para migração. Você tem duas opções entre as quais escolher.

• Opção 1: migrar as VMs para uma rede virtual criada com uma plataforma.

  Primeiro, valide se você pode migrar o serviço de nuvem usando os seguintes comandos:

  $validate = Move-AzureService -Validate -ServiceName $serviceName `
      -DeploymentName $deploymentName -CreateNewVirtualNetwork
  $validate.ValidationMessages
  

  O comando a seguir exibe todos os avisos e erros que bloqueiam a migração. Se as mensagens de validação não contiverem mensagens do tipo erro, passe para a etapa de preparação.

  Move-AzureService -Prepare -ServiceName $serviceName `
      -DeploymentName $deploymentName -CreateNewVirtualNetwork
  

• Opção 2: Migrar para uma rede virtual existente no modelo de implantação do Resource Manager.

  Este exemplo define o nome do grupo de recursos como myResourceGroup, o nome da rede virtual como myVirtualNetwork e o nome da sub-rede como mySubNet. Substitua os nomes de exemplo pelos nomes de seus próprios recursos.

  $existingVnetRGName = "myResourceGroup"
  $vnetName = "myVirtualNetwork"
  $subnetName = "mySubNet"
  

  Primeiro, valide se você pode migrar a rede virtual usando o seguinte comando:

  $validate = Move-AzureService -Validate -ServiceName $serviceName `
      -DeploymentName $deploymentName -UseExistingVirtualNetwork -VirtualNetworkResourceGroupName $existingVnetRGName -VirtualNetworkName $vnetName -SubnetName $subnetName
  $validate.ValidationMessages
  

  O comando a seguir exibe todos os avisos e erros que bloqueiam a migração. Se as mensagens de validação não contiverem erros, prossiga para a seguinte etapa de preparação:

      Move-AzureService -Prepare -ServiceName $serviceName -DeploymentName $deploymentName `
      -UseExistingVirtualNetwork -VirtualNetworkResourceGroupName $existingVnetRGName `
      -VirtualNetworkName $vnetName -SubnetName $subnetName
  

Após a operação de Preparação ser bem-sucedida com uma das opções anteriores, consulte o estado de migração das VMs. Certifique-se de que elas estejam no estado Prepared.

Este exemplo define o nome da VM como myVM. Substitua o nome de exemplo pelo nome de sua própria VM.

    $vmName = "myVM"
    $vm = Get-AzureVM -ServiceName $serviceName -Name $vmName
    $vm.VM.MigrationState

Verifique a configuração dos recursos preparados usando o PowerShell ou o Portal do Azure. Se você não estiver pronto para a migração e desejar voltar para o estado anterior, use o comando a seguir:

    Move-AzureService -Abort -ServiceName $serviceName -DeploymentName $deploymentName

Se a configuração preparada estiver correta, será possível continuar e confirmar os recursos usando o comando a seguir:

    Move-AzureService -Commit -ServiceName $serviceName -DeploymentName $deploymentName

Etapa 5a: opção 2 – Migrar máquinas virtuais em uma rede virtual

Para migrar máquinas virtuais em uma rede virtual, migre a rede virtual. As máquinas virtuais são migradas automaticamente com a rede virtual. Selecione a rede virtual que você deseja migrar.

O exemplo a seguir define o nome da rede virtual como Grupo [resource-group-name] [vnet-name]. Substitua o nome da rede virtual de exemplo por um que foi retornado da execução do comando na seção Observação acima.

    $vnetName = "Group [resource-group-name] [vnet-name]"

Primeiro, valide se você pode migrar a rede virtual usando o seguinte comando:

    Move-AzureVirtualNetwork -Validate -VirtualNetworkName $vnetName

O comando a seguir exibe todos os avisos e erros que bloqueiam a migração. Se a validação for bem-sucedida, prossiga com a seguinte etapa de Preparação:

    Move-AzureVirtualNetwork -Prepare -VirtualNetworkName $vnetName

Verifique a configuração para as máquinas virtuais preparadas usando o Azure PowerShell ou o Portal do Azure. Se você não estiver pronto para a migração e desejar voltar para o estado anterior, use o comando a seguir:

    Move-AzureVirtualNetwork -Abort -VirtualNetworkName $vnetName

Se a configuração preparada estiver correta, será possível continuar e confirmar os recursos usando o comando a seguir:

    Move-AzureVirtualNetwork -Commit -VirtualNetworkName $vnetName

Etapa 5b: migrar uma conta de armazenamento

Ao concluir a migração das máquinas virtuais, execute as seguintes verificações de pré-requisitos antes de migrar as contas de armazenamento.

• Os pré-requisitos verificam se você migrou uma VM ou se a conta de armazenamento tem recursos de disco:

  • Migre as máquinas virtuais cujos discos estão armazenados na conta de armazenamento.

    O comando a seguir retorna as propriedades RoleName e DiskName de todos os discos da VM na conta de armazenamento. RoleName é o nome da máquina virtual à qual um disco está anexado. Se o comando retornar discos, migre as máquinas virtuais às quais os discos estão conectados antes de migrar a conta de armazenamento.

     $storageAccountName = 'yourStorageAccountName'
      Get-AzureDisk | where-Object {$_.MediaLink.Host.Contains($storageAccountName)} | Select-Object -ExpandProperty AttachedTo -Property `
      DiskName | Format-List -Property RoleName, DiskName
    
    

  • Exclua os discos de VM não conectados armazenados na conta de armazenamento.

    Localize discos de VM clássica não conectados na conta de armazenamento com o comando a seguir:

        $storageAccountName = 'yourStorageAccountName'
        Get-AzureDisk | where-Object {$_.MediaLink.Host.Contains($storageAccountName)} | Where-Object -Property AttachedTo -EQ $null | Format-List -Property DiskName  
    
    

    Se o comando anterior retornar discos, exclua-os usando o seguinte comando:

       Remove-AzureDisk -DiskName 'yourDiskName'
    

  • Exclua as imagens da VM armazenadas na conta de armazenamento.

    O comando a seguir retorna todas as imagens de VM com discos de SO armazenadas na conta de armazenamento.

       Get-AzureVmImage | Where-Object { $_.OSDiskConfiguration.MediaLink -ne $null -and $_.OSDiskConfiguration.MediaLink.Host.Contains($storageAccountName)`
                               } | Select-Object -Property ImageName, ImageLabel
    

    O comando a seguir retorna todas as imagens de VM com discos de dados armazenados na conta de armazenamento.

    
       Get-AzureVmImage | Where-Object {$_.DataDiskConfigurations -ne $null `
                                        -and ($_.DataDiskConfigurations | Where-Object {$_.MediaLink -ne $null -and $_.MediaLink.Host.Contains($storageAccountName)}).Count -gt 0 `
                                       } | Select-Object -Property ImageName, ImageLabel
    

    Exclua todas as imagens de VM retornadas pelos comandos anteriores com este comando:

    Remove-AzureVMImage -ImageName 'yourImageName'
    

• Valide as contas de armazenamento e inicie a migração.

  Valide cada conta de armazenamento para migração usando o comando a seguir. Neste exemplo, o nome da conta de armazenamento é myStorageAccount. Substitua o nome de exemplo pelo nome da sua própria conta de armazenamento.

      $storageAccountName = "myStorageAccount"
      Move-AzureStorageAccount -Validate -StorageAccountName $storageAccountName
  

  A próxima etapa é preparar a conta de armazenamento para a migração.

      $storageAccountName = "myStorageAccount"
      Move-AzureStorageAccount -Prepare -StorageAccountName $storageAccountName
  

  Verifique a configuração da conta de armazenamento preparada usando o Azure PowerShell ou o Portal do Azure. Se você não estiver pronto para a migração e desejar voltar para o estado anterior, use o comando a seguir:

      Move-AzureStorageAccount -Abort -StorageAccountName $storageAccountName
  

  Se a configuração preparada estiver correta, será possível continuar e confirmar os recursos usando o comando a seguir:

      Move-AzureStorageAccount -Commit -StorageAccountName $storageAccountName
  

Próximas etapas

• Visão geral da migração de recursos de IaaS com suporte da plataforma do clássico para o Azure Resource Manager
• Análise técnica aprofundada sobre a migração com suporte da plataforma do clássico para o Azure Resource Manager
• Planejamento para a migração de recursos de IaaS do clássico para o Azure Resource Manager
• Usar a CLI para migrar recursos de IaaS do clássico para o Azure Resource Manager
• Ferramentas da comunidade para ajudar com a migração de recursos de IaaS do clássico para o Azure Resource Manager
• Examinar os erros de migração mais comuns
• Confira as perguntas mais frequentes sobre a migração de recursos de IaaS do clássico para o Azure Resource Manager