docker 配置 ls

描述列出配置
用法docker config ls [OPTIONS]
别名
docker config list

Swarm 此命令与 Swarm 协调器配合使用。

描述

在管理节点上运行此命令以列出 Swarm 中的配置。

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

笔记

这是集群管理命令,必须在 Swarm 管理节点上执行。要了解管理器和工作器,请参阅 文档中的Swarm 模式部分。

选项

选项默认描述
-f, --filter根据提供的条件过滤输出
--format使用自定义模板设置输出格式:
'table':以带有列标题的表格格式打印输出(默认)
'table TEMPLATE':使用给定的 Go 模板以表格格式打印输出
'json':以 JSON 格式打印
'TEMPLATE':打印使用给定的 Go 模板输出。有关使用模板格式化输出的更多信息,
请参阅 https://docker.github.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(配置的ID)
  • 标签(label=<key>label=<key>=<value>)
  • 名称(配置的名称)

ID

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

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

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

标签

过滤器根据单独的值或值与值label的存在来匹配配置。labellabel

以下过滤器匹配带有project标签的所有配置,无论其值如何:

$ docker config ls --filter label=project

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

以下过滤器仅匹配具有project标签和 project-a值的服务。

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

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

姓名

过滤name器匹配配置名称的全部或前缀。

以下过滤器将 config 与名称包含前缀test.

$ 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 模板漂亮地打印配置输出。

下面列出了 Go 模板的有效占位符:

占位符描述
.ID配置ID
.Name配置名称
.CreatedAt配置创建时间
.UpdatedAt配置更新时间
.Labels分配给配置的所有标签
.Label此配置的特定标签的值。例如{{.Label "my-label"}}

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

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

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

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

要以表格格式列出所有配置及其名称和创建日期,您可以使用:

$ 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