Product SiteDocumentation Site

⁠30.6.10. Гостевой агент QEMU

Гостевой агент QEMU (QEMU Guest Agent) — это служба, работающая внутри ВМ и обеспечивающая канал связи между узлом и гостевой системой. Агент позволяет выполнять команды в гостевой системе и передавать служебную информацию узлу кластера. Например, IP-адреса на панели Сводка ВМ отображаются с использованием гостевого агента.
Для корректной работы гостевого агента необходимо:
  • установить агент в гостевой системе и убедиться, что он запущен;
  • включить взаимодействие между агентом и PVE.
Установка гостевого агента в ВМ с ОС «Альт»:
  1. Установите пакет qemu-guest-agent: 
    # apt-get install qemu-guest-agent
  2. Добавьте службу в автозапуск и запустите её:: 
    # systemctl enable --now qemu-guest-agent
Установка гостевого агента в ВМ с ОС «Windows»:
  1. Скачайте и установите драйверы Virtio.
  2. Скачайте и установите программное обеспечение QEMU Guest Agent.
  3. Убедитесь, что служба QEMU Guest Agent присутствует в списке запущенных служб.
Связь PVE с гостевым агентом можно включить:
  • в веб-интерфейсе: на вкладке Параметры соответствующей ВМ:
    PVE. Включить связь с гостевым агентом QEMU
  • в командной строке: 
    # qm set <vmid> --agent 1
Для вступления изменений в силу необходим перезапуск ВМ.
Если включена опция Выполнять команду «trim»…, PVE отправляет команду trim в гостевую систему после операций, которые могут записывать нули в хранилище:
  • перемещение диска в другое хранилище;
  • живая миграция ВМ на другой узел с локальным хранилищем.
В хранилищах с тонким выделением ресурсов (thin provisioning) это позволяет освободить неиспользуемое пространство.
Связь с гостевым агентом осуществляется через UNIX-сокет, расположенный в /var/run/qemu-server/<my_vmid>.qga. Проверить доступность агента можно командой: 
# qm agent <vmid> ping
Если агент корректно установлен и запущен в ВМ, вывод команды будет пустой.