https://github.com/vicanso/diving-rs

Exploring each layer in a docker image, it's fast and simple
https://github.com/vicanso/diving-rs

dive diving docker docker-image oci

Last synced: 3 months ago
JSON representation

Exploring each layer in a docker image, it's fast and simple

• Host: GitHub
• URL: https://github.com/vicanso/diving-rs
• Owner: vicanso
• License: apache-2.0
• Created: 2023-01-14T12:05:52.000Z (almost 2 years ago)
• Default Branch: main
• Last Pushed: 2024-04-05T01:02:26.000Z (7 months ago)
• Last Synced: 2024-04-09T22:28:27.578Z (7 months ago)
• Topics: dive, diving, docker, docker-image, oci
• Language: Rust
• Homepage: https://diving.npmtrend.com/
• Size: 1.6 MB
• Stars: 53
• Watchers: 3
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README-zh.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# diving-rs

用于展示docker镜像的每一层文件列表，它更快更简单，使用rust语言开发。它支持两种模式：命令行（默认模式）以及web模式，无需依赖任何东西，包括docker客户端。

`diving-rs`支持多个平台，包括：linux，windows，macos，可以在[release page](https://github.com/vicanso/diving-rs/releases)下载获取。

需要注意：由于镜像分层数据需要从镜像源下载，如docker hub，下载时长需要较长时间，如果超时则再次尝试即可，建议下载程序在本机执行。而对于私有化部署的镜像源，则可将diving的镜像部署运行在可访问镜像源的机器即可。

## config

默认配置文件为`~/.diving/config.yml`，其配置选项如下：

- `layer_path`: 分层数据缓存的目录，默认为`~/.diving/layers`

- `layer_ttl`: 分层数据缓存的有效期, 默认为`90d`，如果90天未再访问则该layer被清除

## terminal

镜像数据支持三种数据源模式，具体形式如下：

- `registry` 简写的形式为docker registry，私有或其它的registry则使用完整地址

- `docker` 基于本地安装了docker客户端的形式

- `file` 基于本地导出的tar包

```bash

diving redis:alpine

diving quay.io/prometheus/node-exporter

diving docker://redis:alpine

diving file:///tmp/redis.tar

CI=true diving redis:alpine

```

- `Current Layer Contents` 仅显示当前层的所有文件

- `Press 1` 仅显示当前`修改或删除` 的文件

- `Press 2` 仅显示当前层大于1MB的文件

- `Press Esc or 0` 重置显示模式 

![](./assets/diving-terminal.gif)

## web

```bash

docker run -d --restart=always \

  -p 7001:7001 \

  -v $PWD/diving:/home/rust/.diving \

  --name diving \

  vicanso/diving

```

需要注意，镜像非使用root运行，因此挂载的目录需要添加对应的读写权限，否则会启动失败。

在浏览器中打开`http://127.0.0.1:7001/`即可。

![](./assets/diving-web.png)