如何使用 docker config create 命令管理配置

简介

在本实验中，你将学习如何使用 docker config create 命令高效管理 Docker 中的配置。我们将探索多种创建配置的方法，首先从标准输入直接创建简单配置开始。

随后，你将学习如何从现有文件创建配置，这是管理更复杂配置数据的实用方法。我们还将介绍如何为配置添加标签（labels），以便更好地组织和识别。最后，你将学习如何检查已创建配置的详细信息，以验证其内容和属性。

Skills Graph

从标准输入创建简单配置

在这一步中，你将学习如何从标准输入（STDIN）创建 Docker 配置。Docker 配置用于存储非敏感数据（例如配置文件），这些数据可以被 Docker 服务访问。

首先，我们来创建一个简单的配置内容。我们将使用 echo 命令输出字符串，并通过管道传递给 docker config create 命令。

echo "This is my simple config content." | docker config create my_simple_config -

在上面的命令中：

• echo "This is my simple config content." 输出将作为配置内容的字符串
• | 是管道操作符，将 echo 命令的输出作为下一个命令的输入
• docker config create 是创建新 Docker 配置的命令
• my_simple_config 是我们为配置指定的名称
• - 告诉 docker config create 从标准输入读取配置内容

运行此命令后，Docker 将创建一个名为 my_simple_config 的配置，内容为指定的字符串。

要验证配置是否创建成功，你可以使用 docker config ls 命令列出现有的 Docker 配置。

docker config ls

你应该能在输出中看到列出的 my_simple_config。

从文件创建配置

在上一步中，你学习了如何从标准输入创建 Docker 配置。本步骤将教你如何从文件创建 Docker 配置，这是管理较大或较复杂配置数据的常用方法。

首先，我们创建一个简单的配置文件。使用 nano 编辑器在 ~/project 目录下创建名为 my_config_file.txt 的文件。

nano ~/project/my_config_file.txt

在 nano 编辑器中输入以下内容：

This is the content from my config file.
Another line of configuration.

按 Ctrl + X，然后输入 Y 并按 Enter 保存文件并退出编辑器。

现在有了配置文件，我们可以使用 docker config create 命令从中创建 Docker 配置。

docker config create my_file_config ~/project/my_config_file.txt

该命令中：

• docker config create 是创建新 Docker 配置的命令
• my_file_config 是我们为此配置指定的名称
• ~/project/my_config_file.txt 是包含配置内容的文件路径

Docker 将从 ~/project/my_config_file.txt 读取内容并创建名为 my_file_config 的配置。

要确认配置是否创建成功，可以再次列出 Docker 配置。

docker config ls

现在你应该能看到上一步创建的 my_simple_config 和本步骤创建的 my_file_config 都列在其中。

创建带标签的配置

在本步骤中，你将学习如何为 Docker 配置添加标签。标签是键值对，可以附加到 Docker 对象（包括配置）上，帮助组织和识别它们，这在大型部署中特别有用。

我们将创建另一个配置，这次在创建过程中添加标签。使用与上一步相同的文件内容，但通过 cat 管道传递给 docker config create 命令，并使用 --label 标志添加标签。

cat ~/project/my_config_file.txt | docker config create --label environment=development --label version=1.0 my_labeled_config -

分解这个命令：

• cat ~/project/my_config_file.txt 读取之前创建的文件内容
• | 将文件内容传递给下一个命令
• docker config create 是创建新 Docker 配置的命令
• --label environment=development 添加键为 environment、值为 development 的标签
• --label version=1.0 添加键为 version、值为 1.0 的另一个标签（可多次使用 --label 标志添加多个标签）
• my_labeled_config 是我们为此配置指定的名称
• - 表示配置内容应从标准输入读取

执行此命令后，将创建一个名为 my_labeled_config 的新配置，包含指定内容和标签。

要查看配置关联的标签，可以使用带 --format 标志的 docker config ls 命令显示标签：

docker config ls --format "{{.Name}}\t{{.Labels}}"

该命令将列出配置名称及其关联标签，你应该能看到 my_labeled_config 的 environment 和 version 标签。

检查已创建的配置

在这最后一步中，你将学习如何检查 Docker 配置以查看其详细信息，包括 ID、名称、创建时间和标签。这对于验证配置属性及理解其配置非常有用。

我们将使用 docker config inspect 命令来查看上一步创建的 my_labeled_config 的详细信息。

docker config inspect my_labeled_config

该命令将输出一个 JSON 格式的字符串，包含指定配置的详细信息。你将看到诸如 ID、Name、CreatedAt、UpdatedAt 和 Labels 等字段。Labels 字段将显示我们添加的 environment 和 version 标签。

你也可以使用 --pretty 标志获取更易读的输出格式：

docker config inspect --pretty my_labeled_config

这将以更有条理的格式显示信息，使其更易于阅读。

检查配置是管理 Docker 配置的关键步骤，它能让你在将配置用于服务前确认其设置。

总结

在本实验中，你学习了如何使用 docker config create 命令创建 Docker 配置。你练习了直接从标准输入创建简单配置的方法，这适用于快速创建小型配置。你还学习了如何从文件创建配置，这种方法更适合管理较大或较复杂的配置数据。最后，你探索了如何为配置添加标签以实现更好的组织和元数据管理，以及如何使用 docker config inspect 命令检查已创建配置的详细信息。