Este guia vai te ensinar, passo a passo, como criar uma VM template do Debian com Cloud-Init no Proxmox VE. A ideia é que você tenha uma base pronta para clonar quantas máquinas quiser, com rede configurada via DHCP ou IP fixo.
Proxmox VE instalado e configurado.
Acesso à internet para baixar Cloud Images.
Conhecimento básico de linha de comando Linux.
Cloud Images são imagens pré-configuradas de sistemas operacionais otimizadas para execução em ambientes de nuvem. Elas são leves, já incluem o Cloud-Init e são ideais para implantação rápida de VMs no Proxmox.
O Cloud-Init é um serviço que automatiza a configuração inicial de máquinas virtuais, permitindo definir:
Usuários e senhas.
Chaves SSH.
Configurações de rede (IP estático/DHCP).
Execução de scripts pós-inicialização.
Baixar uma Cloud Image
Acesse o terminal do Proxmox (via SSH ou shell).
Você precisa obter a imagem base do Debian com suporte a Cloud-Init. No seu terminal do Proxmox:
wget https://cloud.debian.org/images/cloud/bookworm/latest/debian-12-genericcloud-amd64.qcow2
Essa imagem é em formato .qcow2, que o Proxmox consegue importar direto.
Instale as ferramentas necessárias
Para editar a imagem e instalar pacotes nela (como o agente do Proxmox), instale o seguinte pacote:
apt update
apt install libguestfs-tools -y
Esse pacote fornece a ferramenta virt-customize.
Crie a nova VM (sem disco ainda)
Agora, você vai criar a estrutura da VM com um ID à sua escolha (ex: 1001):
qm create 1001 --name debian-cloud --memory 2048 --cores 2 --cpu cputype=host --net0 virtio,bridge=vmbr0
1001 → é o ID da VM (pode mudar)
--name → nome descritivo
--net0 → configura a primeira interface de rede na bridge vmbr0 com driver virtio (melhor desempenho)
Importe o disco .qcow2 para o storage
Agora, você vai importar o disco para o storage local-lvm:
qm importdisk 1001 debian-12-genericcloud-amd64.qcow2 local-lvm --format qcow2
Anexe o disco importado à VM
qm set 1001 --scsihw virtio-scsi-pci --scsi0 local:1001/vm-1001-disk-0.qcow2
--scsihw define o controlador
--scsi0 é onde o disco principal ficará montado
Adicione o disco de Cloud-Init
Esse disco será usado para aplicar as configurações de rede, usuário e SSH no primeiro boot:
qm set 1001 --ide2 local-lvm:cloudinitConfigure o boot, console serial e guest agent
Essas opções garantem que a VM inicie corretamente e que você possa ver a saída da console no terminal web:
qm set 1001 --boot order=scsi0
qm set 1001 --serial0 socket --vga serial0
qm set 1001 --agent enabled=1--serial0 e --vga serial0 permitem acesso à console via web (útil para imagens que não têm interface gráfica)
Configure a rede via DHCP (automático)
Se você quiser que a VM pegue IP automaticamente (DHCP), execute:
qm set 1001 --ipconfig0 ip=dhcpAlternativa: Configurar IP fixo
Se quiser definir manualmente um IP, gateway e máscara, use:
qm set 1001 --ipconfig0 ip=192.168.1.100/24,gw=192.168.1.1Converta a VM em template
Com tudo configurado, execute:
qm template 1001Agora sua VM virou um template e pode ser clonada rapidamente com rede e usuário já configurados.
Usando o template Debian com Cloud-Init
Crie uma nova VM a partir do template:
qm clone 1001 9100 --name debian-vm-test --fullConfigure usuário, senha:
qm set 9100 --ciuser=debian --cipassword=SenhaForte123Inicie a VM:
qm start 9100
🚀 Gostou do conteúdo?
Você agora tem um template Debian com suporte a Cloud-Init no Proxmox, pronto para criar VMs de forma rápida, padronizada e automatizada. Isso é perfeito para homelabs, ambientes empresariais e DevOps.
Deixe sua opinião nos comentários! Se tiver dúvidas ou sugestões, ficarei feliz em ajudar. E, claro, compartilhe com seus amigos se achar que pode ser útil para eles.
Obrigado por acompanhar este guia! 🚀
Até a próxima!