Docker检查

描述返回 Docker 对象的低级信息
用法docker inspect [OPTIONS] NAME|ID [NAME|ID...]

描述

Docker 检查提供有关 Docker 控制的构造的详细信息。

默认情况下，docker inspect将在 JSON 数组中呈现结果。

格式化输出（--format）

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

Go 的 文本/模板包描述了格式的所有细节。

指定目标类型（--type）

--type container|image|node|network|secret|service|volume|task|plugin

该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

选项

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

例子

获取实例的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查找特定的端口映射，然后index0 包含其中的第一个对象。然后，指定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