测试与调试

为了提升开发者体验,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 的控制面板访问它们。

  1. 在 Docker Desktop 中,导航到“设置”。
  2. 在“扩展”选项卡下,选择“显示 Docker Desktop Extensions 系统容器”选项。现在你可以查看你的扩展容器及其日志。

清理

要删除扩展,运行

$ docker extension rm <name-of-your-extension>

下一步

页面选项