mirror of https://github.com/docker/cli.git
324 lines
9.6 KiB
Markdown
324 lines
9.6 KiB
Markdown
% DOCKER(1) Docker User Manuals
|
|
% Docker Community
|
|
% JUNE 2014
|
|
# NAME
|
|
docker-inspect - Return low-level information on a container or image
|
|
|
|
# SYNOPSIS
|
|
**docker inspect**
|
|
[**--help**]
|
|
[**-f**|**--format**[=*FORMAT*]]
|
|
[**-s**|**--size**]
|
|
[**--type**=*container*|*image*]
|
|
CONTAINER|IMAGE [CONTAINER|IMAGE...]
|
|
|
|
# DESCRIPTION
|
|
|
|
This displays all the information available in Docker for a given
|
|
container or image. By default, this will render all results in a JSON
|
|
array. If the container and image have the same name, this will return
|
|
container JSON for unspecified type. If a format is specified, the given
|
|
template will be executed for each result.
|
|
|
|
# OPTIONS
|
|
**--help**
|
|
Print usage statement
|
|
|
|
**-f**, **--format**=""
|
|
Format the output using the given Go template.
|
|
|
|
**-s**, **--size**
|
|
Display total file sizes if the type is container.
|
|
|
|
**--type**="*container*|*image*"
|
|
Return JSON for specified type, permissible values are "image" or "container"
|
|
|
|
# EXAMPLES
|
|
|
|
Get information about an image when image name conflicts with the container name,
|
|
e.g. both image and container are named rhel7:
|
|
|
|
$ docker inspect --type=image rhel7
|
|
[
|
|
{
|
|
"Id": "fe01a428b9d9de35d29531e9994157978e8c48fa693e1bf1d221dffbbb67b170",
|
|
"Parent": "10acc31def5d6f249b548e01e8ffbaccfd61af0240c17315a7ad393d022c5ca2",
|
|
....
|
|
}
|
|
]
|
|
|
|
## Getting information on a container
|
|
|
|
To get information on a container use its ID or instance name:
|
|
|
|
$ docker inspect d2cc496561d6
|
|
[{
|
|
"Id": "d2cc496561d6d520cbc0236b4ba88c362c446a7619992123f11c809cded25b47",
|
|
"Created": "2015-06-08T16:18:02.505155285Z",
|
|
"Path": "bash",
|
|
"Args": [],
|
|
"State": {
|
|
"Running": false,
|
|
"Paused": false,
|
|
"Restarting": false,
|
|
"OOMKilled": false,
|
|
"Dead": false,
|
|
"Pid": 0,
|
|
"ExitCode": 0,
|
|
"Error": "",
|
|
"StartedAt": "2015-06-08T16:18:03.643865954Z",
|
|
"FinishedAt": "2015-06-08T16:57:06.448552862Z"
|
|
},
|
|
"Image": "ded7cd95e059788f2586a51c275a4f151653779d6a7f4dad77c2bd34601d94e4",
|
|
"NetworkSettings": {
|
|
"Bridge": "",
|
|
"SandboxID": "6b4851d1903e16dd6a567bd526553a86664361f31036eaaa2f8454d6f4611f6f",
|
|
"HairpinMode": false,
|
|
"LinkLocalIPv6Address": "",
|
|
"LinkLocalIPv6PrefixLen": 0,
|
|
"Ports": {},
|
|
"SandboxKey": "/var/run/docker/netns/6b4851d1903e",
|
|
"SecondaryIPAddresses": null,
|
|
"SecondaryIPv6Addresses": null,
|
|
"EndpointID": "7587b82f0dada3656fda26588aee72630c6fab1536d36e394b2bfbcf898c971d",
|
|
"Gateway": "172.17.0.1",
|
|
"GlobalIPv6Address": "",
|
|
"GlobalIPv6PrefixLen": 0,
|
|
"IPAddress": "172.17.0.2",
|
|
"IPPrefixLen": 16,
|
|
"IPv6Gateway": "",
|
|
"MacAddress": "02:42:ac:12:00:02",
|
|
"Networks": {
|
|
"bridge": {
|
|
"NetworkID": "7ea29fc1412292a2d7bba362f9253545fecdfa8ce9a6e37dd10ba8bee7129812",
|
|
"EndpointID": "7587b82f0dada3656fda26588aee72630c6fab1536d36e394b2bfbcf898c971d",
|
|
"Gateway": "172.17.0.1",
|
|
"IPAddress": "172.17.0.2",
|
|
"IPPrefixLen": 16,
|
|
"IPv6Gateway": "",
|
|
"GlobalIPv6Address": "",
|
|
"GlobalIPv6PrefixLen": 0,
|
|
"MacAddress": "02:42:ac:12:00:02"
|
|
}
|
|
}
|
|
|
|
},
|
|
"ResolvConfPath": "/var/lib/docker/containers/d2cc496561d6d520cbc0236b4ba88c362c446a7619992123f11c809cded25b47/resolv.conf",
|
|
"HostnamePath": "/var/lib/docker/containers/d2cc496561d6d520cbc0236b4ba88c362c446a7619992123f11c809cded25b47/hostname",
|
|
"HostsPath": "/var/lib/docker/containers/d2cc496561d6d520cbc0236b4ba88c362c446a7619992123f11c809cded25b47/hosts",
|
|
"LogPath": "/var/lib/docker/containers/d2cc496561d6d520cbc0236b4ba88c362c446a7619992123f11c809cded25b47/d2cc496561d6d520cbc0236b4ba88c362c446a7619992123f11c809cded25b47-json.log",
|
|
"Name": "/adoring_wozniak",
|
|
"RestartCount": 0,
|
|
"Driver": "devicemapper",
|
|
"ExecDriver": "native-0.2",
|
|
"MountLabel": "",
|
|
"ProcessLabel": "",
|
|
"Mounts": [
|
|
{
|
|
"Source": "/data",
|
|
"Destination": "/data",
|
|
"Mode": "ro,Z",
|
|
"RW": false
|
|
"Propagation": ""
|
|
}
|
|
],
|
|
"AppArmorProfile": "",
|
|
"ExecIDs": null,
|
|
"HostConfig": {
|
|
"Binds": null,
|
|
"ContainerIDFile": "",
|
|
"Memory": 0,
|
|
"MemorySwap": 0,
|
|
"CpuShares": 0,
|
|
"CpuPeriod": 0,
|
|
"CpusetCpus": "",
|
|
"CpusetMems": "",
|
|
"CpuQuota": 0,
|
|
"BlkioWeight": 0,
|
|
"OomKillDisable": false,
|
|
"Privileged": false,
|
|
"PortBindings": {},
|
|
"Links": null,
|
|
"PublishAllPorts": false,
|
|
"Dns": null,
|
|
"DnsSearch": null,
|
|
"DnsOptions": null,
|
|
"ExtraHosts": null,
|
|
"VolumesFrom": null,
|
|
"Devices": [],
|
|
"NetworkMode": "bridge",
|
|
"IpcMode": "",
|
|
"PidMode": "",
|
|
"UTSMode": "",
|
|
"CapAdd": null,
|
|
"CapDrop": null,
|
|
"RestartPolicy": {
|
|
"Name": "no",
|
|
"MaximumRetryCount": 0
|
|
},
|
|
"SecurityOpt": null,
|
|
"ReadonlyRootfs": false,
|
|
"Ulimits": null,
|
|
"LogConfig": {
|
|
"Type": "json-file",
|
|
"Config": {}
|
|
},
|
|
"CgroupParent": ""
|
|
},
|
|
"GraphDriver": {
|
|
"Name": "devicemapper",
|
|
"Data": {
|
|
"DeviceId": "5",
|
|
"DeviceName": "docker-253:1-2763198-d2cc496561d6d520cbc0236b4ba88c362c446a7619992123f11c809cded25b47",
|
|
"DeviceSize": "171798691840"
|
|
}
|
|
},
|
|
"Config": {
|
|
"Hostname": "d2cc496561d6",
|
|
"Domainname": "",
|
|
"User": "",
|
|
"AttachStdin": true,
|
|
"AttachStdout": true,
|
|
"AttachStderr": true,
|
|
"ExposedPorts": null,
|
|
"Tty": true,
|
|
"OpenStdin": true,
|
|
"StdinOnce": true,
|
|
"Env": null,
|
|
"Cmd": [
|
|
"bash"
|
|
],
|
|
"Image": "fedora",
|
|
"Volumes": null,
|
|
"VolumeDriver": "",
|
|
"WorkingDir": "",
|
|
"Entrypoint": null,
|
|
"NetworkDisabled": false,
|
|
"MacAddress": "",
|
|
"OnBuild": null,
|
|
"Labels": {},
|
|
"Memory": 0,
|
|
"MemorySwap": 0,
|
|
"CpuShares": 0,
|
|
"Cpuset": "",
|
|
"StopSignal": "SIGTERM"
|
|
}
|
|
}
|
|
]
|
|
## Getting the IP address of a container instance
|
|
|
|
To get the IP address of a container use:
|
|
|
|
$ docker inspect --format='{{range .NetworkSettings.Networks}}{{.IPAddress}}{{end}}' d2cc496561d6
|
|
172.17.0.2
|
|
|
|
## Listing all port bindings
|
|
|
|
One can loop over arrays and maps in the results to produce simple text
|
|
output:
|
|
|
|
$ docker inspect --format='{{range $p, $conf := .NetworkSettings.Ports}} \
|
|
{{$p}} -> {{(index $conf 0).HostPort}} {{end}}' d2cc496561d6
|
|
80/tcp -> 80
|
|
|
|
You can get more information about how to write a Go template from:
|
|
https://golang.org/pkg/text/template/.
|
|
|
|
## Getting size information on an container
|
|
|
|
$ docker inspect -s d2cc496561d6
|
|
[
|
|
{
|
|
....
|
|
"SizeRw": 0,
|
|
"SizeRootFs": 972,
|
|
....
|
|
}
|
|
]
|
|
|
|
## Getting information on an image
|
|
|
|
Use an image's ID or name (e.g., repository/name[:tag]) to get information
|
|
about the image:
|
|
|
|
$ docker inspect ded7cd95e059
|
|
[{
|
|
"Id": "ded7cd95e059788f2586a51c275a4f151653779d6a7f4dad77c2bd34601d94e4",
|
|
"Parent": "48ecf305d2cf7046c1f5f8fcbcd4994403173441d4a7f125b1bb0ceead9de731",
|
|
"Comment": "",
|
|
"Created": "2015-05-27T16:58:22.937503085Z",
|
|
"Container": "76cf7f67d83a7a047454b33007d03e32a8f474ad332c3a03c94537edd22b312b",
|
|
"ContainerConfig": {
|
|
"Hostname": "76cf7f67d83a",
|
|
"Domainname": "",
|
|
"User": "",
|
|
"AttachStdin": false,
|
|
"AttachStdout": false,
|
|
"AttachStderr": false,
|
|
"ExposedPorts": null,
|
|
"Tty": false,
|
|
"OpenStdin": false,
|
|
"StdinOnce": false,
|
|
"Env": null,
|
|
"Cmd": [
|
|
"/bin/sh",
|
|
"-c",
|
|
"#(nop) ADD file:4be46382bcf2b095fcb9fe8334206b584eff60bb3fad8178cbd97697fcb2ea83 in /"
|
|
],
|
|
"Image": "48ecf305d2cf7046c1f5f8fcbcd4994403173441d4a7f125b1bb0ceead9de731",
|
|
"Volumes": null,
|
|
"VolumeDriver": "",
|
|
"WorkingDir": "",
|
|
"Entrypoint": null,
|
|
"NetworkDisabled": false,
|
|
"MacAddress": "",
|
|
"OnBuild": null,
|
|
"Labels": {}
|
|
},
|
|
"DockerVersion": "1.6.0",
|
|
"Author": "Lokesh Mandvekar \u003clsm5@fedoraproject.org\u003e",
|
|
"Config": {
|
|
"Hostname": "76cf7f67d83a",
|
|
"Domainname": "",
|
|
"User": "",
|
|
"AttachStdin": false,
|
|
"AttachStdout": false,
|
|
"AttachStderr": false,
|
|
"ExposedPorts": null,
|
|
"Tty": false,
|
|
"OpenStdin": false,
|
|
"StdinOnce": false,
|
|
"Env": null,
|
|
"Cmd": null,
|
|
"Image": "48ecf305d2cf7046c1f5f8fcbcd4994403173441d4a7f125b1bb0ceead9de731",
|
|
"Volumes": null,
|
|
"VolumeDriver": "",
|
|
"WorkingDir": "",
|
|
"Entrypoint": null,
|
|
"NetworkDisabled": false,
|
|
"MacAddress": "",
|
|
"OnBuild": null,
|
|
"Labels": {}
|
|
},
|
|
"Architecture": "amd64",
|
|
"Os": "linux",
|
|
"Size": 186507296,
|
|
"VirtualSize": 186507296,
|
|
"GraphDriver": {
|
|
"Name": "devicemapper",
|
|
"Data": {
|
|
"DeviceId": "3",
|
|
"DeviceName": "docker-253:1-2763198-ded7cd95e059788f2586a51c275a4f151653779d6a7f4dad77c2bd34601d94e4",
|
|
"DeviceSize": "171798691840"
|
|
}
|
|
}
|
|
}
|
|
]
|
|
|
|
# HISTORY
|
|
April 2014, originally compiled by William Henry (whenry at redhat dot com)
|
|
based on docker.com source material and internal work.
|
|
June 2014, updated by Sven Dowideit <SvenDowideit@home.org.au>
|
|
April 2015, updated by Qiang Huang <h.huangqiang@huawei.com>
|
|
October 2015, updated by Sally O'Malley <somalley@redhat.com>
|