reinlinsen
👀
rl is a tool to inspect and dump OCI images or single image layers.
Installation
From source
If you have cargo installed you can just run the following. Make sure that you have added Cargo's bin directory (e.g. ~/.cargo/bin) to your PATH.
cargo install --git https://github.com/brumhard/reinlinsen.git --tag latest
Released binaries/packages
Download the desired version for your operating system and processor architecture from the releases. Make the file executable and place it in a directory available in your $PATH.
Use with nix
nix run github:brumhard/reinlinsen/latest
or
{
inputs.reinlinsen.url = "github:brumhard/reinlinsen/latest";
outputs = { reinlinsen, ... }: {
packages.x86_64-linux = [reinlinsen.packages.x86_64-linux.rl];
};
}
Homebrew
brew install brumhard/tap/reinlinsen
Features
rl dump <image> -o <dir> # full dump of all layers
rl extract <image> -p <src> -o <dest> # extract a file or dir from the full dump
rl layer ls <image> # list all image layers
rl layer inspect <image> -l <layer> # show image layer's files
rl layer dump <image> -l <layer> -o <dir> # dump only this layer
rl layer dump <image> -l <layer> -o <dir> --stack # include preceding layers into the output
rl layer extract <image> -l <layer> -p <src> -o <dest> # extract a file or dir from the layer
Example
$ docker pull alpine
Using default tag: latest
latest: Pulling from library/alpine
08409d417260: Pull complete
Digest: sha256:02bb6f428431fbc2809c5d1b41eab5a68350194fb508869a33cb1af4444c9b11
Status: Downloaded newer image for alpine:latest
docker.io/library/alpine:latest
$ rl dump alpine -o alpine
$ tree -L 1 alpine
alpine
├── bin
├── dev
├── etc
├── home
├── lib
├── media
├── mnt
├── opt
├── proc
├── root
├── run
├── sbin
├── srv
├── sys
├── tmp
├── usr
└── var
$ file alpine/bin/busybox
alpine/bin/busybox: ELF 64-bit LSB pie executable, ARM aarch64, version 1 (SYSV), dynamically linked, interpreter /lib/ld-musl-aarch64.so.1, stripped
657 Dec 30, 2022
45 Dec 29, 2022
58 Dec 30, 2022
39 Dec 6, 2022
1.8k Jan 8, 2023
1.9k Jan 4, 2023
1.4k Dec 27, 2022
12 Mar 10, 2022
1.1k Jan 6, 2023
23 Dec 3, 2022
51 Jan 2, 2023
10 Apr 4, 2023
53 Jul 3, 2023
2 Dec 8, 2022
143 Dec 22, 2022
8 Sep 16, 2022
3 Sep 17, 2022
11 Oct 6, 2022
9.9k Jan 5, 2023
175 Dec 29, 2022
12 Sep 23, 2022
4.2k Dec 29, 2022
73 Jan 9, 2023
1.3k Jan 1, 2023
83 Nov 30, 2022
365 Dec 30, 2022
2.4k Dec 27, 2022