docker service inspect
| Descripción | Muestra información detallada sobre uno o más servicios |
|---|---|
| Uso | docker service inspect [OPTIONS] SERVICE [SERVICE...] |
Swarm Este comando funciona con el orquestador de Swarm.
Descripción
Inspecciona el servicio especificado.
Por defecto, este comando muestra todos los resultados en una matriz JSON. Si se especifica un formato, la plantilla dada se ejecutará para cada resultado.
El paquete text/template de Go describe todos los detalles del formato.
NoteEste es un comando de gestión de clústeres y debe ejecutarse en un nodo administrador de Swarm (manager node). Para obtener más información sobre administradores y trabajadores, consulta la sección del modo Swarm en la documentación.
Opciones
| Opción | Predeterminado | Descripción |
|---|---|---|
-f, --format | Da formato a la salida utilizando una plantilla personalizada: 'json': Imprime en formato JSON 'TEMPLATE': Imprime la salida utilizando la plantilla Go especificada. Consulta https://docs-docker.esdocu.com/go/formatting/ para obtener más información sobre cómo dar formato a la salida con plantillas | |
--pretty | Imprime la información en un formato legible para humanos |
Ejemplos
Inspeccionar un servicio por nombre o ID
Puedes inspeccionar un servicio, ya sea por su nombre o por su ID.
Por ejemplo, dado el siguiente servicio:
$ docker service ls
ID NAME MODE REPLICAS IMAGE
dmu1ept4cxcf redis replicated 3/3 redis:7.4.1
Tanto docker service inspect redis como docker service inspect dmu1ept4cxcf
producen el mismo resultado:
$ docker service inspect redis
La salida está en formato JSON, por ejemplo:
[
{
"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
}
},
"Mode": {
"Replicated": {
"Replicas": 1
}
},
"UpdateConfig": {},
"EndpointSpec": {
"Mode": "vip"
}
},
"Endpoint": {
"Spec": {}
}
}
]$ docker service inspect dmu1ept4cxcf
[
{
"ID": "dmu1ept4cxcfe8k8lhtux3ro3",
"Version": {
"Index": 12
},
...
}
]
Dar formato legible (--pretty)
Puedes imprimir la salida de la inspección en un formato legible para humanos en lugar de la salida
JSON predeterminada, utilizando la opción --pretty:
$ 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
También puedes utilizar --format pretty para obtener el mismo efecto.
Dar formato a la salida (--format)
La opción --format se puede utilizar para obtener información específica sobre un
servicio. Por ejemplo, el siguiente comando muestra el número de réplicas
del servicio "redis".
$ docker service inspect --format='{{.Spec.Mode.Replicated.Replicas}}' redis
10