docker service inspect
描述 | 顯示一個或多個服務的詳細資訊 |
---|---|
用法 | docker service inspect [OPTIONS] SERVICE [SERVICE...] |
Swarm 此命令適用於 Swarm 編排器。
描述
檢查指定的服務。
預設情況下,這會將所有結果呈現為 JSON 陣列。如果指定了格式,則將為每個結果執行給定的模板。
Go 的 text/template 包描述了格式的所有詳細資訊。
注意這是一個叢集管理命令,必須在 Swarm 管理器節點上執行。要了解管理器和工作器,請參閱文件中的Swarm 模式部分。
選項
選項 | 預設值 | 描述 |
---|---|---|
-f, --format | 使用自定義模板格式化輸出 'json': 以 JSON 格式列印 'TEMPLATE': 使用給定的 Go 模板列印輸出。 有關使用模板格式化輸出的更多資訊,請參閱https://docs.docker.net.tw/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 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: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
選項,您可以以人類可讀的格式而不是預設的 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 選項獲取服務的特定資訊。例如,以下命令輸出“redis”服務的副本數量。
$ docker service inspect --format='{{.Spec.Mode.Replicated.Replicas}}' redis
10