如何使用 docker context export 命令导出上下文

介绍

在本实验中，你将学习如何使用 docker context export 命令导出 Docker 上下文（context）。我们将从创建一个新的 Docker 上下文开始，该功能允许你将 Docker CLI 连接到不同的 Docker 守护进程（daemon）。

在创建新上下文后，你将练习导出该上下文。你将学习如何将上下文导出到文件以供后续使用或共享，以及如何直接将上下文导出到标准输出（STDOUT）。通过这个动手实践，你将掌握 docker context export 命令在管理和共享 Docker 环境中的实际应用。

创建新的 Docker 上下文

在本步骤中，我们将学习如何创建新的 Docker 上下文（context）。Docker 上下文是一种将你的 Docker CLI 连接到不同 Docker 守护进程（daemon）的方式。当你想管理远程机器或不同环境中的 Docker 时，这会非常有用。

默认情况下，你的 Docker CLI 会连接到本地 Docker 守护进程。我们可以使用 docker context ls 命令查看当前上下文：

docker context ls

你会看到类似以下的输出，表示默认上下文处于激活状态：

NAME                DESCRIPTION                               DOCKER ENDPOINT                  KUBERNETES ENDPOINT   ORCHESTRATOR
default *           Current DOCKER_HOST environment variable   unix:///var/run/docker.sock

现在，让我们创建一个新上下文。我们将创建一个名为 my-context 的上下文。在本示例中，我们仍会将其指向本地 Docker 守护进程，但在实际场景中，你可以将其指向远程守护进程。

我们使用 docker context create 命令，后跟上下文名称和端点：

docker context create my-context --docker "host=unix:///var/run/docker.sock"

创建上下文后，你会看到确认消息：

my-context
Successfully created context "my-context"

现在，让我们再次列出上下文以查看新创建的上下文：

docker context ls

现在你应该能看到 default 和 my-context 都被列出：

NAME                DESCRIPTION                               DOCKER ENDPOINT                  KUBERNETES ENDPOINT   ORCHESTRATOR
default *           Current DOCKER_HOST environment variable   unix:///var/run/docker.sock
my-context                                                    unix:///var/run/docker.sock

要切换到新上下文，我们使用 docker context use 命令后跟上下文名称：

docker context use my-context

你会看到确认上下文切换的消息：

my-context
Current context is now "my-context"

最后，让我们再次列出上下文以确认 my-context 现在是激活的上下文（由星号 * 表示）：

docker context ls

输出应显示 my-context 为激活上下文：

NAME                DESCRIPTION                               DOCKER ENDPOINT                  KUBERNETES ENDPOINT   ORCHESTRATOR
default             Current DOCKER_HOST environment variable   unix:///var/run/docker.sock
my-context *                                                  unix:///var/run/docker.sock

将 Docker 上下文导出到文件

在本步骤中，我们将学习如何将 Docker 上下文导出至文件。导出上下文可以将其配置保存到文件中，便于在其他机器上共享或导入。这对于共享远程 Docker 环境的访问权限特别有用。

我们将导出上一步创建的 my-context。使用 docker context export 命令，后跟上下文名称和目标文件路径。这里我们将其导出到 ~/project 目录下名为 my-context.dockercontext 的文件中。

docker context export my-context > ~/project/my-context.dockercontext

此命令会将 my-context 的配置导出到指定文件。如果命令执行成功，控制台不会有输出。

要验证文件是否创建成功，可以使用 ls 命令列出 ~/project 目录中的文件。

ls ~/project/

你应该能看到 my-context.dockercontext 出现在文件列表中。

我们还可以使用 cat 命令查看导出的上下文文件内容。

cat ~/project/my-context.dockercontext

输出将以 JSON 格式显示 my-context 的配置信息，包括上下文名称和 Docker 端点等。

{
  "Name": "my-context",
  "Metadata": null,
  "Endpoints": {
    "docker": {
      "Host": "unix:///var/run/docker.sock",
      "SkipTLSVerify": false
    }
  },
  "TLSMaterial": null
}

现在，这个导出的文件可以通过 docker context import 命令在其他机器上导入该上下文。

将 Docker 上下文导出到标准输出 (STDOUT)

在本步骤中，我们将学习如何将 Docker 上下文直接导出至标准输出（STDOUT）。当你想快速查看上下文配置或将其传递给其他命令处理而不保存到文件时，这种方法非常实用。

我们将继续使用之前创建的 my-context 和 docker context export 命令，但这次不将输出重定向到文件。

docker context export my-context

执行此命令会将 my-context 的 JSON 配置直接打印到终端。

{
  "Name": "my-context",
  "Metadata": null,
  "Endpoints": {
    "docker": {
      "Host": "unix:///var/run/docker.sock",
      "SkipTLSVerify": false
    }
  },
  "TLSMaterial": null
}

该输出内容与上一步保存到 my-context.dockercontext 文件的内容完全一致。导出至标准输出是一种快速检查上下文配置的便捷方式。

你还可以将此输出通过管道传递给其他命令进行后续处理。例如，可以传递给 jq 解析 JSON 或传递给 grep 搜索特定信息。

举例来说，要从导出的上下文中查找 Docker 端点：

docker context export my-context | grep "unix:///var/run/docker.sock"

该命令会将上下文导出至标准输出，然后使用 grep 查找包含 "unix:///var/run/docker.sock" 的行。输出结果为：

      "Host": "unix:///var/run/docker.sock",

这展示了如何在不创建中间文件的情况下，直接在命令行中处理上下文配置。

总结

在本实验中，我们学习了如何创建和管理 Docker 上下文。首先了解了 Docker 上下文的概念，以及如何使用 docker context ls 命令列出已有上下文。随后通过 docker context create 创建了名为 my-context 的新上下文，演示了如何指定 Docker 端点。最后我们练习了使用 docker context use 在不同上下文间切换。

在创建和切换上下文后，我们探索了 docker context export 命令。学习了如何将特定 Docker 上下文导出至文件，便于共享或备份上下文配置。此外，我们还了解了如何将上下文配置直接导出至标准输出，为脚本编写或即时使用提供了灵活性。这些步骤全面展示了如何管理和导出 Docker 上下文以连接不同的 Docker 守护进程。