Todos os produtos
Search
Central de documentação

Elastic Compute Service:Instale o Vminit

Última atualização: Jul 03, 2026

O Vminit é uma ferramenta de inicialização para instâncias ECS que executam o sistema operacional Windows. Ele gerencia a configuração de rede, as definições de nome de host e a execução de scripts personalizados. Caso uma imagem personalizada não possua o Vminit, instale-o manualmente para garantir que a instância seja inicializada com sucesso. Este tópico descreve como instalar o Vminit na máquina virtual usada para criar uma imagem.

Limitações

O Vminit oferece suporte às versões de 32 bits e 64 bits do Windows 7, Windows Server 2008 R2 e sistemas operacionais posteriores.

Instale o Vminit

Nota

Este tópico usa a versão 2.0.1.2 do Vminit como exemplo. Para obter informações sobre outras versões, consulte Notas de versão.

  1. Na máquina virtual usada para criar a imagem, baixe e descompacte o pacote de instalação do Vminit.

    URL de download: AliyunVminit.zip.

  2. Instale o Vminit.

    GUI

    1. No diretório de download, localize e clique duas vezes em AliyunVminit_2.0.1.2_x86_64.exe.

    2. Siga as instruções na tela.

      Na página License Agreement, selecione I accept the agreement (A) e clique em Next (N) para continuar a instalação.

    3. Quando a tela de conclusão aparecer, a instalação estará finalizada.

    CLI

    1. No Windows PowerShell, acesse o diretório onde você baixou o pacote, por exemplo, C:\test.

      cd C:\test
    2. Execute o comando a seguir para instalar o Vminit.

      .\AliyunVminit_2.0.1.2_x86_64.exe /SILENT /FORCE
      Nota
      • /SILENT: Ativa a instalação silenciosa.

      • /FORCE: Força a substituição de uma instalação existente.

  3. Verifique a instalação do Vminit.

    1. No Windows PowerShell, execute o comando a seguir para verificar o número da versão do Vminit.

      (Get-Item C:\ProgramData\aliyun\vminit\vminit.exe).VersionInfo.ProductVersion

      Se um número de versão semelhante ao seguinte for retornado, a instalação foi bem-sucedida.

      PS C:\...> (Get-Item C:\ProgramData\aliyun\vminit\vminit.exe).VersionInfo.ProductVersion
      0.1.2
    2. Execute o comando a seguir para obter as informações de configuração do registro relacionadas ao Vminit.

      Get-ItemProperty  -Path "HKLM:\SYSTEM\CurrentControlSet\Services\vminit"

      Caso sejam retornadas informações semelhantes às abaixo, a instalação ocorreu com êxito.

      PS C:\test> Get-ItemProperty  -Path "HKLM:\SYSTEM\CurrentControlSet\Services\vminit"
      ErrorControl  : 1
      start         : 2
      type          : 16
      DisplayName   : Aliyun Vminit Service
      ImagePath     : C:\ProgramData\aliyun\vminit\vminit.exe service
      ObjectName    : LocalSystem
      Description   : Aliyun Windows System Initialization Agent
      PSPath        : Microsoft.PowerShell.Core\Registry::HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\vminit
      PSParentPath  : Microsoft.PowerShell.Core\Registry::HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services
      PSChildName   : vminit
      PSDrive       : HKLM
      PSProvider    : Microsoft.PowerShell.Core\Registry

    Após confirmar a instalação, a imagem estará pronta para ser importada para a Alibaba Cloud.

(Opcional) Configure o Vminit

Durante a criação da instância, o Vminit executa todos os plug-ins por padrão. Se você criar uma instância a partir de uma imagem personalizada e quiser impedir que certas operações sejam executadas automaticamente durante a inicialização, desative os plug-ins correspondentes ao criar a imagem.

  1. Crie um arquivo de configuração.

    Crie um arquivo no diretório C:\ProgramData\aliyun\vminit. O arquivo deve atender aos seguintes requisitos:

    • O nome do arquivo deve ser customized_config.

    • O arquivo não deve ter extensão.

    • O conteúdo do arquivo deve estar no formato JSON.

    Nota

    O diretório ProgramData geralmente fica oculto. Certifique-se de que a opção Show hidden files, folders, and drives esteja ativada para visualizar e gerenciar itens ocultos.

  2. Desative plug-ins específicos.

    O exemplo a seguir mostra como desativar os plug-ins de configuração automática de nome de host da instância e de inicialização de disco de dados.

    • Desative a configuração automática de nome de host e a inicialização de disco de dados.

      Para evitar que a Alibaba Cloud configure automaticamente o nome de host da instância e inicialize o disco de dados, desative os plug-ins Plugin_Main_ConfigHostname e Plugin_Main_ConfigDisk. Copie o conteúdo JSON a seguir para o arquivo customized_config e salve o arquivo.

      {
       "disabledPlugins": ["Plugin_Main_ConfigHostname", "Plugin_Main_ConfigDisk"]
      }
Nota

Caso precise reativar um plug-in posteriormente, remova a entrada correspondente do arquivo customized_config.

Perguntas frequentes

Por que uma instância Windows reinicia uma vez durante a criação?

  • Causa: Ao criar uma instância Windows, a Alibaba Cloud atribui um nome de host padrão mesmo que você não especifique um. O Windows exige uma reinicialização do sistema para que a alteração do nome de host tenha efeito. Por isso, o sistema reinicia durante a fase de criação.

  • Solução: Se preferir definir o nome de host da instância por conta própria, resolva esse problema desativando o plug-in Plugin_Main_ConfigHostname. A desativação do plug-in impede que o sistema atribua automaticamente um nome de host à instância.

Documentação relacionada

  • Para obter mais informações sobre o Vminit, consulte Introdução ao Vminit.

  • Por padrão, todos os plug-ins são ativados quando você instala o Vminit. Caso não queira que determinadas operações sejam executadas automaticamente na inicialização da instância, desative os plug-ins correspondentes ao criar a imagem. Para mais detalhes, consulte Configure o Vminit.

  • Após instalar o Vminit na máquina virtual usada para criar uma imagem Windows, talvez seja necessário instalar o driver virtio. Isso garante que as instâncias ECS criadas a partir da imagem identifiquem corretamente os dispositivos virtuais virtio e iniciem adequadamente.

  • Em instâncias ECS que usam imagens Linux, a inicialização é realizada pelo cloud-init. Para mais informações, consulte Instale o cloud-init.