码头工人服务检查

描述

显示一项或多项服务的详细信息

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

Swarm此命令与Swarm协调器一起使用。

用法

$ docker service inspect [OPTIONS] SERVICE [SERVICE...]

扩展说明

检查指定的服务。

默认情况下，这会将所有结果呈现在JSON数组中。如果指定了格式，则将为每个结果执行给定的模板。

Go的文本/模板包描述了格式的所有细节。

笔记

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

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

选项

名称，简写 默认 描述
--format ， -f 使用给定的Go模板格式化输出
--pretty 以人类友好的格式打印信息

例子

通过名称或ID检查服务

您可以通过名称或ID来检查服务

例如，给予以下服务；

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

这两种docker service inspect redis，而docker 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:3.0.6"
        },
        "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选项，以人类可读的格式而不是默认的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选项可用于获取有关服务的特定信息。例如，以下命令输出“ redis”服务的副本数。

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

10

上级命令

命令 描述
码头工人服务 管理服务
命令 描述
docker服务创建 创建一个新服务
码头工人服务检查 显示一项或多项服务的详细信息
码头工人服务日志 提取服务或任务的日志
码头工人服务ls 列出服务
码头工人服务ps 列出一项或多项服务的任务
码头工人服务 删除一项或多项服务
docker服务回滚 将更改还原到服务的配置
码头工人服务规模 扩展一个或多个复制服务
码头工人服务更新 更新服务