串口控制台

串口控制台会将文本终端(TTY)附加到虚拟机的串口。它非常适合无头 Linux 来宾、查看内核启动消息以及捕获 kernel panic 输出——这些场景下图形化的 VNC 控制台 并不适用。

串口控制台通过 WebSocket 连接到 KubeVirt 虚拟机实例 console 子资源,并传输原始 TTY 字节流(子协议 plain.kubevirt.io)。

注意事项

  • 只要虚拟机具有运行中的实例(Running、Paused、Starting 或 Stopping),串口控制台就可用。对于已停止的虚拟机,由于不存在实例,因此不可用——该端点会返回 404。
  • 来宾必须在其控制台上暴露串口 getty——Linux cloud image 通常会在内核命令行中设置 console=ttyS0。Windows 来宾没有串口控制台;请改用 VNC。
  • 权限:需要对 virtualmachineinstances/console 授予 get 动词权限。

打开串口控制台

virtctl console web-01 -n demo

这会升级为指向虚拟机实例 console 子资源的 WebSocket:

GET /apis/subresources.kubevirt.io/v1/namespaces/demo/virtualmachineinstances/web-01/console
Upgrade: websocket
Sec-WebSocket-Protocol: plain.kubevirt.io

运行中的实例会返回 101 Switching Protocols,然后持续传输原始 TTY 字节;已停止的虚拟机会返回 404(不存在实例)。