docker inspect

描述	返回 Docker 对象的底层信息
用法	`docker inspect [OPTIONS] NAME\|ID [NAME\|ID...]`

描述

Docker inspect 提供 Docker 控制的构造的详细信息。

默认情况下，docker inspect 将以 JSON 数组的形式呈现结果。

选项

选项	默认值	描述
`-f, --format`		使用自定义模板格式化输出 'json': 以 JSON 格式打印 'TEMPLATE': 使用给定的 Go 模板打印输出。有关使用模板格式化输出的更多信息，请参阅https://docs.container.net.cn/go/formatting/
`-s, --size`		如果类型是容器，则显示总文件大小
`--type`		仅检查给定类型的对象

示例

格式化输出 (--format)

如果指定了格式，则将为每个结果执行给定的模板。

Go 的 text/template 包描述了格式的所有详细信息。

指定目标类型（--type）

docker inspect 命令通过 ID 或名称匹配任何类型的对象。在某些情况下，多个类型的对象（例如，容器和卷）具有相同的名称，导致结果模糊。

要将 docker inspect 限制为特定类型的对象，请使用 --type 选项。

以下示例检查名为 myvolume 的卷。

$ docker inspect --type=volume myvolume

检查容器的大小（-s, --size）

--size 或简写形式 -s 选项向 docker inspect 输出添加两个附加字段。此选项仅适用于容器。容器不必正在运行，它也适用于已停止的容器。

$ docker inspect --size mycontainer

输出包括常规 docker inspect 命令的完整输出，并包含以下附加字段

SizeRootFs：容器中所有文件的总大小，以字节为单位。
SizeRw：容器中已创建或更改的文件的大小（与其镜像相比），以字节为单位。

$ docker run --name database -d redis
3b2cbf074c99db4a0cad35966a9e24d7bc277f5565c17233386589029b7db273
$ docker inspect --size database -f '{{ .SizeRootFs }}'
123125760
$ docker inspect --size database -f '{{ .SizeRw }}'
8192
$ docker exec database fallocate -l 1000 /newfile
$ docker inspect --size database -f '{{ .SizeRw }}'
12288

获取实例的 IP 地址

在大多数情况下，您可以以相当直接的方式从 JSON 中挑选出任何字段。

$ 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='{{.Config.Image}}' $INSTANCE_ID

列出所有端口绑定

您可以在结果中循环遍历数组和映射以生成简单的文本输出

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

查找特定的端口映射

当字段名以数字开头时，.Field 语法不起作用，但模板语言的 index 函数可以。.NetworkSettings.Ports 部分包含内部端口映射到外部地址/端口对象列表的映射。要仅获取数字公共端口，您可以使用 index 查找特定的端口映射，然后 index 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