切换语言

docker stack 服务

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

Swarm 此命令适用于 Swarm 调度器。

描述

列出作为指定堆栈一部分运行的服务。

注意

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

选项

选项默认描述
-f, --filter根据提供的条件过滤输出
--format使用自定义模板格式化输出：
'table': 以表格格式打印输出，带有列标题（默认）
'table TEMPLATE': 使用给定的 Go 模板以表格格式打印输出
'json': 以 JSON 格式打印
'TEMPLATE': 使用给定的 Go 模板打印输出。
参考https://docs.docker.com/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: 不支持
  • service (--filter service=web)
    • Swarm: 不支持

格式化输出 (--format)

格式化选项 (--format) 使用 Go 模板美化服务输出。

Go 模板的有效占位符列表如下：

占位符描述
.ID服务 ID
.Name服务名称
.Mode服务模式 (副本, 全局)
.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"}