Mover uma VM do Azure para o Azure Stack Hub

Artigo
03/18/2025

Você pode carregar um VHD (disco rígido virtual) de uma VM (máquina virtual) criada no Azure para sua instância do Azure Stack Hub.

Prepare e baixe o VHD do Azure

Localize a seção específica às suas necessidades ao preparar o VHD.

Siga as etapas no artigo Criar uma VM do Windows a partir de um disco especializado usando do PowerShell para preparar o VHD.
Para implantar extensões de VM, certifique-se de que o agente de VM .msi esteja disponível.
Para obter informações e etapas, consulte visão geral do Agente de Máquina Virtual do Azure. Verifique se a extensão está instalada na VM antes de mover a VM. Se o agente de VM não estiver presente no VHD, a implantação da extensão falhará. Você não precisa definir o perfil do sistema operacional durante o provisionamento ou definir $vm.OSProfile.AllowExtensionOperations = $true.

Siga as instruções em Baixar um VHD do Windows do Azure para generalizar e baixar corretamente o VHD antes de movê-lo para o Azure Stack Hub.
Ao provisionar a VM no Azure, use o PowerShell. Prepare-o sem o sinalizador -ProvisionVMAgent.
Remova todas as extensões da VM usando o cmdlet antes de generalizar a VM no Azure. Você pode encontrar quais extensões de VM estão instaladas acessando Windows (C:) > WindowsAzure > Logs > Plugins.

Use o módulo do Az PowerShell:

Remove-AzVMExtension -ResourceGroupName winvmrg1 -VMName windowsvm -Name "CustomScriptExtension"

Use o módulo do PowerShell do AzureRM:

Remove-AzureRmVMExtension -ResourceGroupName winvmrg1 -VMName windowsvm -Name "CustomScriptExtension"

Siga as instruções em Baixar um VHD do Windows do Azure para generalizar e baixar corretamente o VHD antes de movê-lo para o Azure Stack Hub.

Antes de baixar sua VM do Linux, siga as diretrizes na seção "Preparar VM" do artigo Criar uma VM Linux de um disco personalizado com a CLI do Azure
Siga as etapas no artigo Baixar um VHD do Linux da Azure para preparar e baixar o VHD.
Para um VHD especializado, certifique-se de usar a semântica de "anexação" com -CreateOption Attach. Você pode encontrar um exemplo no artigo Criar uma máquina virtual usando um disco do sistema operacional gerenciado existente com o PowerShell (Windows).

Pare o serviço waagent:
```
sudo waagent -force -deprovision
export HISTSIZE=0
logout
```
As versões do Agente Linux do Azure que funcionam com o Azure Stack Hub estão documentadas aqui. Verifique se a imagem na qual você executou o sysprep tem uma versão do agente Linux do Azure compatível com o Azure Stack Hub.
Pare/desaloque a VM.
Baixe o VHD.
1. Para baixar o arquivo VHD, gere uma URL de SAS (assinatura de acesso compartilhado). Quando a URL é gerada, um tempo de expiração é atribuído à URL.
2. No menu da folha da VM, selecione Discos.
3. Selecione o disco do sistema operacional da VM e clique em Exportar disco.
4. Defina o tempo de expiração da URL como 36000.
5. Selecione Gerar URL.
6. Gere a URL.
7. Na URL gerada, selecione Baixar o arquivo VHD.
8. Talvez seja necessário selecionar Salvar no navegador para iniciar o download. O nome padrão do arquivo VHD é abcd.
9. Agora você pode mover esse VHD para o Azure Stack Hub.

Importante

Você pode encontrar um script no artigo script de exemplo para carregar um VHD no Azure e criar uma nova VM para carregar o VHD em uma conta de armazenamento de usuário do Azure Stack Hub e criar uma VM. Certifique-se de fornecer $urlOfUploadedImageVhd como a URL da conta de armazenamento do Azure Stack Hub e do contêiner. Para um VHD generalizado, use o valor FromImage para definir -CreateOption FromImage.

Verifique o seu VHD

Antes de carregar o VHD, você deve validar que o VHD atende aos requisitos. VHDs que não atendem aos requisitos falharão ao carregar no Azure Stack Hub.

Você usará os módulos do PowerShell encontrados com o Hyper-V. A ativação de Hyper-V instala módulos de suporte do PowerShell. Você pode verificar se tem o módulo abrindo o PowerShell com um prompt elevado e executando o seguinte cmdlet:
```
Get-Command -Module hyper-v
```
Se você não tiver os comandos Hyper-V, consulte Trabalhando com Hyper-V e PowerShell do Windows.

Obtenha o caminho para o VHD em seu computador. Execute o seguinte cmdlet:

get-vhd <path-to-your-VHD>

O cmdlet retornará o objeto VHD e exibirá os atributos, como:

ComputerName            : YOURMACHINENAME
Path                    : <path-to-your-VHD>
VhdFormat               : VHD
VhdType                 : Fixed
FileSize                : 68719477248
Size                    : 68719476736
MinimumSize             : 32212254720
LogicalSectorSize       : 512
PhysicalSectorSize      : 512
BlockSize               : 0
ParentPath              :
DiskIdentifier          : 3C084D21-652A-4C0E-B2D1-63A8E8E64C0C
FragmentationPercentage : 0
Alignment               : 1
Attached                : False
DiskNumber              :
IsPMEMCompatible        : False
AddressAbstractionType  : None
Number                  :

Com o objeto VHD, verifique se atende aos requisitos do Azure Stack Hub.
Além disso, o Azure Stack Hub dá suporte apenas a imagens de VMs (1) de primeira geração.
Se o VHD não for compatível com o Azure Stack Hub, você precisará retornar à imagem de origem e ao Hyper-V, criar um VHD que atenda aos requisitos e carregar. Para minimizar possíveis corrupção no processo de carregamento, use o AzCopy.

Como corrigir seu VHD

Os requisitos a seguir devem ser atendidos para compatibilidade do VHD com o Azure Stack Hub.

O VHD é de tipo fixo

Identificar: use o cmdlet get-vhd para obter o objeto VHD.
Corrigir: você pode converter um arquivo VHDX em VHD, converter um disco de expansão dinâmica em um disco de tamanho fixo, mas não pode alterar a geração de uma VM. Use Hyper-V Manager ou do PowerShell para converter o disco.

O VHD tem tamanho virtual mínimo de pelo menos 20 MB

Identificar: use o cmdlet get-vhd para obter o objeto VHD.
Corrigir: use Hyper-V Manager ou do PowerShell para redimensionar o disco.

VHD está alinhado

Identifique: use o comando cmdlet get-vhd para obter o objeto VHD.
Corrigir: o tamanho virtual deve ser um múltiplo de um (1) MB.

Os discos devem ter um tamanho virtual alinhado a 1 MiB. Se o VHD for uma fração de 1 MiB, você precisará redimensionar o disco para um múltiplo de 1 MiB. Discos que são frações de um MiB causam erros ao criar imagens do VHD carregado. Para verificar o tamanho, você pode usar o cmdlet Get-VHD do PowerShell para mostrar "Size", que deve ser um múltiplo de 1 MiB no Azure, e "FileSize", que será igual a "Size" mais 512 bytes para o rodapé VHD.

Use Hyper-V Manager ou do PowerShell para redimensionar o disco.

Comprimento do blob do VHD

Identifique: use o cmdlet get-vhd para mostrar Size
Corrigir: o comprimento do blob VHD = tamanho virtual + comprimento do rodapé vhd (512). Um pequeno rodapé no final do blob descreve as propriedades do VHD. Size deve ser um múltiplo de 1 MiB no Azure e FileSize, que será igual a Size + 512 bytes para o rodapé VHD.

Use Hyper-V Manager ou do PowerShell para redimensionar o disco.

VMs da primeira geração

Identifique: para confirmar se sua máquina virtual é a Geração 1, use o cmdlet Get-VM | Format-Table Name, Generation.
Corrigir: você precisará recriar sua VM no hipervisor (Hyper-V).

Carregar em uma conta de armazenamento

Você pode carregar seu VHD com o portal ou, com o contêiner criado no portal, usar o AzCopy.

Portal para gerar a URL SAS e carregar o VHD

Entre no portal do usuário do Azure Stack Hub.
Selecione Contas de Armazenamento e selecione uma conta de armazenamento existente ou crie uma nova conta de armazenamento.
Selecione Blobs na folha da conta de armazenamento da sua conta de armazenamento. Selecione Contêiner para criar um novo contêiner.
Digite o nome do contêiner e selecione Blob (acesso de leitura anônimo somente para blobs).
Se você usar o AzCopy para carregar sua imagem em vez do portal, crie um token SAS. Selecione Assinatura de acesso compartilhado na conta de armazenamento e selecione Gerar SAS e de cadeia de caracteres de conexão. Copie e anote a URL SAS do serviço Blob. Você usará essa URL ao usar o AzCopy para carregar seu VHD.
Selecione o contêiner e selecione Carregar. Carregue o VHD.

AzCopy VHD

Use o Gerenciador de Armazenamento do Azure ou o AzCopy para reduzir essa chance de que seu VHD seja corrompido no processo de upload e seu upload será mais rápido. As etapas a seguir usam o AzCopy em um computador Windows 10. O AzCopy é um utilitário de linha de comando que você pode usar para copiar blobs ou arquivos de ou para uma conta de armazenamento.

Se você não tiver o AzCopy instalado, instale o AzCopy. Encontre instruções para baixar e começar a usar o AzCopy no artigo Introdução ao AzCopy. Anote onde você armazena o binário. Você pode adicionar o AzCopy ao caminho para usá-lo na linha de comando do PowerShell.
Abra o PowerShell para usar o AzCopy a partir do shell.

Use o AzCopy para carregar seu VHD no contêiner na conta de armazenamento.

$env:AZCOPY_DEFAULT_SERVICE_API_VERSION = "2017-11-09"
azcopy cp "/path/to/file.vhd" "https://[account].blob.core.windows.net/[container]/[path/to/blob]?[SAS] --blob-type=PageBlob

Nota

Carregue o VHD usando uma sintaxe semelhante ao carregamento de um único arquivo para o diretório virtual. Adicione --blob-type=PageBlob para garantir que o VHD seja carregado como um Blob de Página, em vez de Bloquear por padrão.

Para obter mais informações sobre como usar o AzCopy e outras ferramentas de armazenamento, consulte Usar ferramentas de transferência de dados no Armazenamento do Azure Stack Hub.

Criar a VM

As imagens personalizadas vêm de duas formas: especializadas e generalizadas.

Especializadas
Generalizadas

Entre no portal do usuário do Azure Stack Hub.

Se você é um operador de nuvem criando um disco de plataforma, siga as instruções em Adicionar uma imagem de plataforma para adicionar o VHD (Disco Rígido Virtual) através do portal do administrador ou com os pontos de extremidade de administrador.
No portal do usuário, selecione Todos os Serviços>Discos>Adicionar.
Em Criar disco gerenciado:
1. Digite o Nome da sua imagem.
2. Selecione sua Assinatura .
3. Criar ou adicionar a imagem a um grupo de recursos .
4. Selecione o Local, também conhecido como região, de seu ASDK.
5. Selecione o tipo de conta .
  - discos Premium (SSD) são apoiados por unidades de estado sólido e oferecem desempenho consistente e de baixa latência. Eles fornecem o melhor equilíbrio entre preço e desempenho e são ideais para aplicativos com uso intensivo de E/S e cargas de trabalho de produção.
  - Discos Padrão (HD) são apoiados por unidades magnéticas e são preferíveis para aplicativos em que os dados são acessados com pouca frequência. Os discos com redundância de zona são apoiados pelo ZRS (armazenamento com redundância de zona) que replica seus dados em várias zonas e estão disponíveis mesmo se uma única zona estiver inoperante.
6. Selecione Armazenar blob com seu Tipo de fonte. Você está criando um disco a partir de um blob em uma conta de armazenamento.
7. Para a origem do VHD, selecione:
  1. A assinatura de origem onde está localizada a conta de armazenamento.
  2. Selecione Procurar e, em seguida, navegue até sua conta de armazenamento, o contêiner e o VHD. Escolha Selecionar.
  3. Selecione o Tipo de sistema operacional que corresponde ao VHD.
8. Selecione um disco cujo tamanho (GiB) é igual ou maior que o do seu VHD.
9. Selecione Criar.
Depois que o disco for criado, você poderá usar o disco para criar uma nova VM.

Próximas etapas

mover uma VM para a visão geral do Azure Stack Hub

Compartilhar via