接口：DockerDesktopClient

Docker Desktop API 客户端的 v0 和 v1 接口的合并，为向后兼容性而提供。除非您正在使用旧版扩展，否则请改用 v1 类型。

属性

后端

• Readonly backend: undefined | BackendV0

window.ddClient.backend 对象可用于与扩展元数据 vm 部分中定义的后端进行通信。客户端已连接到后端。

警告

它将在未来的版本中移除。请改用 extension。

继承自

DockerDesktopClientV0.backend

扩展

• Readonly extension: Extension

ddClient.extension 对象可用于与扩展元数据 vm 部分中定义的后端进行通信。客户端已连接到后端。

继承自

DockerDesktopClientV1.extension

桌面UI

• Readonly desktopUI: DesktopUI

继承自

DockerDesktopClientV1.desktopUI

host

• Readonly host: Host

继承自

DockerDesktopClientV1.host

docker

• Readonly docker: Docker

继承自

DockerDesktopClientV1.docker

容器方法

列出容器

▸ listContainers(options): Promise<unknown>

获取正在运行的容器列表（与 docker ps 相同）。

默认情况下，这不会列出已停止的容器。您可以使用选项 {"all": true} 列出所有正在运行和已停止的容器。

const containers = await window.ddClient.listContainers();

警告

它将在未来的版本中移除。请改用 listContainers。

参数

返回

Promise<未知>

继承自

DockerDesktopClientV0.listContainers

镜像方法

列出镜像

▸ listImages(options): Promise<unknown>

获取镜像列表

const images = await window.ddClient.listImages();

警告

它将在未来的版本中移除。请改用 listImages。

参数

返回

Promise<未知>

继承自

DockerDesktopClientV0.listImages

导航方法

导航到容器

▸ navigateToContainers(): void

导航到 Docker Desktop 中的容器窗口。

window.ddClient.navigateToContainers();

警告

它将在未来的版本中移除。请改用 viewContainers。

返回

void

继承自

DockerDesktopClientV0.navigateToContainers

导航到容器

▸ navigateToContainer(id): Promise<any>

导航到 Docker Desktop 中的容器窗口。

await window.ddClient.navigateToContainer(id);

警告

它将在未来的版本中移除。

参数

返回

Promise<any>

如果容器不存在，则 Promise 会失败。

继承自

DockerDesktopClientV0.navigateToContainer

导航到容器日志

▸ navigateToContainerLogs(id): Promise<any>

导航到 Docker Desktop 中的容器日志窗口。

await window.ddClient.navigateToContainerLogs(id);

警告

它将在未来的版本中移除。

参数

返回

Promise<any>

如果容器不存在，则 Promise 会失败。

继承自

DockerDesktopClientV0.navigateToContainerLogs

导航到容器检查

▸ navigateToContainerInspect(id): Promise<any>

导航到 Docker Desktop 中的容器检查窗口。

await window.ddClient.navigateToContainerInspect(id);

警告

它将在未来的版本中移除。

参数

返回

Promise<any>

如果容器不存在，则 Promise 会失败。

继承自

DockerDesktopClientV0.navigateToContainerInspect

导航到容器统计

▸ navigateToContainerStats(id): Promise<any>

导航到容器统计信息以查看 CPU、内存、磁盘读/写和网络 I/O 使用情况。

await window.ddClient.navigateToContainerStats(id);

警告

它将在未来的版本中移除。

参数

返回

Promise<any>

如果容器不存在，则 Promise 会失败。

继承自

DockerDesktopClientV0.navigateToContainerStats

导航到镜像

▸ navigateToImages(): void

导航到 Docker Desktop 中的镜像窗口。

await window.ddClient.navigateToImages(id);

警告

它将在未来的版本中移除。请改用 viewImages。

返回

void

继承自

DockerDesktopClientV0.navigateToImages

导航到镜像

▸ navigateToImage(id, tag): Promise<any>

导航到 Docker Desktop 中由 id 和 tag 引用的特定镜像。在此导航路线中，您可以找到镜像层、命令、创建时间和大小。

await window.ddClient.navigateToImage(id, tag);

警告

它将在未来的版本中移除。请改用 viewImage。

参数

返回

Promise<any>

如果容器不存在，则 Promise 会失败。

继承自

DockerDesktopClientV0.navigateToImage

导航到卷

▸ navigateToVolumes(): void

导航到 Docker Desktop 中的卷窗口。

await window.ddClient.navigateToVolumes();

警告

它将在未来的版本中移除。请改用 viewVolumes。

返回

void

继承自

DockerDesktopClientV0.navigateToVolumes

导航到卷

▸ navigateToVolume(volume): void

导航到 Docker Desktop 中的特定卷。

window.ddClient.navigateToVolume(volume);

警告

它将在未来的版本中移除。请改用 viewVolume。

参数

返回

void

继承自

DockerDesktopClientV0.navigateToVolume

其他方法

执行主机命令

▸ execHostCmd(cmd): Promise<ExecResultV0>

您可以在扩展元数据的主机部分运行定义的二进制文件。

window.ddClient.execHostCmd(`cliShippedOnHost xxx`).then((cmdResult: any) => {
 console.log(cmdResult);
});

警告

它将在未来的版本中移除。请改用 exec。

参数

返回

Promise<ExecResultV0>

继承自

DockerDesktopClientV0.execHostCmd

启动主机命令

▸ spawnHostCmd(cmd, args, callback): void

在主机上调用扩展二进制文件并获取输出流。

window.ddClient.spawnHostCmd(
  `cliShippedOnHost`,
  [`arg1`, `arg2`],
  (data: any, err: any) => {
    console.log(data.stdout, data.stderr);
    // Once the command exits we get the status code
    if (data.code) {
      console.log(data.code);
    }
  }
);

警告

它将在未来的版本中移除。请改用 exec。

参数

返回

void

继承自

DockerDesktopClientV0.spawnHostCmd

执行Docker命令

▸ execDockerCmd(cmd, ...args): Promise<ExecResultV0>

您还可以直接执行 Docker 二进制文件。

const output = await window.ddClient.execDockerCmd("info");

警告

它将在未来的版本中移除。请改用 exec。

参数

返回

Promise<ExecResultV0>

结果将包含已执行命令的标准输出和标准错误

{
  "stderr": "...",
  "stdout": "..."
}

为方便起见，命令结果对象还具有根据输出格式轻松解析它的方法

• output.lines(): string[] 分割输出行。
• output.parseJsonObject(): any 解析格式良好的 JSON 输出。
• output.parseJsonLines(): any[] 将每行输出解析为 JSON 对象。

如果命令输出太长，或者需要将输出作为流获取，可以使用

• spawnDockerCmd 函数

window.ddClient.spawnDockerCmd("logs", ["-f", "..."], (data, error) => {
  console.log(data.stdout);
});

继承自

DockerDesktopClientV0.execDockerCmd

启动Docker命令

▸ spawnDockerCmd(cmd, args, callback): void

警告

它将在未来的版本中移除。请改用 exec。

参数

返回

void

继承自

DockerDesktopClientV0.spawnDockerCmd

打开外部链接

▸ openExternal(url): void

使用系统默认浏览器打开外部 URL。

window.ddClient.openExternal("https://docker.com");

警告

它将在未来的版本中移除。请改用 openExternal。

参数

返回

void

继承自

DockerDesktopClientV0.openExternal

Toast 方法

toast成功

▸ toastSuccess(msg): void

显示类型为成功的 toast 消息。

window.ddClient.toastSuccess("message");

警告`

它将在未来的版本中移除。请改用 success。

参数

返回

void

继承自

DockerDesktopClientV0.toastSuccess

toast警告

▸ toastWarning(msg): void

显示类型为警告的 toast 消息。

window.ddClient.toastWarning("message");

警告

它将在未来的版本中移除。请改用 warning。

参数

返回

void

继承自

DockerDesktopClientV0.toastWarning

toast错误

▸ toastError(msg): void

显示类型为错误的 toast 消息。

window.ddClient.toastError("message");

警告

它将在未来的版本中移除。请改用 error。

参数

返回

void

继承自

DockerDesktopClientV0.toastError