Docker命令行参考(4) – docker inspect显示容器或镜像相关信息

Usage:  docker inspect [OPTIONS] CONTAINER|IMAGE|TASK [CONTAINER|IMAGE|TASK...]
 
Return low-level information on a container, image or task
 
  -f, --format       Format the output using the given go template
  --help             Print usage
  -s, --size         Display total file sizes if the type is container
                     values are "image" or "container" or "task"
  --type             Return JSON for specified type, (e.g image, container or task)

默认情况下，以JSON数组格式输出所有结果。如果容器和镜像有相同的名称，当没有指定类型时将返回容器的JSON信息。如果指定了格式，给定的模式将格式化每个结果。
Go’s text/template描述了这个格式的所有细节。

示例

大多数情况，可以非常简单地从JSON取任何的字段。

获取实例IP地址

$ docker inspect --format='{{range .NetworkSettings.Networks}}{{.IPAddress}}{{end}}' $INSTANCE_ID

获取实例MAC地址

$ docker inspect --format='{{range .NetworkSettings.Networks}}{{.MacAddress}}{{end}}' $INSTANCE_ID

获取实例日志路径

$ docker inspect --format='{{.LogPath}}' $INSTANCE_ID

获取任务镜像名称

$ docker inspect --format='{{.Container.Spec.Image}}' $INSTANCE_ID

列出所有绑定的端口

可以在结果中循环数组和映射以产生简单的文本输出：

$ docker inspect --format='{{range $p, $conf := .NetworkSettings.Ports}} {{$p}} -> {{(index $conf 0).HostPort}} {{end}}' $INSTANCE_ID

查找一个指定的端口映射

当字段名以一个数字开头时，.Field语法就失效了，不过可以用模板语言的index函数实现。.NetworkSettings.Ports区块包含内部端口映射到外部地址/端口对象列表的映射。要获取数字公共端口，可以使用索引查找特定端口映射，然后索引0包含其中的第一个对象。 然后我们要求HostPort字段获取公共地址。

$ docker inspect --format='{{(index (index .NetworkSettings.Ports "8787/tcp") 0).HostPort}}' $INSTANCE_ID

获取JSON格式的子区块

如果请求一个字段本身是一个包含其他字段的结构，默认情况下你会得到内部值的Go样式转储。Docker添加了一个模板函数json，它可以应用于以JSON格式获取结果。

$ docker inspect --format='{{json .Config}}' $INSTANCE_ID