docker config 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://docs.docker.net.tw/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 （label=<key> 或 label=<key>=<value>）
  • name （配置的名稱）

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

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

以下過濾器匹配名稱包含 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