查看服务详情

描述显示一个或多个服务的详细信息
用法docker service inspect [OPTIONS] SERVICE [SERVICE...]

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

描述

检查指定的服务。

默认情况下,这会以 JSON 数组形式呈现所有结果。如果指定了格式, 则会对每个结果执行给定的模板。

Go语言的 text/template 包 详细描述了该格式的所有细节。

注意

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

选项

选项默认描述
-f, --format使用自定义模板格式化输出:
'json': 以 JSON 格式打印
'TEMPLATE': 使用给定的 Go 模板打印输出。
参考https://docs.docker.com/go/formatting/有关使用模板格式化输出的更多信息
--pretty以人类友好的格式打印信息

示例

根据名称或ID查看服务

您可以检查服务,通过其名称ID

例如,给定以下服务;

$ docker service ls
ID            NAME   MODE        REPLICAS  IMAGE
dmu1ept4cxcf  redis  replicated  3/3       redis:7.4.1

docker service inspect redisdocker service inspect dmu1ept4cxcf 都会产生相同的结果:

$ docker service inspect redis

输出为 JSON 格式,例如:

[
  {
    "ID": "dmu1ept4cxcfe8k8lhtux3ro3",
    "Version": {
      "Index": 12
    },
    "CreatedAt": "2016-06-17T18:44:02.558012087Z",
    "UpdatedAt": "2016-06-17T18:44:02.558012087Z",
    "Spec": {
      "Name": "redis",
      "TaskTemplate": {
        "ContainerSpec": {
          "Image": "redis:7.4.1"
        },
        "Resources": {
          "Limits": {},
          "Reservations": {}
        },
        "RestartPolicy": {
          "Condition": "any",
          "MaxAttempts": 0
        },
        "Placement": {}
      },
      "Mode": {
        "Replicated": {
          "Replicas": 1
        }
      },
      "UpdateConfig": {},
      "EndpointSpec": {
        "Mode": "vip"
      }
    },
    "Endpoint": {
      "Spec": {}
    }
  }
]
$ docker service inspect dmu1ept4cxcf

[
  {
    "ID": "dmu1ept4cxcfe8k8lhtux3ro3",
    "Version": {
      "Index": 12
    },
    ...
  }
]

格式化 (--pretty)

您可以使用 --pretty 选项以人类可读的格式打印 inspect 输出,而不是默认的 JSON 输出:

$ docker service inspect --pretty frontend

ID:     c8wgl7q4ndfd52ni6qftkvnnp
Name:   frontend
Labels:
 - org.example.projectname=demo-app
Service Mode:   REPLICATED
 Replicas:      5
Placement:
UpdateConfig:
 Parallelism:   0
 On failure:    pause
 Max failure ratio: 0
ContainerSpec:
 Image:     nginx:alpine
Resources:
Networks:   net1
Endpoint Mode:  vip
Ports:
 PublishedPort = 4443
  Protocol = tcp
  TargetPort = 443
  PublishMode = ingress

您也可以使用 --format pretty 来达到相同的效果。

格式化输出 (--format)

您可以使用 --format 选项来获取关于服务的特定信息。 --format 选项可用于获取关于服务的特定信息。 例如,以下命令输出 "redis" 服务的副本数量。

$ docker service inspect --format='{{.Spec.Mode.Replicated.Replicas}}' redis

10