docker config ls

说明列出 configs
用法docker config ls [OPTIONS]
别名
docker config list

Swarm 此命令适用于 Swarm 协调器。

说明

在 manager 节点上运行此命令可列出 Swarm 中的 configs。

有关使用 configs 的详细信息，请参阅使用 Docker Configs 存储配置数据。

注意

这是一个集群管理命令，必须在 Swarm manager 节点上执行。要了解 managers 和 workers，请参阅文档中的Swarm mode 部分。

选项

选项默认值说明
-f, --filter根据提供的条件过滤输出
--format使用自定义模板格式化输出
'table'：以带有列标题的表格格式打印输出（默认）
'table TEMPLATE'：使用给定的 Go 模板以表格格式打印输出
'json'：以 JSON 格式打印
'TEMPLATE'：使用给定的 Go 模板打印输出。
有关使用模板格式化输出的更多信息，请参阅 https://docs.docker.net.cn/go/formatting/。
-q, --quiet仅显示 ID

示例

$ docker config ls

ID                          NAME                        CREATED             UPDATED
6697bflskwj1998km1gnnjr38   q5s5570vtvnimefos1fyeo2u2   6 weeks ago         6 weeks ago
9u9hk4br2ej0wgngkga6rp4hq   my_config                   5 weeks ago         5 weeks ago
mem02h8n73mybpgqjf0kfi1n0   test_config                 3 seconds ago       3 seconds ago

过滤 (-f, --filter)

过滤标志 (-f 或 --filter) 的格式是 key=value 对。如果存在多个过滤器，则传递多个标志（例如，--filter "foo=bar" --filter "bif=baz"）。

当前支持的过滤器有

  • id (config 的 ID)
  • label (label=<key> 或 label=<key>=<value>)
  • name (config 的 name)

id

id 过滤器匹配 config 的 id 的全部或前缀。

$ docker config ls -f "id=6697bflskwj1998km1gnnjr38"

ID                          NAME                        CREATED             UPDATED
6697bflskwj1998km1gnnjr38   q5s5570vtvnimefos1fyeo2u2   6 weeks ago         6 weeks ago

label

label 过滤器根据是否存在 label 或 label 及其值来匹配 configs。

以下过滤器匹配所有带有 project label 的 configs，无论其值如何

$ docker config ls --filter label=project

ID                          NAME                        CREATED             UPDATED
mem02h8n73mybpgqjf0kfi1n0   test_config                 About an hour ago   About an hour ago

以下过滤器仅匹配带有 project label 且值为 project-a 的 services。

$ docker service ls --filter label=project=test

ID                          NAME                        CREATED             UPDATED
mem02h8n73mybpgqjf0kfi1n0   test_config                 About an hour ago   About an hour ago

name

name 过滤器匹配 config 的 name 的全部或前缀。

以下过滤器匹配 name 包含前缀 test 的 config。

$ docker config ls --filter name=test_config

ID                          NAME                        CREATED             UPDATED
mem02h8n73mybpgqjf0kfi1n0   test_config                 About an hour ago   About an hour ago

格式化输出 (--format)

格式化选项 (--format) 使用 Go 模板美化打印 configs 输出。

Go 模板的有效占位符如下所示

占位符说明
.IDConfig ID
.NameConfig 名称
.CreatedAtConfig 创建时间
.UpdatedAtConfig 更新时间
.Labels分配给 config 的所有 labels
.Label此 config 特定 label 的值。例如 {{.Label "my-label"}}

使用 --format 选项时，config ls 命令将完全按照模板声明输出数据，或者在使用 table 指令时，也将包含列标题。

以下示例使用不带标题的模板，并输出所有 images 的 ID 和 Name 条目，用冒号 (:) 分隔

$ docker config ls --format "{{.ID}}: {{.Name}}"

77af4d6b9913: config-1
b6fa739cedf5: config-2
78a85c484f71: config-3

要以表格格式列出所有 configs 的 name 和创建日期，您可以使用

$ docker config ls --format "table {{.ID}}\t{{.Name}}\t{{.CreatedAt}}"

ID                  NAME                      CREATED
77af4d6b9913        config-1                  5 minutes ago
b6fa739cedf5        config-2                  3 hours ago
78a85c484f71        config-3                  10 days ago