From a3d6f946c058357d02a6a1490ba4e49c69d0e84f Mon Sep 17 00:00:00 2001 From: admin Date: Sat, 26 Sep 2026 03:08:32 +0800 Subject: [PATCH] Enable host autostart for newly created VMs --- README.md | 2 +- tests/test_libvirt_service.py | 40 +++++++++++++++++++++++++++++++++- virsh_panel/libvirt_service.py | 11 ++++++++++ 3 files changed, 51 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 94c525c9..5afed32b 100644 --- a/README.md +++ b/README.md @@ -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 改成公网监听。 ## 公网云镜像模板创建(无需手动安装) diff --git a/tests/test_libvirt_service.py b/tests/test_libvirt_service.py index e3d65262..afc0f4a6 100644 --- a/tests/test_libvirt_service.py +++ b/tests/test_libvirt_service.py @@ -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 diff --git a/virsh_panel/libvirt_service.py b/virsh_panel/libvirt_service.py index 59d181d4..79228152 100644 --- a/virsh_panel/libvirt_service.py +++ b/virsh_panel/libvirt_service.py @@ -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"],