Como instalar o VirtIO Guest Agent no Ubuntu

Como instalar o VirtIO Guest Agent no Ubuntu

🎯 Por que você precisa do VirtIO Guest Agent?

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

ComandoO 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-agent sempre atualizado.
  • Logs: Verifique /var/log/syslog ou journalctl -u qemu-guest-agent para diagnóstico.