Enable host autostart for newly created VMs

main
admin 2 months ago
parent 0dc36cefc2
commit a3d6f946c0

@ -59,7 +59,7 @@ PYTHONDONTWRITEBYTECODE=1 .venv/bin/python -m uvicorn virsh_panel.app:create_app
若某台现有 VM 是用 `--graphics vnc,listen=0.0.0.0` 创建的,它会出现在列表,但面板出于安全考虑不会连接其公开监听的 VNC。需在 B 上把该 VM 的 VNC 监听改为 `127.0.0.1` 后再使用面板控制台。面板新建 VM 的 XML 使用 `host-passthrough` CPU、Q35 机型与 UEFI(启用 ACPI/APIC)、磁盘 `cache=none` 和 `discard=unmap`、按 vCPU 数设置 virtio 网卡队列,并加入 QEMU Guest Agent 通道和 virtio 内存气球空闲页回报。首次安装时临时挂载 ISO 并从光驱启动;保存的配置已弹出 ISO,后续仅从硬盘启动。B 需要有可用的 UEFI/OVMF 固件,客户机内还需安装并运行 `qemu-guest-agent` 才能使用 Guest Agent 功能。VNC 仍仅监听 B 的 `127.0.0.1`,现有 VM 配置不会被面板自动改写。
安装程序首次请求重启时,安装阶段的 VM 会先停机;请在面板点击“开机”,它会使用已弹出 ISO 的持久配置从硬盘继续启动。首次重启若发生在多阶段安装的中途,也按此方式继续。这个行为只适用于更新后**新创建**的 VM;此前已创建的 VM 不会自动改写,可在宿主机手动弹出 ISO 并把硬盘设为首选启动设备。若网页 VNC 显示“连接已中断”,这与虚拟机的 UEFI/磁盘 XML 是不同链路:先在浏览器开发者工具的 Network → WS 检查控制台请求是否得到 `101`。若 Uvicorn 日志显示对 `/console` 的普通 `GET` 返回 `404`,先检查面板虚拟环境是否安装了 WebSocket 协议依赖(旧版依赖清单可能遗漏),重新运行 `.venv/bin/python -m pip install -r requirements.txt`;若已安装,则检查反代是否用 HTTP/1.1 透传 `Upgrade` 和 `Connection` 头。确认 WebSocket 已连接后,再从 A 测试已保存 SSH 配置能否用 `ssh -W 127.0.0.1:<实际 VNC 端口>` 连到 B;不要为排障把 VNC 改成公网监听。
安装程序首次请求重启时,安装阶段的 VM 会先停机;请在面板点击“开机”,它会使用已弹出 ISO 的持久配置从硬盘继续启动。首次重启若发生在多阶段安装的中途,也按此方式继续。这个行为只适用于更新后**新创建**的 VM;此前已创建的 VM 不会自动改写,可在宿主机手动弹出 ISO 并把硬盘设为首选启动设备。此后新建的 ISO 和云镜像 VM 都会自动开启 libvirt 的**随宿主机开机自启**;现有 VM 的设置不会批量改动。开机自启只在宿主机启动时生效,不会让安装程序首次重启后的停机自动恢复。如果 ISO 安装尚未完成时宿主机重启,VM 可能从尚未安装完成的硬盘启动,建议初次安装期间避免重启宿主机。若网页 VNC 显示“连接已中断”,这与虚拟机的 UEFI/磁盘 XML 是不同链路:先在浏览器开发者工具的 Network → WS 检查控制台请求是否得到 `101`。若 Uvicorn 日志显示对 `/console` 的普通 `GET` 返回 `404`,先检查面板虚拟环境是否安装了 WebSocket 协议依赖(旧版依赖清单可能遗漏),重新运行 `.venv/bin/python -m pip install -r requirements.txt`;若已安装,则检查反代是否用 HTTP/1.1 透传 `Upgrade` 和 `Connection` 头。确认 WebSocket 已连接后,再从 A 测试已保存 SSH 配置能否用 `ssh -W 127.0.0.1:<实际 VNC 端口>` 连到 B;不要为排障把 VNC 改成公网监听。
## 公网云镜像模板创建(无需手动安装)

@ -180,6 +180,7 @@ class FakeDomain:
self._uuid = root.findtext("uuid")
self.running = running
self.persistent = persistent
self.auto_start = False
self.live_root = root if running else None
self.inactive_root = copy.deepcopy(root) if persistent else None
self.snapshots = 0
@ -233,7 +234,14 @@ class FakeDomain:
return ET.tostring(xml_root, encoding="unicode")
def autostart(self):
return 0
return int(self.auto_start)
def setAutostart(self, enabled):
assert enabled == 1
if not self.persistent or self.backend.fail_domain_autostart:
raise FakeLibvirtError("domain autostart failed")
self.auto_start = True
self.backend.domain_autostart_changed.append(self._uuid)
def isActive(self):
return self.running
@ -441,6 +449,7 @@ class FakeBackend:
self.defined = []
self.started = []
self.autostart_changed = []
self.domain_autostart_changed = []
self.destroyed = []
self.undefined = []
self.undefine_flags = []
@ -460,6 +469,7 @@ class FakeBackend:
self.fail_create = False
self.fail_domain_create = False
self.fail_domain_create_after_start = False
self.fail_domain_autostart = False
self.fail_destroy = False
self.fail_undefine = False
self.fail_volume_delete = False
@ -572,6 +582,8 @@ class VMServiceTests(unittest.TestCase):
self.assertEqual(resources["isos"], ["AlmaLinux-10.iso"])
vm = self.service.create_vm(self.spec())
self.assertEqual(vm["state"], "running")
self.assertTrue(vm["autostart"])
self.assertEqual(self.backend.domain_autostart_changed, [vm["uuid"]])
self.assertEqual(vm["vcpu"], 2)
self.assertEqual(vm["memory_mib"], 2048)
self.assertEqual(len(vm["disks"]), 1)
@ -616,6 +628,7 @@ class VMServiceTests(unittest.TestCase):
def test_installer_reboot_stops_guest_and_next_start_uses_unmounted_iso(self):
vm = self.service.create_vm(self.spec())
domain = self.backend.domains[0]
self.assertTrue(domain.autostart())
install_root = ET.fromstring(domain.XMLDesc(0))
final_root = ET.fromstring(domain.XMLDesc(1))
self.assertEqual(install_root.findtext("on_reboot"), "destroy")
@ -627,6 +640,7 @@ class VMServiceTests(unittest.TestCase):
domain.guest_reboot()
self.assertFalse(domain.isActive())
self.assertTrue(domain.autostart())
self.assertTrue(domain.isPersistent())
self.assertEqual(len(self.backend.domains), 1)
self.assertEqual(self.service.get_vm(vm["uuid"])["state"], "shutoff")
@ -951,6 +965,16 @@ class VMServiceTests(unittest.TestCase):
self.assertFalse(self.backend.pools["images"].volumes)
self.assertEqual(self.backend.undefine_flags, [])
def test_iso_vm_autostart_failure_rolls_back_new_vm_and_disk(self):
self.backend.fail_domain_autostart = True
with self.assertRaises(self.error_type) as failure:
self.service.create_vm(self.spec())
self.assertEqual(failure.exception.status, 502)
self.assertIn("开机自启", str(failure.exception))
self.assertFalse(self.backend.domains)
self.assertFalse(self.backend.pools["images"].volumes)
self.assertEqual(self.backend.domain_autostart_changed, [])
def test_final_define_failure_preserves_disk_referenced_by_other_live_vm(self):
other = self.service.create_vm(self.spec(name="other-vm"))
other_domain = self.backend.domains[0]
@ -1189,6 +1213,8 @@ class VMServiceTests(unittest.TestCase):
self.assertEqual(created["state"], "running")
self.assertEqual(created["name"], "cloud-vm")
self.assertTrue(created["autostart"])
self.assertEqual(self.backend.domain_autostart_changed, [created["uuid"]])
pool = self.backend.pools["images"]
self.assertIn(TEMPLATE_NAME, pool.volumes)
self.assertEqual(pool.volumes["cloud-vm.qcow2"].cloned_from,
@ -1330,6 +1356,18 @@ class VMServiceTests(unittest.TestCase):
self.assertFalse(self.backend.domains)
self.assertEqual(self.backend.undefine_flags, [4])
def test_cloud_vm_autostart_failure_rolls_back_new_vm_and_volumes(self):
service = self.cloud_service()
self.backend.fail_domain_autostart = True
with self.assertRaises(self.error_type) as failure:
self.create_cloud_vm(service, self.cloud_spec())
self.assertEqual(failure.exception.status, 502)
self.assertIn("开机自启", str(failure.exception))
self.assertEqual(set(self.backend.pools["images"].volumes), {TEMPLATE_NAME})
self.assertFalse(self.backend.domains)
self.assertEqual(self.backend.domain_starts, 0)
self.assertEqual(self.backend.domain_autostart_changed, [])
def test_reinstall_keeps_original_public_network_and_deletes_old_disk_only_after_start(self):
from virsh_panel.cloud_init import read_seed_network

@ -319,6 +319,15 @@ class VMService:
"console_port": self._vnc_port(root),
}
@staticmethod
def _enable_vm_autostart(domain: Any) -> None:
"""Require host-boot autostart on a new persistent VM definition."""
try:
domain.setAutostart(1)
except libvirt.libvirtError as exc:
LOG.warning("Could not enable VM autostart: %s", exc)
raise VMError("无法设置新虚拟机随宿主机开机自启", 502) from exc
def list_vms(self) -> list[dict[str, Any]]:
with self._connect() as conn:
return sorted(
@ -786,6 +795,7 @@ class VMService:
domain = conn.defineXML(domain_xml)
if domain is None:
raise VMError("宿主机未能定义云镜像虚拟机", 502)
self._enable_vm_autostart(domain)
domain.create()
return self._vm_dict(domain)
except Exception as exc:
@ -1116,6 +1126,7 @@ class VMService:
raise VMError("安装期虚拟机已启动,但无法保存卸载 ISO 后的配置", 502) from exc
if domain is None:
raise VMError("宿主机未能保存卸载 ISO 后的虚拟机配置", 502)
self._enable_vm_autostart(domain)
return self._vm_dict(domain)
except Exception as exc:
if not self._rollback_new_vm(conn, vm_uuid, validated["name"],

Loading…
Cancel
Save