码头工人秘密ls

描述

列出机密

API 1.25+  客户端和守护程序API都必须至少为 1.25， 才能使用此命令。docker version在客户端上使用命令检查客户端和守护程序API版本。

Swarm此命令与Swarm协调器一起使用。

用法

$ docker secret ls [OPTIONS]

扩展说明

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

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

笔记

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

有关此命令的示例用法，请参阅下面的示例部分。

选项

名称，简写 默认 描述
--filter ， -f 根据提供的条件过滤输出
--format 使用Go模板打印漂亮的秘密
--quiet ， -q 仅显示ID

例子

$ 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过滤器匹配一个秘密的id的全部或前缀。

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

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

标签

该label过滤器根据一个label或一个label和一个值的存在来匹配秘密。

以下过滤器将所有秘密与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过滤器上的一个秘密的名字的全部或前缀匹配。

以下过滤器将secret与名称包含前缀的匹配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指令时也将包括列标题。

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

$ 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

上级命令

命令 描述
码头工人的秘密 管理Docker机密
命令 描述
码头工人秘密创建 从文件或STDIN创建秘密作为内容
码头工人秘密检查 显示有关一个或多个秘密的详细信息
码头工人秘密ls 列出机密
码头工人秘密RM 删除一个或多个秘密