docker secret ls

描述列出 secrets
用法docker secret ls [選項]
別名
docker secret list

Swarm 此命令適用於 Swarm 編排器。

描述

在管理器節點上執行此命令以列出 swarm 中的 secrets。

有關使用秘密的詳細資訊，請參閱使用 Docker 秘密管理敏感資料。

注意

這是一個叢集管理命令，必須在 Swarm 管理器節點上執行。要了解管理器和工作器，請參閱文件中的Swarm 模式部分。

選項

選項預設值描述
-f, --filter根據提供的條件篩選輸出
--format使用自定義模板格式化輸出
'table': 以帶列標題的表格格式列印輸出（預設）
'table TEMPLATE': 使用給定的 Go 模板以表格格式列印輸出
'json': 以 JSON 格式列印
'TEMPLATE': 使用給定的 Go 模板列印輸出。
有關使用模板格式化輸出的更多資訊，請參閱https://docs.docker.net.tw/go/formatting/
-q, --quiet僅顯示 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

過濾 (--filter)

過濾標誌（-f 或 --filter）的格式是 key=value 對。如果有多個過濾器，則傳遞多個標誌（例如，--filter "foo=bar" --filter "bif=baz"）。

目前支援的過濾器有：

  • id (secret 的 ID)
  • label (label=<key> 或 label=<key>=<value>)
  • name (secret 的名稱)

id

id 過濾器匹配 secret ID 的全部或字首。

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

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

標籤

label 過濾器根據 label 的存在或 label 和值的存在來匹配 secrets。

以下過濾器匹配所有帶有 project 標籤的 secrets，無論其值如何

$ 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

name 過濾器匹配 secret 名稱的全部或字首。

以下過濾器匹配名稱包含 test 字首的 secret。

$ docker secret ls --filter name=test_secret

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

格式化輸出 (--format)

格式化選項（--format）使用 Go 模板美觀地列印 secrets 輸出。

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

佔位符描述
.IDSecret ID
.NameSecret 名稱
.CreatedAtsecret 的建立時間
.UpdatedAtsecret 的更新時間
.Labels分配給 secret 的所有標籤
.Label此 secret 特定標籤的值。例如 {{.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

要以表格格式列出所有 secrets 的名稱和建立日期，您可以使用

$ 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

要以 JSON 格式列出所有 secrets，請使用 json 指令

$ docker secret ls --format json
{"CreatedAt":"28 seconds ago","Driver":"","ID":"4y7hvwrt1u8e9uxh5ygqj7mzc","Labels":"","Name":"mysecret","UpdatedAt":"28 seconds ago"}