Módulos
Onde no admin: System › Admin › License & updates (
/license), no card Module.
O que faz
Um módulo é um serviço ou recurso que você pode ativar ou desativar por completo. Um módulo que está desativado fica oculto no menu administrativo e os clientes não podem comprá-lo; suas rotas de API respondem com 404 module_disabled quando o módulo for um complemento. Ativar um módulo apenas expõe o recurso: a infraestrutura por trás dele ainda precisa estar conectada (consulte a última coluna).
Requisitos
| Item | Requisito |
|---|---|
| Conta | Um administrador com acesso de gravação. A equipe somente leitura pode ver as chaves, mas não alterá-las. |
| Infraestrutura | Consulte a tabela: cada módulo lista o que precisa. |
| Depende de | Alguns módulos precisam de outros (o DDoS Shield precisa de DDoS & BGP). |
Preparar a infraestrutura
Não é obrigatório para a chave em si. Conecte a infraestrutura de cada módulo conforme descrito na página vinculada na tabela.
Conectar no NexCMP
- Abra System › Admin › License & updates e role até o card Module. Ele informa que os módulos desativados ficam ocultos no menu administrativo e não podem ser adquiridos pelos clientes.
- Use a chave de um módulo. A página confirma Saved: reloading menu e é recarregada, fazendo com que o menu mude imediatamente.
Os módulos
| Módulo (conforme exibido) | Padrão | O que adiciona | Necessita | Página |
|---|---|---|---|---|
| Virtual Machines | sempre ativado | Catálogo de VMs, pedidos, console, snapshots | CloudStack ou Proxmox VE | CloudStack, Proxmox VE |
| Bandwidth | ativado | Cotas, complementos, alertas e ações de excedente para VMs, Kubernetes e S3 | Nada extra (estatísticas de VM do CloudStack) | Bandwidth |
| OS & ISO Images | desativado | Os clientes registram suas próprias imagens de SO e ISOs, cobradas por GB | CloudStack; acesso à Internet para sua VM de armazenamento secundário | Requisitos |
| Kubernetes | desativado | Clusters Kubernetes (CKS) | CloudStack com CKS habilitado | Kubernetes e Private Cloud |
| Private Cloud | desativado | VPC com planos de largura de banda dedicada | VPC do CloudStack e ofertas de rede | Kubernetes e Private Cloud |
| Object Storage | desativado | Contas S3 em Ceph RGW, pague pelo uso | Ceph RGW e uma zona com o serviço S3 | S3 |
| VPN | desativado | VPN em seus próprios nós | Nós executando o cmp-agent | Nós de VPN e proxy |
| IPv6 Proxy | desativado | Proxy IPv6 em seus próprios nós | Nós de proxy com um prefixo IPv6 | Nós de VPN e proxy |
| Bare Metal | desativado | Servidores Dell via iDRAC: pedidos, instalação de SO, console, energia | iDRAC 9 em uma rede de gerenciamento | Dedicated servers |
| AI Models | desativado | Um gateway que vende acesso a modelos de IA: uma única chave para vários modelos, preços por modelo, limites de uso, logs e faturamento via carteira | Fontes de modelos fornecidas por você: uma API compatível com OpenAI ou Anthropic com sua própria chave | AI Models |
| AI | desativado | AI Chat (suporte automatizado) e AI Agent (administração de VM em linguagem natural) | Um provedor compatível com OpenAI | AI providers |
| DDoS Shield | desativado | Proteção de IP para clientes; precisa de DDoS & BGP, portanto o botão permanece desativado sem eles | O add-on DDoS & BGP | abaixo |
| DDoS & BGP | desligado, add-on | Console do roteador de borda: BGP, RTBH, XDP, sessões e tráfego de borda | Um host de borda com daemons root | abaixo |
O que cada botão faz
- O Bare Metal tem duas camadas. O botão do módulo exibe o menu de administração e a API. A venda para clientes é um botão separado com uma confirmação digitada em Services › Dedicated Server, e toda gravação no iDRAC é bloqueada até que você ative o live ops em Infrastructure › Bare Metal › Safety. Consulte Dedicated servers.
- Para Kubernetes, Private Cloud, VPN, IPv6 Proxy e Images, o botão do módulo e o botão de vendas na página do serviço controlam a mesma configuração.
- O AI também precisa de um provedor configurado em System › Settings › AI provider.
- O AI Models tem duas camadas. O switch do módulo exibe o menu de administração e a API. A venda para clientes é controlada por um switch de venda separado no topo das páginas do AI Models, desativado por padrão. Consulte AI Models.
Módulos lidos na inicialização
Três recursos não são botões comuns. Eles são lidos uma vez quando os serviços iniciam e exigem uma infraestrutura que a instalação padrão não inclui.
| Recurso | Configuração | Estado | O que é necessário |
|---|---|---|---|
| DDoS & BGP | module_ddos | Exibido como Add-on package quando desligado, Installed quando ligado. Não há botão no console. | Daemons do roteador de borda (BGP, RTBH, XDP, estatísticas de fluxo) executados como root. O painel é executado como um usuário sem privilégios e não pode executá-los. |
| IA | module_ai | Um botão normal. As rotas entram em vigor imediatamente; as tarefas em segundo plano do AI Chat (investigação de tickets, respostas agendadas) começam na próxima reinicialização dos serviços. O console indica que a reinicialização é recomendada. | O provedor de AI. |
| Terminal SSH web | feature_ssh_web | Desligado por padrão, sem botão no console | Um serviço de proxy SSH separado e sua rota. Sem ele, a aba Console do portal exibe apenas VNC. O AI Agent não precisa dele: ele executa comandos por meio de uma conexão SSH que o próprio painel estabelece. |
Após uma alteração em uma configuração de inicialização, reinicie os serviços: sudo systemctl restart nexcmp nexcmp-vmd.
Verificar
- O item de menu do módulo aparece (ou desaparece) após a recarga.
- Para um módulo voltado ao cliente, o portal exibe o novo item de menu para um cliente conectado. Um módulo desativado não exibe nada ou "coming soon".
Limites e observações
- Desativar um módulo não exclui nada. VMs, clusters, contas S3 e assinaturas em execução continuam funcionando e sendo cobrados; os clientes apenas não conseguem criar novos.
- As páginas de cotas listam apenas os serviços cujos módulos estão ativados.
Resolução de problemas
| Sintoma | Causa | Correção |
|---|---|---|
| A entrada do menu não apareceu | A página não foi recarregada | Recarregue o console administrativo. |
| O interruptor do DDoS Shield está desativado | O DDoS & BGP não está instalado | O DDoS Shield precisa do add-on DDoS & BGP. |
| "This module is an add-on package and cannot be switched here" (HTTP 409 ou 422) | Você (ou um script) tentou alternar o DDoS & BGP | É um pacote add-on; não há opção de alternar. |
| "O DDoS Shield precisa do add-on DDoS & BGP" | O mesmo para o DDoS Shield | Instale o add-on primeiro. |
Uma rota de módulo responde com 404 module_disabled | O módulo está desativado | Ative o módulo. |
| O AI Chat responde, mas a investigação do ticket nunca começa | O módulo de IA foi ativado sem uma reinicialização | sudo systemctl restart nexcmp nexcmp-vmd. |
| Equipe com acesso somente leitura não pode salvar | A função deles é somente leitura | Use uma conta de administrador. |