Golang探索Docker镜像各层结构的工具插件dive的使用

简介

dive是一个用于探索Docker镜像、分析层内容并发现缩小Docker/OCI镜像大小方法的工具。

基本功能

• 按层显示Docker镜像内容：选择左侧的层时，右侧会显示该层与之前所有层组合的内容
• 指示每层的变化：显示文件树中已更改、修改、添加或删除的文件
• 估算"镜像效率"：左下角面板显示基本层信息和实验性指标，猜测镜像包含多少浪费空间
• 快速构建/分析周期：可以使用一个命令构建Docker镜像并立即分析
• CI集成：分析镜像并根据镜像效率和浪费空间获得通过/失败结果
• 支持多种镜像源和容器引擎：通过--source选项选择从何处获取容器镜像

安装方法

Ubuntu/Debian

DIVE_VERSION=$(curl -sL "https://api.github.com/repos/wagoodman/dive/releases/latest" | grep '"tag_name":' | sed -E 's/.*"v([^"]+)".*/\1/')
curl -fOL "https://github.com/wagoodman/dive/releases/download/v${DIVE_VERSION}/dive_${DIVE_VERSION}_linux_amd64.deb"
sudo apt install ./dive_${DIVE_VERSION}_linux_amd64.deb

RHEL/Centos

DIVE_VERSION=$(curl -sL "https://api.github.com/repos/wagoodman/dive/releases/latest" | grep '"tag_name":' | sed -E 's/.*"v([^"]+)".*/\1/')
curl -fOL "https://github.com/wagoodman/dive/releases/download/v${DIVE_VERSION}/dive_${DIVE_VERSION}_linux_amd64.rpm"
rpm -i dive_${DIVE_VERSION}_linux_amd64.rpm

Mac (使用Homebrew)

brew install dive

Windows (使用Chocolatey)

choco install dive

Go工具安装

go install github.com/wagoodman/dive@latest

Docker方式

docker pull docker.io/wagoodman/dive
# 或
docker pull ghcr.io/wagoodman/dive

使用示例

分析现有镜像

dive <your-image-tag>
# 例如
dive nginx:latest

使用Docker直接运行

alias dive="docker run -ti --rm -v /var/run/docker.sock:/var/run/docker.sock docker.io/wagoodman/dive"
dive <your-image-tag>

构建镜像并立即分析

dive build -t <some-tag> .

在macOS上构建

docker run --rm -it \
      -v /var/run/docker.sock:/var/run/docker.sock \
      -v "$(pwd)":"$(pwd)" \
      -w "$(pwd)" \
      -v "$HOME/.dive.yaml":"$HOME/.dive.yaml" \
      docker.io/wagoodman/dive:latest build -t <some-tag> .

CI集成

CI=true dive <your-image>

CI配置示例

创建一个.dive-ci文件放在项目根目录：

rules:
  # 如果效率低于X%，标记为失败 (0-1之间的比率)
  lowestEfficiency: 0.95

  # 如果浪费空间大于等于X，标记为失败 (可用B, KB, MB, GB表示)
  highestWastedBytes: 20MB

  # 如果浪费空间占镜像的X%或更多，标记为失败 (0-1之间的比率)
  highestUserWastedPercent: 0.20

键绑定

UI配置示例

创建配置文件~/.dive.yaml：

container-engine: docker
ignore-errors: false
log:
  enabled: true
  path: ./dive.log
  level: info

keybinding:
  quit: ctrl+c
  toggle-view: tab
  filter-files: ctrl+f, ctrl+slash
  close-filter-files: esc
  up: up,k
  down: down,j
  left: left,h
  right: right,l

diff:
  hide:
    - added
    - removed
    - modified
    - unmodified

filetree:
  collapse-dir: false
  pane-width: 0.5
  show-attributes: true

layer:
  show-aggregated-changes: false

dive会按以下顺序查找配置文件：

1. $XDG_CONFIG_HOME/dive/*.yaml
2. $XDG_CONFIG_DIRS/dive/*.yaml
3. ~/.config/dive/*.yaml
4. ~/.dive.yaml

也可以使用.yml扩展名代替.yaml。