如何使用 docker desktop engine ls 命令列出可用引擎

简介

在本实验中，你将学习如何使用 docker desktop engine ls 命令来列出可用的 Docker 引擎。首先，你将了解该命令的作用以及它如何与云虚拟机环境中的 Docker 守护进程交互。

在介绍之后，你将探索 docker desktop engine ls 命令的不同输出格式。你将学习如何使用默认的表格格式列出可用引擎、使用 JSON 格式输出结构化数据，以及使用 pretty 格式提升可读性。本实验将帮助你掌握使用 docker desktop CLI 有效检查和管理 Docker 引擎的技能。

Skills Graph

理解 docker desktop engine ls 命令的作用

在这一步骤中，我们将了解 docker desktop engine ls 命令的作用。虽然 LabEx 环境是云虚拟机而非桌面环境，但 docker desktop 命令仍然可用，可用于管理 Docker 引擎。

docker desktop engine ls 命令用于列出 Docker Desktop 所识别的可用 Docker 引擎。在典型的 Docker Desktop 安装中，这可能会显示不同的引擎，例如默认引擎或其他已配置的引擎。在我们的 LabEx 虚拟机环境中，该命令将与运行在虚拟机上的 Docker 守护进程交互。

让我们执行该命令查看输出。请在 ~/project 目录下打开终端。

docker desktop engine ls

你应该会看到类似以下的输出，显示默认引擎：

NAME    STATUS    BUILTIN
default running   true

该输出告诉我们引擎的名称（default）、当前状态（running）以及是否为内置引擎（true）。理解该命令是使用 docker desktop CLI 管理 Docker 引擎的第一步。

使用默认格式列出可用引擎

在前一步骤中，我们使用了不带任何特定格式选项的 docker desktop engine ls 命令。该命令默认采用标准表格格式来显示 Docker 引擎信息，这种默认格式通常易于阅读，并能一目了然地提供关键信息。

让我们再次执行该命令查看默认输出格式。请确保你位于终端中的 ~/project 目录下。

docker desktop engine ls

输出结果将如下所示：

NAME    STATUS    BUILTIN
default running   true

这就是默认格式。它以带有列标题（NAME、STATUS 和 BUILTIN）的表格形式呈现数据，这种格式适合快速查看和人工阅读。在接下来的步骤中，我们将探索其他格式选项，这些选项在编写脚本或需要不同数据结构时非常有用。

使用 JSON 格式列出可用引擎

在本步骤中，我们将学习如何以 JSON 格式列出可用的 Docker 引擎。JSON 格式特别适用于需要以编程方式处理输出的场景，例如在脚本中或与其他工具集成时。

要获取 JSON 格式的输出，我们需要使用 --format 标志并指定值为 json。

在 ~/project 目录下的终端中执行以下命令：

docker desktop engine ls --format json

输出将是一个包含各 Docker 引擎对象的 JSON 数组，类似如下格式：

[
  {
    "Name": "default",
    "Status": "running",
    "Builtin": true
  }
]

如你所见，信息以数组内的 JSON 对象形式呈现，包含 "Name"、"Status" 和 "Builtin" 等键值。这种格式具有机器可读性，能够被各种编程语言和工具轻松解析。

使用 pretty 格式列出可用引擎

在本步骤中，我们将探索 docker desktop engine ls 命令的另一个实用格式选项：pretty 格式。该格式允许你使用 Go 模板语法自定义输出，精确控制显示哪些字段以及如何呈现这些字段。

要使用 pretty 格式，你需要为 --format 标志提供一个 Go 模板字符串。例如，要显示引擎名称和状态，可以使用模板 {{.Name}}\t{{.Status}}。其中 . 表示当前对象（一个引擎），.Name 和 .Status 则访问相应字段。\t 表示制表符，用于分隔列。

让我们尝试使用 pretty 格式列出引擎名称和状态。在 ~/project 目录下的终端中执行以下命令：

docker desktop engine ls --format "{{.Name}}\t{{.Status}}"

输出将显示引擎名称和状态，以制表符分隔：

default running

你也可以在 pretty 格式中包含表头。要在模板字符串中添加表头，例如添加 "ENGINE NAME" 和 "STATUS" 表头：

docker desktop engine ls --format "ENGINE NAME\tSTATUS\n{{.Name}}\t{{.Status}}"

现在输出将包含表头：

ENGINE NAME	STATUS
default	running

\n 用于在表头行后创建换行。pretty 格式非常灵活，允许你根据具体需求定制输出，既适合人工阅读，也适用于那些使用 JSON 格式可能过于复杂的简单脚本任务。

总结

在本实验中，我们学习了如何使用 docker desktop engine ls 命令来列出可用的 Docker 引擎。我们首先了解了该命令的用途：用于显示 Docker Desktop 已知的引擎信息，即使在 LabEx 这样的云虚拟机环境中也能使用。随后我们练习了使用默认输出格式列出可用引擎，该格式以清晰易读的表格形式展示引擎名称、状态以及是否为内置引擎。

我们进一步探索了 docker desktop engine ls 命令的灵活性，通过 JSON 格式（适用于程序化处理）和 pretty 格式（提供更人性化的格式化输出）来列出可用引擎。通过这些步骤，我们获得了使用不同输出格式查看 Docker 引擎信息的实践经验。