美文网首页
docker inspect -f 模版

docker inspect -f 模版

作者: 哪个鹿 | 来源:发表于2019-07-18 14:30 被阅读0次

    docker inspect

    • 获取容器/镜像的元数据
    * 参数:
    -f:指定返回值的模板文件,即--format
    -s:显示总的文件大小
    --type: 为指定类型返回JSON
    
    1. 你可以直接使用docker inspect name(容器名/镜像名)
    $ docker inspect mongo1
    [
        {
            "Id": "702a8e06cd3f4bc44611d8ecd4b073f6ab4b22eb8946b1c79441983ee446d64d",
            "Created": "2018-10-29T08:40:57.6386473Z",
            "Args": [
                "mongod"
            ],
            "State": {
                "Status": "running",
                "Running": true,
                "Paused": false,
                "Restarting": false,
                "OOMKilled": false,
                "Dead": false,
                "Pid": 2512,
                "ExitCode": 0,
                "Error": "",
                "StartedAt": "2019-06-28T09:28:08.8050078Z",
                "FinishedAt": "2019-03-27T09:07:28.949500661Z"
            },
            "Image": "sha256:05b3651ee24e6bbe59d646afd06aa4d37b86e5ad5f91ce2f200d22cef5c722c0",
            "Name": "/mongo1",
    ... ... ...
    
    1. 或者使用参数,比如加上-f
    • -f 的实参是go模版,用法如下:
    * 查看所有容器(包括未运行)的容器状态
    docker inspect -f '{{.State.Status}}' $(docker ps -aq)
    docker inspect --format='{{.State.Status}}' $(docker ps -aq)
    * 可以通过级联调用直接读取子对象 State 的 Status 属性,以获取容器的状态信息:
    docker inspect --format '{{/*读取容器状态*/}}{{.State.Status}}' $INSTANCE_ID   
    
    • {{}}模版指令:
      大括号内处理模版指令,大括号外的任何字符都将直接输出。
    • 注释
      {{/注释内容/}}
    • 上下文
      “.” 表示“当前上下文”。大多数情况下表示了容器元数据的整个数据结构,但在某些情况下可以重新规定上下文,比如使用 with 函数:
    $ docker inspect -f '{{.State.Pid}}' jenkins
    6331
    $ docker inspect -f '{{with .State}} {{.Pid}} {{end}}' jenkins
    6331
    

    可以使用 $ 来获取根上下文,例如:

    $ docker inspect -f '{{with .State}} {{$.Name}} has pid {{.Pid}} {{end}}' jenkins
     /jenkins has pid 6331
    
    • 数据类型
      inspect 数据可以由浮点数、字符串和布尔组成,可以使用 Go 模版内置函数进行比较判断。虽然 Go 模版支持整数,但目前 inspect 数据中的数值类型都是浮点数,而整数应该对于大多数场景更方便。使用字符串时可以使用双引号。数据中不存在的值是不可以用来比较的。
    • 数据结构
      inspect 数据使用 map 以及数组保存。Map 结构非常简单,前面我们曾经展示过,可以通过 . 的链式来访问 map 内部数据:
    $ docker inspect -f '{{.State.ExitCode}}' jenkins
    0
    

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

    """"Options": {
                "com.docker.network.bridge.default_bridge": "true",
                "com.docker.network.bridge.enable_icc": "true",
                "com.docker.network.bridge.enable_ip_masquerade": "true",
                "com.docker.network.bridge.host_binding_ipv4": "0.0.0.0",
                "com.docker.network.bridge.name": "docker0",
                "com.docker.network.driver.mtu": "1500"
            },
    """
    * 直接级联调用会提示找不到数据:
    docker inspect --format '{{.Options.com.docker.network.driver.mtu}}' bridge
    <no value>
     
    * 用引号括起来会提示语法错误:
    docker inspect --format '{{.Options."com.docker.network.driver.mtu"}}' bridge
    Template parsing error: template: :1: bad character U+0022 '"'
     
    * 正确的用法,必须用 index 读取指定属性名称的属性值:
    docker inspect --format '{{/*读取网络在hosts上的名称*/}}{{index .Options "com.docker.network.bridge.name"}}' bridge
    
    • 索引: index
      如果返回结果是一个 map, slice, array 或 string,则可以使用 index 加索引序号(从零开始计数)来读取属性值。
    """
    # docker inspect $INSTANCE_ID 查看容器绑定的端口信息,其 Config 属性就是一个 Map,包含了所有子网信息。
    ...
     "IPAM": {
                "Driver": "default",
                "Options": null,
                "Config": [
                    {
                        "Subnet": "172.31.254.1/24",
                        "Gateway": "172.31.254.1"
                    }
                ]
            },           
    ...
    """
    * 通过索引序号读取默认网关
    docker inspect bridge --format '{{/*查看网络的默认网关*/}}{{(index .IPAM.Config 0).Gateway}}'
    $ docker inspect -f '{{.HostConfig.Binds}}' jenkins
    [/var/run/docker.sock:/var/run/docker.sock /usr/bin/docker:/usr/bin/docker]
    $ docker inspect -f '{{index .HostConfig.Binds 1}}' jenkins
    /usr/bin/docker:/usr/bin/docker
    
    • 判断:if … else … end
    {{if 判断条件 .Var1 .Var2}}{{end}}
    {{if pipeline}}{{end}}
    {{if pipeline}}{{else}}{{if pipeline}}{{end}}{{end}}
    {{if pipeline}}{{else if pipeline}}{{else}}{{end}}
    
    * 输出所有已停止的容器名称:
    docker inspect --format '{{if ne 0.0 .State.ExitCode}}{{.Name}}{{end}}' $(docker ps -aq)
    docker inspect --format '{{if ne 0.0 .State.ExitCode}}{{.Name}}{{else}}该容器还在运行{{end}}' $(docker ps -aq)
    docker inspect --format '{{if ne 0.0 .State.ExitCode}}{{.Name}}{{else if .}}该容器还在运行{{end}}' $(docker ps -aq)
     
    * 输出所有已停止或配置了 Restarting 策略的容器名称
    docker inspect --format '{{if ne 0.0 .State.ExitCode}}{{.Name}}{{else if eq .State.Restarting true}}容器{{.Name}}配置了Restarting策略.{{else}}{{end}}' $(docker ps -aq)
    
    

    除了 index 函数,其他很多函数也很常用。比如逻辑函数not、and 、 or 可以返回布尔结果。注意,函数是不能放在中间,是{{or x y}} 或 {{or x y z}},而不是{{x and y}}:

    * 如果容器的 restarting 设置为 false,则返回信息“容器没有配置重启策略”
    docker inspect --format '{{if not .State.Restarting}}容器没有配置重启策略{{end}}' $(docker ps -q)
    docker inspect --format '{{or .State.Status .State.Restarting}}' $INSTANCE_ID
    

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

    • eq (等于)
    • ne (不等于)
    • lt (小于)
    • le (小于等于)
    • gt (大于)
    • ge (大于等于)
      我们可以用这些函数来比较字符串、浮点数或整数,要注意的是操作数类型必须匹配,数字比较时使用浮点数:
    $ docker inspect -f '{{eq "4.5" 4.5}}' jenkins
    FATA[0000] template: :1:2: executing "" at <eq "4.5" 4.5>: error calling eq: incompatible types for comparison
    $ docker inspect -f '{{gt .State.Pid 1}}' jenkins
    FATA[0000] template: :1:2: executing "" at <gt .State.Pid 1>: error calling gt: incompatible types for comparison 
    $ docker inspect -f '{{gt .State.Pid 1.0}}' jenkins
    true
    

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

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

    另外,可以使用 json 函数来生成 JSON 输出:

    $ docker inspect -f '{{json .NetworkSettings.Ports}}' jenkins
    {"50000/tcp":null,"8080/tcp":[{"HostIp":"0.0.0.0","HostPort":"8080"}]}
    

    我们也可以使用 jq 工具来组合结果:

    $ docker inspect -f '{{json .State}}' jenkins-data | jq '.StartedAt'
    "2015-03-15T20:26:30.526796706Z"
    

    当然, docker inspect 的默认输出结果就是 JSON,所以下面这样也可以:

    $ docker inspect jenkins-data | jq '.[] | .State.StartedAt'
    "2015-03-15T20:26:30.526796706Z"
    
    • 自定义变量
      可以在处理过程中设置自定义变量,然后结合自定义变量做更复杂的处理。 如果自定义变量的返回值是对象,则可以通过点号进一步级联访问其属性。比如 {{$Myvar.Field1}}。
    * 结合变量的使用,对输出结果进行组装展现,以输出容器的所有绑定端口列表:
    docker inspect --format '{{/*通过变量组合展示容器绑定端口列表*/}}已绑定端口列表:{{println}}{{range $p,$conf := .NetworkSettings.Ports}}{{$p}} -> {{(index $conf 0).HostPort}}{{println}}{{end}}' Web_web_1
    
    已绑定端口列表:
    80/tcp -> 32770
    8081/tcp -> 8081
    
    • range迭代数据
      range 用于遍历结构内返回值的所有数据。支持的类型包括 array, slice, map 和 channel。使用要点:
    1. 对应的值长度为 0 时,range 不会执行。
    2. 结构内部如要使用外部的变量,需要在前面加 引用,比如Var2。
    3. range 也支持 else 操作。效果是:当返回值为空或长度为 0 时执行 else 内的内容。
    {{range pipeline}}{{.}}{{end}}
    {{range pipeline}}{{.}}{{else}}{{.}}{{end}}
    
    * 查看容器网络下已挂载的所有容器名称,如果没有挂载任何容器,则输出 "With No Containers"
    docker inspect --format '{{range .Containers}}{{.Name}}{{println}}{{else}}With No Containers{{end}}' bridge
    brtest
    peaceful_brown
    test
     
    docker inspect --format '{{range .Containers}}{{.Name}}{{println}}{{else}}With No Containers{{end}}' none
    With No Containers
    
    • 打印信息
      docker --format 默认调用 go语言的 print 函数对模板中的字符串进行输出。而 go语言还有另外几种相似的内置函数,对比说明如下:
    1. print: 将传入的对象转换为字符串并写入到标准输出中。如果后跟多个参数,输出结果之间会自动填充空格进行分隔。
    2. println: 功能和 print 类似,但会在结尾添加一个换行符。也可以直接使用 {{println}} 来换行。
    3. printf: 与 shell 等环境一致,可配合占位符用于格式化输出。
    docker inspect --format '{{.State.Pid}}{{.State.ExitCode}}' $INSTANCE_ID
    240390
     
    docker inspect --format '{{print .State.Pid .State.ExitCode}}' $INSTANCE_ID
    24039 0
     
    docker inspect --format '{{.State.Pid}}{{println " 从这换行"}}{{.State.ExitCode}}' $INSTANCE_ID
    24039 从这换行
    0
     
    docker inspect --format '{{printf "Pid:%d ExitCode:%d" .State.Pid .State.ExitCode}}' $INSTANCE_ID
    Pid:24039 ExitCode:0
    
    • 管道
      管道 即 pipeline ,与 shell 中类似,可以是上下文的变量输出,也可以是函数通过管道传递的返回值。
    {{.Con | markdown | addlinks}}
    {{.Name | printf "%s"}}
    
    • 内置函数 len
      内置函数 len 返回相应对象的长度。
    docker inspect --format '{{len .Name}}' $INSTANCE_ID
    
    • Docker内置函数。
    1. json
      Docker 默认以字符串显示返回结果。而该函数可以将结果格式化为压缩后的 json 格式数据。
    # 获取 Config 字段对应的 json 数据
    docker inspect --format='{{json .Config}}' $INSTANCE_ID
    
    1. join
      用指定的字符串将返回结果连接后一起展示。操作对象必须是字符串数组。
    # 输出容器配置的所有 Entrypoint 参数,以 " , " 分隔:
    docker inspect --format '{{join .Config.Entrypoint " , "}}' $INSTANCE_ID
    
    1. lower
      将返回结果中的字母全部转换为小写。操作对象必须是字符串。
    docker inspect --format "{{lower .Name}}" $INSTANCE_ID
    
    1. upper
      将返回结果中的字母全部转换为大写。操作对象必须是字符串。
    docker inspect --format "{{upper .Name}}" $INSTANCE_ID
    
    1. title
      将返回结果的首字母转换为大写。操作对象必须是字符串,而且不能是纯数字。
    docker inspect --format "{{title .State.Status}}" $INSTANCE_ID
    
    1. split
      使用指定分隔符将返回结果拆分为字符串列表。操作对象必须是字符串且不能是纯数字。同时,字符串中必须包含相应的分隔符,否则会直接忽略操作。
    docker inspect --format '{{split .HostsPath "/"}}' $INSTANCE_ID
    
    • 常用docker inspect --format 输出示例

    $ docker ps
    CONTAINER ID        IMAGE                            COMMAND                  CREATED             STATUS              PORTS               NAMES
    2ed603e52896        172.16.60.214:5000/nginx   "/bin/sh -c '/usr/..."   13 minutes ago      Up 13 minutes                           docker-test111
    24e6607534f1        172.16.60.214:5000/nginx   "/bin/sh -c '/usr/..."   13 minutes ago      Up 13 minutes                           docker-test11
    19be6b264b6e        172.16.60.214:5000/nginx   "/bin/sh -c '/usr/..."   13 minutes ago      Up 13 minutes                           docker-test1
      
    1) 获取容器的IP (后面使用容器名或容器ID都可以)
    $ docker inspect --format='{{range .NetworkSettings.Networks}}{{.IPAddress}}{{end}}' $(docker ps -q)
    192.10.160.193
    173.20.19.128
    17.16.10.128
      
    $ docker inspect --format='{{range .NetworkSettings.Networks}}{{.IPAddress}}{{end}}' docker-test1
    17.16.10.128
      
    2) 获取容器的MAC地址
    $ docker inspect --format='{{range .NetworkSettings.Networks}}{{.MacAddress}}{{end}}' $(docker ps -a -q)
    ee:ee:ee:ee:ee:ee
    ee:ee:ee:ee:ee:ee
    ee:ee:ee:ee:ee:ee
      
    [root@node1 ~]# docker inspect --format='{{range .NetworkSettings.Networks}}{{.MacAddress}}{{end}}' docker-test1
    ee:ee:ee:ee:ee:ee
      
    3) 获取容器Name
    $ docker inspect --format='{{.Name}}' $(docker ps -aq)
    /docker-test111
    /docker-test11
    /docker-test1
    /calico-node
      
    $ docker inspect --format='{{.Name}}' $(docker ps -aq)|cut -d"/" -f2
    docker-test111
    docker-test11
    docker-test1
      
    $ docker inspect --format='{{.Name}}' docker-test1
    /docker-test1
      
    $ docker inspect --format='{{.Name}}' docker-test1|cut -d"/" -f2
    docker-test1
      
    4) 获取容器Hostname
    $ docker inspect --format '{{ .Config.Hostname }}' $(docker ps -q)
    2ed603e52896
    24e6607534f1
    19be6b264b6e
      
    $ docker inspect --format '{{ .Config.Hostname }}' docker-test1
    19be6b264b6e
      
    5) Hostname Name IP
    $ docker inspect --format 'Hostname:{{ .Config.Hostname }}  Name:{{.Name}} IP:{{range .NetworkSettings.Networks}}{{.IPAddress}}{{end}}' $(docker ps -q)
    Hostname:2ed603e52896  Name:/docker-test111 IP:192.10.160.193
    Hostname:24e6607534f1  Name:/docker-test11 IP:173.20.19.128
    Hostname:19be6b264b6e  Name:/docker-test1 IP:17.16.10.128
      
    $ docker inspect --format 'Hostname:{{ .Config.Hostname }}  Name:{{.Name}} IP:{{range .NetworkSettings.Networks}}{{.IPAddress}}{{end}}' docker-test1
    Hostname:19be6b264b6e  Name:/docker-test1 IP:17.16.10.128
      
    6) 获取容器的log path
    $ docker inspect --format='{{.LogPath}}' `docker ps -a -q`
    $ docker inspect --format='{{.LogPath}}' docker-test1
      
    7) 获取容器的image镜像名称
    $ docker inspect --format='{{.Config.Image}}' `docker ps -a -q`
    172.16.60.214:5000/nginx
    172.16.60.214:5000/nginx
    172.16.60.214:5000/nginx
    quay.io/calico/node:v2.6.10
    $ docker inspect --format='{{.Config.Image}}' docker-test1
    172.16.60.214:5000/nginx
      
    8) 获取容器绑定的端口(port bindings)
    $ docker inspect --format='{{range $p, $conf := .NetworkSettings.Ports}} {{$p}} -> {{(index $conf 0).HostPort}} {{end}}' `docker ps -a -q`
    $ docker inspect --format='{{range $p, $conf := .NetworkSettings.Ports}} {{$p}} -> {{(index $conf 0).HostPort}} {{end}}' docker-test1
     
    9) 获取service实例的Ip
    $ docker service ps my-test 
    ID              NAME          IMAGE                         NODE                    DESIRED   STATE  CURRENT STATE    ERROR  PORTS
    t71gqufekv2o  my-test.1  172.16.60.214:5000/nginx:latest  swarm-node2              Running    Running 16 seconds ago        
    9cuq2yf10d60 my-test.2  172.16.60.214:5000/nginx:latest  swarm-manager-node  Running   Running 16 seconds ago        
    srt2yo817kpv  my-test.3  172.16.60.214:5000/nginx:latest  swarm-node1               Running    Running 16 seconds ago  
     
    $ docker inspect ` docker service ps my-test -q` --format '{{range .NetworksAttachments}}{{.Addresses}}{{end}}' | cut -d '[' -f2|cut -d ']' -f1
    10.255.0.7/16
    10.255.0.8/16
    10.255.0.9/16
     
    10) 获取service示例的container ID  (获取的是ID的全称,一般只要取ID前面12个字符就可以了)
    $ docker inspect ` docker service ps my-test -q` --format '{{ .Status.ContainerStatus.ContainerID }}'
    c6c18a74a465163757fe928fec9e633223200f92d1c59e5d2d77eabfaa5ae93a
    5f558bb014ea3d3eef5c8d4bd70e2e3048d7fc6725538303be960ac658d93b32
    dde578bf60190a63ed5c8c4a9f5a3044566a159e8debe8717342e263c6199f26
    

    相关文章

      网友评论

          本文标题:docker inspect -f 模版

          本文链接:https://www.haomeiwen.com/subject/qsbklctx.html