在线文档教程
Docker 17
引擎: CLI | Engine: CLI

docker secret ls

docker secret ls

描述

列出秘密

使用

docker secret ls [OPTIONS]

备选方案

名字,简写默认描述
--filter, -f 根据提供的条件过滤输出
--format 使用Go模板的俏皮秘密
--quiet,-q只显示ID

父命令

命令描述
docker secret 管理Docker机密

相关命令

命令描述
docker secret create 从文件或STDIN创建一个秘密作为内容
docker secret inspect 显示一个或多个秘密的详细信息
docker secret ls 列出秘密
docker secret rm 删除一个或多个秘密

扩展描述

在管理器节点上运行此命令,以列出群集中的秘密。

有关使用秘密的详细信息,请参阅用Docker secrets管理敏感数据。

实例

$ docker secret ls ID NAME CREATED UPDATED 6697bflskwj1998km1gnnjr38 q5s5570vtvnimefos1fyeo2u2 6 weeks ago 6 weeks ago 9u9hk4br2ej0wgngkga6rp4hq my_secret 5 weeks ago 5 weeks ago mem02h8n73mybpgqjf0kfi1n0 test_secret 3 seconds ago 3 seconds ago

过滤

过滤标志(-f--filter)格式是一key=value对。如果有多个过滤器,则传递多个标志(例如--filter "foo=bar" --filter "bif=baz"

目前支持的过滤器是:

  • ID(秘密 ID)

  • 标签(label=<key>或label=<key>=<value>)

  • 名字(秘密的名字)

ID

id筛选器与秘密标识的全部或前缀匹配。

$ docker secret ls -f "id=6697bflskwj1998km1gnnjr38" ID NAME CREATED UPDATED 6697bflskwj1998km1gnnjr38 q5s5570vtvnimefos1fyeo2u2 6 weeks ago 6 weeks ago

标签

label筛选器根据存在的labellabel还有一个价值。

下面的筛选器将所有秘密与project标签,不论其价值:

$ docker secret ls --filter label=project ID NAME CREATED UPDATED mem02h8n73mybpgqjf0kfi1n0 test_secret About an hour ago About an hour ago

下面的筛选器只将服务与project标签上带有project-a价值。

$ docker service ls --filter label=project=test ID NAME CREATED UPDATED mem02h8n73mybpgqjf0kfi1n0 test_secret About an hour ago About an hour ago

名称

name筛选器与秘密名称的全部或前缀匹配。

以下过滤器与包含前缀的名称test相匹配。

$ docker secret ls --filter name=test_secret ID NAME CREATED UPDATED mem02h8n73mybpgqjf0kfi1n0 test_secret About an hour ago About an hour ago

格式化输出

格式化选项(--format)可以使用 Go 模板打印秘密输出。

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

占位符描述
.ID秘密ID
.Name秘密名称
.CreatedAt秘密被创建的时间
.UpdatedAt秘密更新的时间
.Labels 分配给秘密的所有标签
.Label这个秘密的特定标签的价值。例如{{.Label“secret.ssh.key”}}

当使用--format选项,secret ls命令将按照模板声明的方式输出数据,或者在使用table指令,也将包括列标题。

下面的示例使用没有标头的模板,并输出IDName所有图像用冒号分隔的条目:

$ docker secret ls --format "{{.ID}}: {{.Name}}" 77af4d6b9913: secret-1 b6fa739cedf5: secret-2 78a85c484f71: secret-3

若要以表格格式列出所有机密及其名称和创建日期,可以使用:

$ docker secret ls --format "table {{.ID}}\t{{.Name}}\t{{.CreatedAt}}" ID NAME CREATED 77af4d6b9913 secret-1 5 minutes ago b6fa739cedf5 secret-2 3 hours ago 78a85c484f71 secret-3 10 days ago