docker stack services

說明列出堆疊中的服務
用法docker stack services [選項] 堆疊

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

說明

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

注意事項

這是一個叢集管理指令，必須在 Swarm 管理節點上執行。若要瞭解管理節點和工作節點，請參閱文件中Swarm 模式章節。

選項

選項預設值說明
-f, --filter根據提供的條件篩選輸出
--format使用自訂範本格式化輸出
'table': 以表格格式列印輸出，包含欄位標題（預設）
'table 範本': 使用指定的 Go 範本以表格格式列印輸出
'json': 以 JSON 格式列印
'範本': 使用指定的 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"}