如何交互式运行 nixosTests 调试单个 NixOS 测试脚本【免费下载链接】nixpkgsNix Packages collection NixOS项目地址: https://gitcode.com/GitHub_Trending/ni/nixpkgs当你写了一个 NixOS 测试例如nixos/tests/login.nix想单独调试它的testScript时每次nix-build后只能看到日志无法在测试执行到一半时停下来检查 VM 状态。nixpkgs 的文档给出了交互式方案构建测试的.driverInteractive属性并直接运行nixos-test-driver进入一个 Python REPL可以随时执行start_all()、test_script()或在虚拟机里跑命令。适用前提是你在一个 nixpkgs 仓库克隆中工作并且机器具备 QEMU 虚拟机所需的虚拟化支持system features 中包含kvmmacOS 为apple-virt。构建交互式驱动先构建目标测试的driverInteractive属性而不是普通属性。以login测试为例$ nix-build . -A nixosTests.login.driverInteractive $ ./result/bin/nixos-test-driver [...] 构建完成后会进入的交互式命令行交互式 Python 驱动。如果测试使用systemd-nspawn容器节点交互式运行需要 root 权限因为驱动会直接调用systemd-nspawn启动容器$ sudo ./result/bin/nixos-test-driver [...] 另外注意以这种方式执行时虚拟机会通过 backdoor 控制接口通常是eth0获得网络乃至 Internet 访问。driverInteractive会把普通测试配置与interactive子模块中的定义合并得到一个更可用、图形化的、但略有不同的配置。如果你只想交互式运行普通配置应改构建test.driver属性然后用result/bin/nixos-test-driver --interactive调用。在 REPL 中执行和检查测试脚本进入驱动后可以输入任意 Python 语句。文档给出的示例 start_all() test_script() machine.succeed(touch /tmp/foo) print(machine.succeed(pwd)) # Show stdout of command其中test_script会执行整个测试脚本完成后回到驱动的命令行。这一步是调试的关键测试跑完或失败后你仍然留在驱动里可以检查 VM 的残留状态来定位testScript的问题。登录测试虚拟机SSH backdoor调试单台机器最常用的方式是启用基于 SSH 的 backdoor。在测试定义中加入{ name …; nodes.machines { # … }; interactive.sshBackdoor.enable true; }这会为每台 VM 创建一个 vsock socket 供 SSH 登录配置为 root 登录、空密码。宿主机一侧通过 UNIX domain socket 和 vhost-device-vsock 通信因此不需要分配系统全局唯一的 vsock 编号。登录命令的格式为$ ssh vsock-mux//tmp/path/to/host -o Userroot这里的 socket 路径在启动测试驱动时会打印出来例如文档示例Note: this requires systemd-ssh-proxy(1) to be enabled (default on NixOS 25.05 and newer). machine: ssh -o Userroot vsock-mux//tmp/tmpg1rp9nti/machine_host.socket这要求systemd-ssh-proxy(1)处于启用状态NixOS 25.05 及以上默认启用在非 NixOS 系统上你可能需要自行启用该 SSH 配置。测试运行期间也可以随时在 REPL 里重新打印登录命令In [2]: dump_machine_ssh() SSH backdoor enabled, the machines can be accessed like this: Note: this requires systemd-ssh-proxy(1) to be enabled (default on NixOS 25.05 and newer). machine: ssh -o Userroot vsock-mux//tmp/tmpg1rp9nti/machine_host.socketshell_interact()已被弃用文档明确建议优先使用上面的交互式 SSH backdoor这里不再展开旧的用法。可选端口转发与复用 VM 状态端口转发。如果测试只有一台 VM可以通过 QEMU 的hostfwd把 VM 内端口转发到宿主机例如把 VM 的22端口映射到宿主机的2222$ QEMU_NET_OPTShostfwdtcp:127.0.0.1:2222-:22 ./result/bin/nixos-test-driver多台机器时该方式不可用宿主机一个端口无法转发到多个 VM。此时可以在测试定义中临时设置virtualisation.forwardPorts用于调试。注意这些转发走 VM 的虚拟网络接口无法连接到只绑定在 VM loopback127.0.0.1上的端口并且 VM 的 NixOS 防火墙必须放行这些连接。复用状态。想让下次调试从上次中断的 VM 状态继续时加--keep-machine-state标志$ ./result/bin/nixos-test-driver --keep-machine-state机器状态保存在$TMPDIR/vm-state-machinename目录中。运行前提与限制小结QEMU 虚拟机测试需要宿主机 system features 中包含kvmmacOS 为apple-virt远程 builder 的特性还需要在客户端额外配置。交互式运行systemd-nspawn容器测试必须用sudo。SSH backdoor 依赖systemd-ssh-proxy(1)NixOS 25.05 及以上默认启用其他系统需自行启用。交互式驱动下 VM 具备网络访问driverInteractive配置与普通.driver配置不同前者额外合并了interactive子模块。【免费下载链接】nixpkgsNix Packages collection NixOS项目地址: https://gitcode.com/GitHub_Trending/ni/nixpkgs创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考