Template de VM no Proxmox com o miniCP pronto
Com o template, um servidor novo fica pronto em segundos: você clona a VM, informa IP e senha, liga e o painel já responde na porta 5000. Só falta escolher a stack (Apache, Nginx, PHP, banco) no Setup Inicial.
O template é gerado pelo script tools/proxmox-template.sh, que acompanha o miniCP.
O que vem no template
- Sistema mínimo: Debian 13 na imagem oficial genericcloud, com kernel próprio para VM e sem firmware nem drivers de hardware físico. São cerca de 350 pacotes e menos de 1 GB ocupado no disco.
- miniCP instalado e habilitado: o painel sobe sozinho no primeiro boot.
- Hardware virtual de desempenho:
- disco virtio-scsi-single com iothread, discard e marcação de SSD;
- rede virtio multiqueue;
- memória fixa, sem balloon;
- guest agent;
- gerador de números aleatórios virtio;
- console serial.
- Ajustes do sistema:
- controle de congestionamento BBR com fila fq;
- journal limitado a 256 MB;
- fstrim semanal;
- boot sem espera no GRUB;
- idioma pt_BR.UTF-8 e fuso de São Paulo.
- Boot rápido: o cloud-init só consulta as fontes do Proxmox e não roda atualização de pacotes no primeiro boot, porque a imagem já sai atualizada.
- Pronto para clonar: a imagem não leva dados, chave de sessão do painel, machine-id nem chaves SSH. Cada servidor gera os seus no primeiro boot.
O ajuste fino de rede e memória continua no painel, em Tuning, e prevalece sobre os valores do template.
Criar o template
No host Proxmox, como root:
bash proxmox-template.sh
O padrão cria o template 9000 no storage local-lvm, na bridge vmbr0, com 2 vCPUs, 4 GB de RAM e disco de 20 GB. Para mudar, passe variáveis antes do comando:
VMID=9100 STORAGE=ceph BRIDGE=vmbr1 CORES=4 MEMORY=8192 DISK=40G bash proxmox-template.sh
| Variável | Padrão | Para que serve |
|---|---|---|
VMID |
9000 | Número do template |
NAME |
minicp-template | Nome do template |
STORAGE |
local-lvm | Onde ficam o disco e o drive do cloud-init |
BRIDGE / VLAN |
vmbr0 / sem tag | Rede |
CORES / MEMORY |
2 / 4096 | vCPUs e RAM (MB) padrão dos clones |
DISK |
20G | Tamanho do disco; a partição cresce sozinha no boot |
CPU |
host | Tipo de CPU (veja abaixo) |
TZ |
America/Sao_Paulo | Fuso horário |
O script baixa a imagem oficial do Debian, confere o SHA512 e baixa o miniCP pelo mesmo endereço usado em Configurações → Atualização. O IP do host Proxmox precisa estar liberado nesse repositório. Na primeira vez a montagem leva alguns minutos. A imagem do Debian fica em cache para as próximas.
Cluster com processadores diferentes: o padrão
CPU=hosté o mais rápido, mas impede a migração ao vivo entre hosts com CPUs diferentes. Nesse caso crie o template comCPU=x86-64-v3.
Subir um servidor novo
qm clone 9000 201 --name cliente1 --full
qm set 201 --cipassword 'SENHA_DO_ROOT' --sshkeys ~/.ssh/id_ed25519.pub \
--ipconfig0 ip=203.0.113.50/24,gw=203.0.113.1 --nameserver 1.1.1.1
qm start 201
Também dá para fazer pela interface do Proxmox: Clone (modo Full Clone), depois a aba Cloud-Init para usuário, senha, chave SSH e IP.
Depois de ligar:
- Acesse
http://IP-DO-SERVIDOR:5000. - Entre com root e a senha definida no cloud-init.
- Vá em Configurações → Setup Inicial e escolha a stack.
Ao entrar por SSH, a mensagem de boas-vindas mostra a versão do miniCP, o endereço do painel e se o Setup Inicial ainda está pendente.
Mais CPU ou memória
qm set 201 --cores 4 --memory 8192
Ao aumentar as vCPUs, ajuste também as filas da placa de rede para o mesmo número. Por exemplo, para 4 vCPUs: qm set 201 --net0 virtio,bridge=vmbr0,queues=4. Mantenha o mesmo bridge e a tag de VLAN, se houver.
Atualizar o template
O miniCP de cada servidor se atualiza pelo painel normalmente. Para que os clones novos já nasçam com a versão mais recente, apague o template antigo e rode o script de novo.