docker stack services

描述列出堆疊中的服務
用法docker stack services [OPTIONS] STACK

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

描述

列出作為指定堆疊一部分執行的服務。

注意

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

選項

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

示例

以下命令顯示 `myapp` 堆疊中的所有服務

$ docker stack services myapp

ID            NAME            REPLICAS  IMAGE                                                                          COMMAND
7be5ei6sqeye  myapp_web       1/1       nginx@sha256:23f809e7fd5952e7d5be065b4d3643fbbceccd349d537b62a123ef2201bc886f
dn7m7nhhfb9y  myapp_db        1/1       mysql@sha256:a9a5b559f8821fe73d58c3606c812d1c044868d42c63817fa5125fd9d8b7b539

過濾 (--filter)

過濾標誌（`-f` 或 `--filter`）的格式為 `key=value` 對。如果存在多個過濾器，則傳遞多個標誌（例如，`--filter "foo=bar" --filter "bif=baz"`）。多個過濾標誌將組合為 `OR` 過濾器。

以下命令顯示 `web` 和 `db` 服務

$ docker stack services --filter name=myapp_web --filter name=myapp_db myapp

ID            NAME            REPLICAS  IMAGE                                                                          COMMAND
7be5ei6sqeye  myapp_web       1/1       nginx@sha256:23f809e7fd5952e7d5be065b4d3643fbbceccd349d537b62a123ef2201bc886f
dn7m7nhhfb9y  myapp_db        1/1       mysql@sha256:a9a5b559f8821fe73d58c3606c812d1c044868d42c63817fa5125fd9d8b7b539

目前支援的過濾器有：

  • id / ID (`--filter id=7be5ei6sqeye`，或 `--filter ID=7be5ei6sqeye`)
  • 標籤 (`--filter label=key=value`)
  • 模式 (`--filter mode=replicated`，或 `--filter mode=global`)
    • Swarm：不支援
  • 名稱 (`--filter name=myapp_web`)
  • 節點 (`--filter node=mynode`)
    • Swarm：不支援
  • 服務 (`--filter service=web`)
    • Swarm：不支援

格式化輸出 (--format)

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

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

佔位符描述
.ID服務 ID
.Name服務名稱
.Mode服務模式（replicated，global）
.Replicas服務副本
.Image服務映象

使用 `--format` 選項時，`stack services` 命令將嚴格按照模板宣告輸出資料，或者在使用 `table` 指令時，也包含列標題。

以下示例使用不帶標題的模板，並輸出所有服務由冒號（`:`）分隔的 `ID`、`Mode` 和 `Replicas` 條目

$ docker stack services --format "{{.ID}}: {{.Mode}} {{.Replicas}}"

0zmvwuiu3vue: replicated 10/10
fm6uf97exkul: global 5/5

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

$ docker stack services ls --format json
{"ID":"0axqbl293vwm","Image":"localstack/localstack:latest","Mode":"replicated","Name":"myapp_localstack","Ports":"*:4566-\u003e4566/tcp, *:8080-\u003e8080/tcp","Replicas":"0/1"}
{"ID":"384xvtzigz3p","Image":"redis:6.0.9-alpine3.12","Mode":"replicated","Name":"myapp_redis","Ports":"*:6379-\u003e6379/tcp","Replicas":"1/1"}
{"ID":"hyujct8cnjkk","Image":"postgres:13.2-alpine","Mode":"replicated","Name":"myapp_repos-db","Ports":"*:5432-\u003e5432/tcp","Replicas":"0/1"}