Terraform部署KVM桥接VM无法获取IP及Qemu guest agent安装问题

一、现有Terraform配置错误修正 #

你当前的配置存在3个核心错误，直接导致IP获取失败：

• 冗余的libvirt_network配置：你在libvirt_domain.gw的network_interface块中直接指定了bridge = "br0"，且注释了network_id关联配置，因此你定义的libvirt_network.my_network资源完全未被使用。且桥接模式下DHCP服务由局域网侧提供，你在该资源中开启的libvirt DHCP可能与现有网络DHCP冲突，建议直接删除该资源。
• 网络接口配置冲突：你同时配置了addresses = ["10.100.86.5"]（静态IP指定）和wait_for_lease = true（等待DHCP租约返回），二者逻辑互斥。如需静态IP则删除wait_for_lease配置；如需DHCP自动分配IP则删除addresses字段。
• 未挂载CloudInit盘：你定义了libvirt_cloudinit_disk.commoninit资源，但未在libvirt_domain.gw的disk块中挂载该镜像，导致CloudInit配置完全不生效，无法自动配置虚拟机内部环境。需要补充挂载配置：

  disk {
    volume_id = libvirt_cloudinit_disk.commoninit.id
  }
  

二、QEMU Guest Agent 相关问题解答 #

1. 宿主机安装是否生效 #

宿主机安装QEMU Guest Agent 完全不满足要求，该组件必须安装在虚拟机内部，才能实现宿主机与虚拟机的信息交互，读取虚拟机网卡IP等数据。

2. 虚拟机内安装方式 #

推荐通过CloudInit自动安装，适配Terraform自动化部署场景，在你的cloud_init.cfg中添加以下配置即可（CentOS7系统适用）：

#cloud-config
package_update: true
packages:
  - qemu-guest-agent
runcmd:
  - systemctl enable --now qemu-guest-agent

如果使用自定义镜像，也可以在制作qcow2镜像阶段提前安装并开启自启，执行命令：

yum install -y qemu-guest-agent
systemctl enable qemu-guest-agent

3. 运行状态验证 #

• 宿主机侧验证：替换<domain-name>为你的虚拟机名称（此处为gw），执行命令：
  virsh qemu-agent-command <domain-name> '{"execute":"guest-ping"}'
  返回{"return":{}}则说明通信正常。
• 虚拟机侧验证：登录虚拟机执行命令：
  systemctl status qemu-guest-agent
  状态显示active (running)即为正常运行。

内容的提问来源于stack exchange，提问作者Orly Orly