🎯 Por que você precisa do VirtIO Guest Agent?
O VirtIO Guest Agent é um programa leve que roda dentro da sua VM (guest) e cria uma ponte de comunicação bidirecional entre o guest e o host (KVM/libvirt).
Benefícios chave
- ✅ Integração profunda: permite que o host controle a VM (ligar, desligar, suspender).
- ⚙️ Sincronização de tempo: mantém o relógio interno da VM alinhado com o host.
- 🌐 Hot‑plug de dispositivos: adiciona/remova dispositivos virtuais sem reboot.
- 🛡️ Segurança reforçada: evita a necessidade de portas de rede extras para gerenciamento.
- 📈 Automação avançada: scripts de provisionamento e snapshots funcionam melhor.
- 🔌 Melhor experiência com cloud‑init: facilita a configuração inicial da VM.
📦 Passo a passo: Instalação no Ubuntu ou Debian
Requisitos:
- Ubuntu 18.04+ (ou qualquer distro baseada em Debian)
- Acesso de super‑usuário (
sudo)
1️⃣ Atualizar a lista de pacotes
sudo apt update
2️⃣ Instalar o pacote do agente
sudo apt install qemu-guest-agent
3️⃣ Habilitar e iniciar o serviço automaticamente
sudo systemctl enable --now qemu-guest-agent
✅ O agente já está rodando!
4️⃣ Verificar o status
sudo systemctl status qemu-guest-agent
Você deve ver algo como igual a imagem:

⚙️ Configurando o libvirt para usar o agente
Se você usa libvirt, basta garantir que a VM tenha o dispositivo de guest agent habilitado. No host edite a VM e inclua:
<guest_agent>1</guest_agent>
Utilize o comando abaixo para editar a configuração da VM:
visrh list virsh edit <nome_da_vm>
Adicione a linha <guest_agent>1</guest_agent> dentro da seção <devices>.
💡 Como usar o agente no dia a dia
| Comando | O que faz |
|---|---|
virsh shutdown <vm> | Desliga a VM via agente |
virsh guest-exec <vm> --command "ls /" | Executa comando no guest |
virsh domstate <vm> | Verifica o estado do guest |
virsh qemu-agent-command <vm> '{"execute":"guest-get-time"}' | Obtém o relógio do guest |
Dica: Use scripts automáticos para desligar VMs após a conclusão de tarefas.
🔐 Segurança e Boas Práticas
- Firewall: O agente não expõe portas externas, mas mantenha a rede segura.
- Atualizações: Mantenha o pacote
qemu-guest-agentsempre atualizado. - Logs: Verifique
/var/log/syslogoujournalctl -u qemu-guest-agentpara diagnóstico.
