测试与调试
目录
为了提升开发者体验,Docker Desktop 提供了一套工具来帮助你测试和调试扩展。
打开 Chrome DevTools
为了在选择“扩展”选项卡时打开扩展的 Chrome DevTools,运行
$ docker extension dev debug <name-of-your-extensions>
每次后续点击扩展选项卡也会打开 Chrome DevTools。要停止此行为,运行
$ docker extension dev reset <name-of-your-extensions>
扩展部署后,也可以使用 Konami Code 的变体从 UI 扩展部分打开 Chrome DevTools。选择“扩展”选项卡,然后依次按下键盘序列 up, up, down, down, left, right, left, right, p, d, t
。
在开发 UI 时进行热重载
在 UI 开发过程中,使用热重载来测试更改而无需重新构建整个扩展非常有帮助。为此,你可以配置 Docker Desktop 从开发服务器加载 UI,例如使用 Vite 启动的服务器。
假设你的应用运行在默认端口,启动你的 UI 应用,然后运行
$ cd ui
$ npm run dev
这会启动一个监听在端口 3000 的开发服务器。
现在你可以告诉 Docker Desktop 将此作为前端源。在另一个终端中运行
$ docker extension dev ui-source <name-of-your-extensions> http://localhost:3000
关闭并重新打开 Docker Desktop 控制面板,然后前往你的扩展。前端代码的所有更改会立即可见。
完成后,你可以将扩展配置重置为原始设置。如果你使用了 docker extension dev debug <你的扩展名称>
命令,这也会重置打开 Chrome DevTools 的设置。
$ docker extension dev reset <name-of-your-extensions>
显示扩展容器
如果你的扩展包含一个或多个作为容器在 Docker Desktop VM 中运行的服务,你可以轻松地从 Docker Desktop 的控制面板访问它们。
- 在 Docker Desktop 中,导航到“设置”。
- 在“扩展”选项卡下,选择“显示 Docker Desktop Extensions 系统容器”选项。现在你可以查看你的扩展容器及其日志。
清理
要删除扩展,运行
$ docker extension rm <name-of-your-extension>