码头工人栈服务

描述

列出堆栈中的服务

API 1.25+  客户端和守护程序API都必须至少为 1.25， 才能使用此命令。docker version在客户端上使用命令检查客户端和守护程序API版本。

用法

$ docker stack services [OPTIONS] STACK

扩展说明

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

笔记

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

有关此命令的示例用法，请参阅下面的示例部分。

选项

名称，简写 默认 描述
--filter ， -f 根据提供的条件过滤输出
--format 使用Go模板的精美打印服务
--namespace Kubernetes
要使用的Kubernetes命名空间
--quiet ， -q 仅显示ID
--kubeconfig Kubernetes
Kubernetes配置文件
--orchestrator 要使用的协调器（大量| kubernetes |全部）

例子

以下命令显示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

筛选

过滤标志（-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）
    • 群：支持
    • Kubernetes：不支持
  • 标签（--filter label=key=value）
    • 群：支持
    • Kubernetes：受支持
  • 模式（--filter mode=replicated或--filter mode=global）
    • 群：不支持
    • Kubernetes：受支持
  • 名称（--filter name=myapp_web）
    • 群：支持
    • Kubernetes：受支持
  • 节点（--filter node=mynode）
    • 群：不支持
    • Kubernetes：受支持
  • 服务（--filter service=web）
    • 群：不支持
    • Kubernetes：受支持

格式设定

格式选项（--format）使用Go模板漂亮地打印服务输出。

下面列出了Go模板的有效占位符：

占位符 描述
.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

上级命令

命令 描述
码头工人堆栈 管理Docker堆栈
命令 描述
码头工人栈部署 部署新堆栈或更新现有堆栈
码头工人堆栈ls 列表栈
码头工人堆栈ps 列出堆栈中的任务
码头工人栈rm 移除一个或多个堆栈
码头工人栈服务 列出堆栈中的服务