Docker - 周边 - Go Template

1. 概述

   1. docker inspect -f 引出
   2. 希望学会后, 可以处理这个命令

2. 问题: 这是啥

   1. 疑问

      1. 最开始, 我以为是 jsonpath
      2. 后来看 命令行的解释, 说叫 go template
      3. 但是我查了查东西, 发现这俩玩意又是那么的相似

   2. 结果

      1. 这确实是 Go Template

1. Go Template

1. 概述

   1. go 语言的模板类库

2. 作用

   1. 类似 jsp, velocty, thymeleaf
      1. 预先定义模板
      2. 然后在通过变量渲染
      3. 最终得出所谓的 动态页面
   2. 但是这里, 貌似成为了一个 json 属性获取器
      1. 而且还是不那么好用的那种

2. docker inspect

1. 概述

   1. -f 参数, 支持 go template

2. 作用

   1. 以 整个 json 为 根元素
      1. 通过特定的语法, 获取特定位置的值

3. 问题

   1. 也不算是问题, 但是这样显示, 确实需要适应

      1. 查询的结果

         1. 值
            1. 显示单个值
         2. 数组
            1. 返回数组
            2. 中间以 ' ' 分割
         3. 字典/map
            1. 只返回 value
            2. 中间以 ' ' 分割
         4. 混合
            1. 同样只返回 value
            2. 中间以 ' ' 分割
         5. 嵌套
            1. 还是只返回 value
            2. 中间以 ' ' 分割

      2. 我不太喜欢这种方式

         1. 没有 ', ' 分割
         2. map 没有 key
         3. 但是不代表, 这个不合理
         4. 或者说
            1. 这个作为 模板类库, 是合理的
            2. 但是作为信息检索的工具, 有点不太合适

      3. 这个

         1. 熟练就好了
         2. 可以想办法克服
            1. 后面有 json 函数

3. 定位元素

1. 上下文

   1. 概述

      1. json 结果的 根元素

   2. 格式

      {{.}}
      {{$.}}
      

2. 字段

   1. 概述

      1. 提取结果里, 某个字段的值

   2. 格式

      # 单个值
      > docker image inspect -f '{{.Id}}' ubuntu
      sha256:7698f282e5242af2b9d2291458d4e425c75b25b0008c1e058d66b717b4c06fa9
      # 返回 字典属性
      # map 没有被正确还原
      > docker image inspect -f '{{.RootFS}}' ubuntu
      {layers [sha256:02571d034293cb241c078d7ecbf7a84b83a5df2508f11a91de26ec38eb6122f1 sha256:270f934787edf0135132b6780cead0f12ca11690c5d6a5d395e44d290912100a sha256:8d267010480fed7e616b9b7861854042aad4ef5e55f8771f2c738061640d2cb0] }
      

3. 层级

   1. 概述

      1. 可以取到 json 的深层

   2. 格式

      > docker image inspect -f '{{.RootFS.Type}}' ubuntu
      layers
      

4. index

   1. 概述

      1. 可以取到 json 中数组的 index

   2. 格式

      > docker image inspect -f '{{index .RootFS.Layers 0}}' ubuntu
      sha256:02571d034293cb241c078d7ecbf7a84b83a5df2508f11a91de26ec38eb6122f1o
      # 其实也可以直接取 元素
      # 字符串要加 引号
      > docker image inspect -f '{{index .RootFS "Type"}}' ubuntu
      layers
      

4. 布尔函数

1. eq

   1. 概述

      1. 比较两个元素是否相等
      2. 元素类型要相等

   2. 格式

      # 当然也可以比较 根元素下面的值
      > docker image inspect -f '{{eq 1 1}}' ubuntu
      true
      

2. ne

   1. 概述

      1. 比较两个元素是否不等
      2. 元素类型要相等

   2. 格式

      # 当然也可以比较 根元素下面的值
      > docker image inspect -f '{{ne 2 1}}' ubuntu
      

true

```

1. lt

   1. 概述

      1. 比较两个元素 a 和 b, a < b 是否成立
      2. 元素类型要相等

   2. 格式

      # 当然也可以比较 根元素下面的值
      > docker image inspect -f '{{lt 1 2}}' ubuntu
      true
      

2. le

   1. 概述

      1. 比较两个元素 a 和 b, a <= b 是否成立
      2. 元素类型要相等

   2. 格式

      # 当然也可以比较 根元素下面的值
      > docker image inspect -f '{{le 1 1}}' ubuntu
      true
      

3. gt

   1. 概述

      1. 比较两个元素 a 和 b, a > b 是否成立
      2. 元素类型要相等

   2. 格式

      # 当然也可以比较 根元素下面的值
      > docker image inspect -f '{{gt 2 1}}' ubuntu
      true
      

4. ge

   1. 概述

      1. 比较两个元素 a 和 b, a >= b 是否成立
      2. 元素类型要相等

   2. 格式

      # 当然也可以比较 根元素下面的值
      > docker image inspect -f '{{ge 1 1}}' ubuntu
      true
      

5. 打印函数

1. print

   1. 略
      1. go 的 print 函数, 我现在还没学, 学会了再补

2. printf

   1. 略
      1. go 的 print 函数, 我现在还没学, 学会了再补

3. println

   1. 略
      1. go 的 print 函数, 我现在还没学, 学会了再补

4. urlquery

   1. 略
      1. 这个真不会

5. json

   1. 概述

      1. 按 json 的格式, 展示 key 的 value

   2. 格式

      > docker image inspect -f '{{json .RootFS}}' ubuntu
      {"Type":"layers","Layers":["sha256:02571d034293cb241c078d7ecbf7a84b83a5df2508f11a91de26ec38eb6122f1","sha256:270f934787edf0135132b6780cead0f12ca11690c5d6a5d395e44d290912100a","sha256:8d267010480fed7e616b9b7861854042aad4ef5e55f8771f2c738061640d2cb0"]}
      

   3. 注意

      1. 这个命令只能处理 {} 元素

6. len

   1. 概述

      1. 返回内容的长度
         1. 内容是 集合 时, 返回 集合长度
         2. 内容是 字符串 时, 返回 字符串长度
         3. 内容是 数字 时, 返回 字数字长度

   2. 格式

      > docker image inspect -f '{{len .RootFS}}' ubuntu
      2
      > docker image inspect -f '{{len .RootFS.Type}}' ubuntu
      6
      

6. 逻辑函数

1. and

   1. 概述

      1. 做 逻辑与

   2. 格式

      > docker image inspect -f '{{and true true}}' ubuntu
      true
      

2. not

   1. 概述

      1. 做 逻辑非

   2. 格式

      > docker image inspect -f '{{and true true}}' ubuntu
      true
      

3. or

   1. 概述

      1. 返回内容的长度

   2. 格式

      > docker image inspect -f '{{and true true}}' ubuntu
      true
      

7. 结构

1. if

   1. 略

2. range

   1. 略

3. with

   1. 略

8. 打印

1. 概述

   1. 其实这个 {{}} 可以配合其他内容来打印

2. 格式

   # 配合 print 可以打印出各种效果
   > docker image inspect -f '你好 {{len .Size}}' ubuntu
   你好 8
   

ps

1. ref

   1. Docker Inspect

      1. 讲得还行
         1. 起码是有例子, 有细节
         2. 基础讲得还行

   2. golang模板语法使用说明

      1. 函数讲得还行

   3. 使用 JSONPath 解析 JSON 完整内容详解

      1. 给这个例子, 只是为了告诉你, go template 和 jsonpath 真的不是一个东西

   4. Go语言标准库之template

      1. 更加正式的描述 go template

2. 其他

   1. 结构部分 需要补上
   2. 打印 部分, 需要补上

3. 用处

   1. 老实说, 感觉其实用处, 也没那么大...