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
器匹配配置 ID 的全部或前缀。
$ docker config ls -f "id=6697bflskwj1998km1gnnjr38"
ID NAME CREATED UPDATED
6697bflskwj1998km1gnnjr38 q5s5570vtvnimefos1fyeo2u2 6 weeks ago 6 weeks ago
标签
过滤器根据单独的值或值与值label
的存在来匹配配置。label
label
以下过滤器匹配带有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