docker inspect 操作详解

一、功能介绍

二、参数说明

三、docker inspect -f 更多用法

四、参考文档

docker inspect 会以 json 格式得到 docker 镜像/容器的元数据。

如下，查看mysql镜像的完整元数据：

如下为以mysql:5.7启动的容器的完整元数据：

2.1、-f

通常我们需要获取某一个具体的key，会用grep，如下，grep会获取到其他的数据，不够完整或者有冗余，还得进一步处理，但是 -f 可以解决这个问题：

2.2、--type

指定具体类型 如：–type container 声明查看容器的元数据

2.3、-s

显示总的文件大小

简单地说，-f 的实参是个 Go 模版，并在容器/镜像的元数据上以该 Go 模版作为输入，最终返回模版指定的数据。Go 模版是一种模板引擎，让数据以指定的模式输出。这个概念对于 Web 开发者是非常熟悉的，Web 领域有很多模版引擎，比如 Jinga2（用于 Python 和 Flask）、Mustache、JSP 等等，看下面的简单示例:

3.1、Go 模版 详解

模版指令
{{ }} 语法用于处理模版指令，大括号外的任何字符都将直接输出。

上下文
“.” 表示“当前上下文”。大多数情况下表示了容器元数据的整个数据结构，但在某些情况下可以重新规定上下文，比如使用 with 函数：

$

可以使用 $ 来获取根上下文,只能获取一级key值

注意，单独使用 “.” 本身也是可以的，将输出未格式化的完整元数据：

3.2、数据类型

inspect 数据可以由浮点数、字符串和布尔组成，可以使用 Go 模版内置函数进行比较判断。虽然 Go 模版支持整数，但目前 inspect 数据中的数值类型都是浮点数，而整数应该对于大多数场景更方便（详见该Issue）。使用字符串时可以使用双引号。

数据中不存在的值是不可以用来比较的：

3.3、数据结构

inspect 数据使用 map 以及数组保存。Map 结构可以通过 . 的链式来访问 map 内部数据：

3.3.1、如果需要获取的属性名称包含 “/”（比如下列示例数据）或者以数字开头，则不能直接通过级联调用获取信息。因为属性名称中的点号会被解析成级联信息，进而导致返回错误结果。即便使用引号将其包含也会提示语法格式错误。此时，需要通过 index 来读取指定属性信息。前面卷的例子可以这样写：

3.3.2、如果返回结果是一个 map, slice, array 或 string，则可以使用 index 加索引序号（从零开始计数）来读取属性值

3.4、函数

除了 index 函数，其他很多函数也很常用。比如逻辑函数 and、or 可以返回布尔结果。注意，函数是不能放在中间：

下面是一些常用的比较函数：

eq (等于)
ne (不等于)
lt (小于)
le (小于等于)
gt (大于)
ge (大于等于)

我们可以用这些函数来比较字符串、浮点数或整数：

要注意的是操作数类型必须匹配，数字比较时也需要类型匹配：

比较特殊的是，它支持多个参数进行与比较，此时，它会将第一个参数和其余参数依次比较，返回下式的结果：

{{if eq true .Var1 .Var2 .Var3}}{{end}}
# 效果等同于：
arg1==arg2 || arg1==arg3 || arg1==arg4

另外，可以使用 json 函数来生成 JSON 输出：

docker inspect -f '{{json .NetworkSettings.Ports}}' 492c91fb2b8ff1a334fcd64ba3e46585701e7e5809f564bc2c65f3a655458db3
{"3306/tcp":null,"33060/tcp":null}

3.5、if 语句

条件语句 if 可以和前面的比较函数一起使用：

优化显示后为：

注意，{{end}} 语句必须有，else if 和 else 按需使用。

3.6、range迭代数据

range 用于遍历结构内返回值的所有数据。支持的类型包括 array, slice, map 和 channel。使用要点：

对应的值长度为 0 时，range 不会执行。
结构内部如要使用外部的变量，需要在前面加 引用，比如Var2。
range 也支持 else 操作。效果是：当返回值为空或长度为 0 时执行 else 内的内容。

3.7、打印信息

docker --format 默认调用 go语言的 print 函数对模板中的字符串进行输出。而 go语言还有另外几种相似的内置函数，对比说明如下：

print： 将传入的对象转换为字符串并写入到标准输出中。如果后跟多个参数，输出结果之间会自动填充空格进行分隔。
println: 功能和 print 类似，但会在结尾添加一个换行符。也可以直接使用 {{println}} 来换行。
printf: 与 shell 等环境一致，可配合占位符用于格式化输出。

3.8、管道

管道 即 pipeline ，与 shell 中类似，可以是上下文的变量输出，也可以是函数通过管道传递的返回值。

3.9、Docker内置函数

3.9.1、 json

Docker 默认以字符串显示返回结果。而该函数可以将结果格式化为压缩后的 json 格式数据。

3.9.2、 join

用指定的字符串将返回结果连接后一起展示。操作对象必须是字符串数组

3.9.3、 lower

将返回结果中的字母全部转换为小写。操作对象必须是字符串。

3.9.4、upper

将返回结果中的字母全部转换为大写。操作对象必须是字符串。

3.9.5、 title

将返回结果的首字母转换为大写。操作对象必须是字符串，而且不能是纯数字。

3.9.6、split

使用指定分隔符将返回结果拆分为字符串列表。操作对象必须是字符串且不能是纯数字。同时，字符串中必须包含相应的分隔符，否则会直接忽略操作。

3.10、常用docker inspect --format 输出示例

1、https://blog.csdn.net/u013288190/article/details/108955218

2、https://blog.csdn.net/m0_45406092/article/details/103671832

3、https://ld246.com/article/1427784659823

到此这篇关于docker inspect 详解的文章就介绍到这了,更多相关docker inspect内容请搜索软件开发网以前的文章或继续浏览下面的相关文章希望大家以后多多支持软件开发网！

Docker