Partilhar via

Migrate IaaS resources from classic to Azure Resource Manager by using Azure CLI (Migrar recursos IaaS de clássica para Azure Resource Manager com a CLI do Azure)

  • Artigo

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

Importante

Atualmente, cerca de 90% das VMs IaaS estão usando o Azure Resource Manager. A partir de 28 de fevereiro de 2020, as VMs clássicas foram preteridas e serão totalmente desativadas em 6 de setembro de 2023. Saiba mais sobre essa depreciação e como ela afeta você.

Estas etapas mostram como usar comandos da CLI para migrar recursos de infraestrutura como serviço (IaaS) do modelo de implantação clássico para o modelo de implantação do Azure Resource Manager. O artigo requer a CLI clássica do Azure. Como a CLI do Azure só se aplica aos recursos do Azure Resource Manager, ela não pode ser usada para essa migração.

Nota

Todas as operações aqui descritas são idempotentes. Se você tiver um problema diferente de um recurso sem suporte ou um erro de configuração, recomendamos que tente novamente a operação de preparação, anulação ou confirmação. Em seguida, a plataforma tentará a ação novamente.


Aqui está um fluxograma para identificar a ordem na qual as etapas precisam ser executadas durante um processo de migração

Captura de ecrã que mostra os passos da migração

Etapa 1: Preparar a migração

Aqui estão algumas práticas recomendadas que recomendamos ao avaliar a migração de recursos IaaS do clássico para o Gerenciador de Recursos:

  • Leia a lista de configurações ou recursos não suportados. Se você tiver máquinas virtuais que usam configurações ou recursos sem suporte, recomendamos que aguarde até que o suporte a recursos/configurações seja anunciado. Como alternativa, você pode remover esse recurso ou sair dessa configuração para habilitar a migração, se ela atender às suas necessidades.
  • Se você tiver scripts automatizados que implantam sua infraestrutura e aplicativos hoje, tente criar uma configuração de teste semelhante usando esses scripts para migração. Como alternativa, você pode configurar ambientes de exemplo usando o portal do Azure.

Importante

Atualmente, não há suporte para gateways de aplicativos para migração do clássico para o Gerenciador de Recursos. Para migrar uma rede virtual clássica com um gateway de aplicativo, remova o gateway antes de executar uma operação Preparar para mover a rede. Depois de concluir a migração, reconecte o gateway no Gerenciador de Recursos do Azure.

Os gateways de Rota Expressa que se conectam a circuitos de Rota Expressa em outra assinatura não podem ser migrados automaticamente. Nesses casos, remova o gateway da Rota Expressa, migre a rede virtual e recrie o gateway. Consulte Migrar circuitos de Rota Expressa e redes virtuais associadas do modelo de implantação clássico para o Resource Manager para obter mais informações.

Passo 2: Defina a sua subscrição e registe o fornecedor

Para cenários de migração, você precisa configurar seu ambiente para o Gerenciador clássico e o Gerenciador de Recursos. Instale a CLI clássica do Azure e selecione sua assinatura.

Inicie sessão na sua conta.

azure login

Selecione a assinatura do Azure usando o comando a seguir.

azure account set "<azure-subscription-name>"

Nota

O registro é uma etapa única, mas precisa ser feito uma vez antes de tentar a migração. Sem se registrar, você verá a seguinte mensagem de erro:

BadRequest : A assinatura não está registrada para migração.

Registre-se com o provedor de recursos de migração usando o comando a seguir. Observe que, em alguns casos, esse comando expira. No entanto, a inscrição será bem-sucedida.

azure provider register Microsoft.ClassicInfrastructureMigrate

Aguarde cinco minutos para que o registo termine. Você pode verificar o status da aprovação usando o seguinte comando. Certifique-se de que RegistrationState está Registered antes de prosseguir.

azure provider show Microsoft.ClassicInfrastructureMigrate

Agora mude a CLI para o asm modo.

azure config mode asm

Etapa 3: Verifique se você tem vCPUs suficientes da Máquina Virtual do Azure Resource Manager na região do Azure de sua implantação atual ou VNET

Para este passo, terá de mudar para o arm modo. Faça isso com o seguinte comando.

azure config mode arm

Você pode usar o seguinte comando da CLI para verificar o número atual de vCPUs que você tem no Gerenciador de Recursos do Azure. Para saber mais sobre cotas de vCPU, consulte Limites e o Gerenciador de Recursos do Azure.

azure vm list-usage -l "<Your VNET or Deployment's Azure region"

Depois de concluir a verificação desta etapa, você pode voltar ao asm modo.

azure config mode asm

Etapa 4: Opção 1 - Migrar máquinas virtuais em um serviço de nuvem

Obtenha a lista de serviços de nuvem usando o comando a seguir e escolha o serviço de nuvem que você deseja migrar. Observe que, se as VMs no serviço de nuvem estiverem em uma rede virtual ou se tiverem funções Web/de trabalho, você receberá uma mensagem de erro.

azure service list

Execute o seguinte comando para obter o nome da implantação para o serviço de nuvem a partir da saída detalhada. Na maioria dos casos, o nome da implantação é o mesmo que o nome do serviço de nuvem.

azure service show <serviceName> -vv

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

azure service deployment validate-migration <serviceName> <deploymentName> new "" "" ""

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

Se você quiser migrar as VMs para uma rede virtual criada pela plataforma, use o comando a seguir.

azure service deployment prepare-migration <serviceName> <deploymentName> new "" "" ""

Se desejar migrar para uma rede virtual existente no modelo de implantação do Resource Manager, use o comando a seguir.

azure service deployment prepare-migration <serviceName> <deploymentName> existing <destinationVNETResourceGroupName> <subnetName> <vnetName>

Depois que a operação de preparação for bem-sucedida, você poderá examinar a saída detalhada para obter o estado de migração das VMs e garantir que elas estejam no Prepared estado.

azure vm show <vmName> -vv

Verifique a configuração dos recursos preparados usando a CLI ou o portal do Azure. Se você não estiver pronto para a migração e quiser voltar ao estado antigo, use o seguinte comando.

azure service deployment abort-migration <serviceName> <deploymentName>

Se a configuração preparada parecer boa, você pode avançar e confirmar os recursos usando o comando a seguir.

azure service deployment commit-migration <serviceName> <deploymentName>

Etapa 4: Opção 2 - Migrar máquinas virtuais em uma rede virtual

Escolha a rede virtual que deseja migrar. Observe que, se a rede virtual contiver funções Web/de trabalho ou VMs com configurações sem suporte, você receberá uma mensagem de erro de validação.

Obtenha todas as redes virtuais na assinatura usando o comando a seguir.

azure network vnet list

A saída será semelhante à seguinte:

Captura de tela da linha de comando com todo o nome da rede virtual realçado.

No exemplo acima, o virtualNetworkName é o nome completo "Grupo classicubuntu16 classicubuntu16".

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

azure network vnet validate-migration <virtualNetworkName>

Prepare a rede virtual de sua escolha para a migração usando o comando a seguir.

azure network vnet prepare-migration <virtualNetworkName>

Verifique a configuração das máquinas virtuais preparadas usando a CLI ou o portal do Azure. Se você não estiver pronto para a migração e quiser voltar ao estado antigo, use o seguinte comando.

azure network vnet abort-migration <virtualNetworkName>

Se a configuração preparada parecer boa, você pode avançar e confirmar os recursos usando o comando a seguir.

azure network vnet commit-migration <virtualNetworkName>

Etapa 5: Migrar uma conta de armazenamento

Quando terminar de migrar as máquinas virtuais, recomendamos migrar a conta de armazenamento.

Prepare a conta de armazenamento para migração usando o seguinte comando

azure storage account prepare-migration <storageAccountName>

Verifique a configuração da conta de armazenamento preparada usando a CLI ou o portal do Azure. Se você não estiver pronto para a migração e quiser voltar ao estado antigo, use o seguinte comando.

azure storage account abort-migration <storageAccountName>

Se a configuração preparada parecer boa, você pode avançar e confirmar os recursos usando o comando a seguir.

azure storage account commit-migration <storageAccountName>

Próximos passos