Como configurar o módulo Virtualizor no MVO Panel

Visão geral

O módulo Virtualizor conecta o MVO Panel ao servidor mestre Virtualizor para criar e administrar VPS automaticamente. Depois da configuração, o MVO Panel pode provisionar, suspender, reativar, excluir e redimensionar máquinas, além de disponibilizar energia, console VNC, reinstalação, rede, rDNS, chaves SSH, snapshots, backups, firewall, modo rescue, autenticação em dois fatores, métricas, tarefas e logs na área do serviço.

Este tutorial é específico para o módulo nativo do MVO Panel. Não instale os arquivos do módulo WHMCS dentro do MVO Panel.

Antes de começar, faça a primeira integração em um servidor ou cluster de homologação. Não ative o provisionamento automático de vendas antes de criar e excluir uma VPS de teste com sucesso.

O que você precisa ter pronto

• Um servidor mestre Virtualizor instalado, licenciado e acessível pelo servidor do MVO Panel.
• Uma versão atual do Virtualizor. A documentação do fornecedor informa que a geração 2 do módulo de billing requer Virtualizor 2.8.0 ou superior; para o MVO Panel, mantenha a versão estável mais recente compatível com seu hypervisor.
• Ao menos um plano, template de sistema operacional e pool de IP configurados no Virtualizor.
• Hostname com DNS válido e certificado TLS confiável para o painel Virtualizor.
• Portas TCP 4083 e 4085 liberadas entre o servidor do MVO Panel e o Virtualizor.
• Uma credencial de API administrativa exclusiva para a integração.
• Permissão no MVO Panel para administrar módulos, servidores e produtos.

Consulte também a documentação oficial do módulo de billing do Virtualizor para conceitos do lado do Virtualizor. Os nomes das telas do MVO Panel são diferentes dos nomes do WHMCS.

1. Preparar o Virtualizor

Criar ou revisar o plano

No painel administrativo do Virtualizor, abra a área de planos e crie o plano que servirá de base para o produto. Anote o ID numérico do plano. Confira principalmente:

• tipo de virtualização;
• espaço em disco;
• memória RAM e swap;
• quantidade de núcleos;
• franquia de tráfego;
• velocidade de rede;
• quantidade de IPv4, IPv6 e sub-redes IPv6;
• limites de snapshots e backups;
• recursos liberados para o usuário final.

O ID do plano será informado no campo ID do plano Virtualizor do produto no MVO Panel. Não confunda o nome visível do plano com seu ID.

Preparar templates e IPs

Confirme que o template de sistema operacional está baixado e disponível no nó que receberá a VPS. Anote o nome ou identificador aceito pelo Virtualizor.

Revise também os pools de IP. O provisionamento falhará se o plano solicitar um IPv4, IPv6 ou IP interno e não houver endereço livre compatível. Se desejar escolher um pool específico, anote o ID do pool.

Criar as credenciais da API

No Virtualizor, abra a administração de credenciais de API e crie uma credencial dedicada ao MVO Panel. Use um nome identificável, por exemplo mvo-panel-producao.

Guarde os dois valores gerados:

• API Key/chave administrativa, que será usada no campo Usuário do servidor no MVO Panel;
• API Password/segredo, que será usada no campo Senha.

Não envie essas credenciais por ticket, mensagem ou e-mail. Não reutilize a senha do usuário root quando uma credencial de API dedicada estiver disponível. Se houver restrição por IP, autorize o IP público de saída do servidor onde o MVO Panel está hospedado.

Rede e certificado

O módulo usa a API administrativa na porta 4085 e a API/painel end-user na porta 4083. Libere as conexões de saída no servidor MVO Panel e as conexões de entrada correspondentes no firewall do Virtualizor.

Use um hostname, por exemplo virtualizor.exemplo.com.br, apontando para o mestre Virtualizor. Instale um certificado válido e mantenha Validar certificado SSL ativado no MVO Panel. Desative essa validação somente durante uma investigação controlada; certificado inválido em produção deve ser corrigido no servidor.

2. Ativar o módulo no MVO Panel

1. Entre na administração do MVO Panel.
2. Abra Complementos ou Configurações, Integrações, Módulos.
3. Localize Virtualizor na lista de módulos de servidor.
4. Ative o módulo.
5. Confirme que ele aparece como módulo disponível ao cadastrar um servidor.

Desativar o módulo não apaga as VPS nem seus vínculos. Entretanto, serviços associados deixam de executar automações até que o módulo seja reativado ou substituído de forma planejada.

3. Cadastrar o servidor Virtualizor

1. Acesse Configurações, Integrações, Servidores.
2. Clique em Novo servidor.
3. Preencha um nome interno fácil de reconhecer, como Virtualizor Brasil - Mestre.
4. Selecione o módulo Virtualizor.
5. Informe o hostname sem caminho de página. Exemplo: virtualizor.exemplo.com.br.
6. Informe a API Key no campo Usuário.
7. Informe a API Password no campo Senha.
8. Use SSL e a porta correspondente ao cadastro do servidor. As chamadas específicas do módulo usam os painéis 4083 e 4085.
9. Mantenha o servidor com status ativo e salve.
10. Execute Testar conexão.

Quando o teste é aprovado, o MVO Panel conseguiu autenticar na API administrativa e consultar o inventário de planos/nós. Isso comprova a comunicação básica, mas ainda não comprova criação de VPS, disponibilidade de IP, template ou console.

Se o teste de conexão falhar

• Confirme hostname, chave e segredo sem espaços extras.
• Teste a resolução DNS a partir do servidor do MVO Panel.
• Confirme que as portas 4083 e 4085 estão acessíveis.
• Revise a lista de IPs permitidos na credencial da API.
• Confira validade e cadeia do certificado TLS.
• Consulte os logs do MVO Panel e os logs de API do Virtualizor.
• Não desative permanentemente TLS, autenticação ou firewall para fazer o teste passar.

4. Criar ou editar o produto de VPS

Abra Produtos, selecione ou crie o produto que será provisionado e configure o módulo de servidor como Virtualizor. Associe o produto ao servidor ou grupo cadastrado no passo anterior.

Configuração principal

• Virtualização: escolha a tecnologia realmente instalada no nó. O módulo aceita KVM, OpenVZ, Xen, XCP, LXC, Virtuozzo KVM/OpenVZ e os modos Proxmox expostos pelo Virtualizor.
• ID do plano Virtualizor: informe somente o ID numérico do plano preparado no Virtualizor.
• Template/SO padrão: informe o nome ou identificador exato do template disponível.
• Nó ou auto: use auto para seleção automática ou informe o nó desejado.
• Grupo de servidores: use quando o Virtualizor deve escolher dentro de um grupo configurado.

Não configure simultaneamente um nó fixo e uma estratégia de grupo incompatível. Para clusters, prefira seleção automática ou grupo, a menos que exista uma necessidade operacional clara de fixar o nó.

Recursos do produto

• Disco (GB): espaço principal da VPS.
• RAM (MB): memória garantida em megabytes.
• Swap (MB): swap aplicável ao tipo de virtualização.
• vCPU: quantidade de núcleos virtuais.
• Tráfego (GB): franquia mensal; confira como seu plano representa uso ilimitado.
• Rede (KB/s): limite de velocidade; confira a unidade antes de publicar o produto.

Quando um campo de recurso é definido no produto, ele pode complementar ou sobrescrever o plano no pedido enviado ao Virtualizor. Mantenha plano, opções configuráveis e descrição comercial sincronizados para não vender uma quantidade diferente da provisionada.

Endereçamento

• Quantidade IPv4: normalmente 1 para uma VPS pública.
• Quantidade IPv6: total de endereços IPv6 individuais.
• Sub-redes IPv6: quantidade de sub-redes a delegar.
• IPs internos: endereços privados necessários.
• ID do pool IP: preencha somente quando precisar restringir a alocação a um pool específico.

Antes de ativar vendas, confirme que o pool possui capacidade livre e está associado aos nós/grupos usados pelo produto.

Recursos adicionais

• Painel de controle: identificador do painel que o Virtualizor deve preparar, quando aplicável.
• Recipe ID: receita executada no provisionamento, se configurada no Virtualizor.
• VNC: habilita o recurso de console quando suportado pelo hypervisor e pelo plano.
• Limite de snapshots: quantidade permitida para o serviço.
• Limite de backups: quantidade permitida para o serviço.
• Validar certificado SSL: deve permanecer ativado em produção.

5. Configurar opções vendidas ao cliente

Se o produto oferece escolhas de RAM, CPU, disco, tráfego ou sistema operacional, crie opções configuráveis no MVO Panel e mantenha os valores compatíveis com o Virtualizor. Use nomes objetivos e unidades explícitas, por exemplo RAM (MB) ou Disco (GB).

Valide cada combinação comercial. Uma opção exibida na loja não garante que o nó, plano ou template aceite o valor. Evite vender downgrade de disco e combinações que o hypervisor não suporta.

6. Fazer o provisionamento de homologação

1. Crie um cliente de teste interno.
2. Gere um pedido de homologação com o produto Virtualizor.
3. Antes de aceitar o pedido, revise servidor, produto, hostname, sistema operacional e opções.
4. Execute a criação do serviço manualmente na primeira vez.
5. Confirme no Virtualizor que a VPS foi criada no nó correto e recebeu VPSID, UUID e IP.
6. Confirme no MVO Panel que o serviço armazenou o identificador remoto, hostname e endereços.
7. Abra a área do serviço no cliente e valide status, métricas e ações permitidas.
8. Teste iniciar, reiniciar e desligar.
9. Teste console VNC, troca de senha e reinstalação somente na VPS de homologação.
10. Teste suspensão e reativação pelo MVO Panel.
11. Teste alteração de pacote aumentando CPU ou memória.
12. Exclua a VPS pelo MVO Panel e confirme a remoção no Virtualizor.

Somente depois desse ciclo completo habilite criação automática ao aceitar ou pagar pedidos reais.

7. Área do cliente e operações administrativas

Na página do serviço, o cliente pode visualizar a situação e os recursos da VPS. Conforme o hypervisor, plano e permissões do Virtualizor, o módulo disponibiliza:

• iniciar, parar, reiniciar e desligar;
• alterar hostname e senha root;
• reinstalar o sistema operacional;
• abrir console VNC e painel Virtualizor;
• consultar ou administrar IPs e reverse DNS;
• adicionar e remover chaves SSH;
• criar, restaurar e excluir snapshots;
• criar, restaurar e excluir backups;
• configurar firewall e suas regras;
• ativar e desativar modo rescue;
• ativar e desativar autenticação em dois fatores;
• consultar métricas, tarefas e logs.

Administradores também podem sincronizar os dados, suspender ou reativar a rede e executar comandos de ciclo de vida. Funções indisponíveis na edição do Virtualizor, no hypervisor ou no plano não devem ser prometidas comercialmente.

8. Automação e segurança operacional

• Use uma credencial exclusiva e rotacione-a quando houver troca de equipe ou suspeita de exposição.
• Restrinja a credencial ao IP do MVO Panel quando possível.
• Não altere manualmente no Virtualizor os recursos de uma VPS criada pelo MVO Panel sem depois sincronizar e revisar o serviço. Mudanças paralelas podem causar divergência no próximo upgrade de pacote.
• Trate reinstalação, restauração, poweroff e exclusão como ações destrutivas.
• Faça backup antes de reinstalar ou excluir.
• Acompanhe consumo de IP, storage, RAM e capacidade dos nós.
• Revise periodicamente tarefas com falha e logs de API.

9. Solução de problemas

Erro de autenticação ou resposta vazia

Revise a API Key e a API Password, a restrição por IP, o hostname e as portas. Gere uma nova credencial dedicada se não for possível confirmar a integridade da atual.

O plano ou nó não aparece

Confirme que o plano pertence ao mestre consultado, que o nó está online e que a credencial possui acesso ao inventário. Use o ID real do plano, não apenas seu nome.

A VPS não recebe IP

Confira se há endereços livres, se o pool pertence ao nó/grupo correto e se a quantidade/tipo solicitados pelo produto são compatíveis. Revise IPv4, IPv6, sub-redes e IPs internos separadamente.

Template ou reinstalação falha

Confira o identificador do template, sua disponibilidade no nó e sua compatibilidade com o tipo de virtualização. Templates ainda em download ou não sincronizados não podem ser usados.

Console VNC não abre

Confirme VNC ativo no produto, suporte do hypervisor, acesso do navegador ao hostname/porta do Virtualizor e certificado válido. Bloqueadores de pop-up e regras de proxy também podem impedir a abertura.

O produto cria recursos diferentes do anunciado

Compare o plano Virtualizor, os campos do módulo, as opções configuráveis e a descrição comercial. O valor efetivamente enviado pelo produto pode sobrescrever o plano. Corrija a origem da divergência antes de novos pedidos.

Suspensão ou alteração de pacote não funciona

Confirme VPSID/UUID no serviço, estado atual da VPS e suporte do hypervisor à mudança. Disco normalmente não aceita redução. Consulte a tarefa correspondente no Virtualizor e o log da automação no MVO Panel.

Checklist antes de liberar vendas

• Credencial exclusiva criada e protegida.
• DNS e certificado TLS válidos.
• Portas 4083 e 4085 acessíveis.
• Teste de conexão aprovado.
• Plano, template, pool e nó/grupo conferidos.
• Produto e opções configuráveis revisados.
• VPS de homologação criada com recursos e IP corretos.
• Área do cliente e console testados.
• Suspensão, reativação e upgrade testados.
• VPS de homologação excluída pelo MVO Panel.
• Logs revisados sem erros novos.

Depois de concluir o checklist, documente internamente qual plano Virtualizor corresponde a cada produto MVO e quem é responsável pela capacidade dos nós e pools.