Dive – A tool for exploring each layer in a Docker image

by boyter • 8 years ago

684 42 8 years ago

cfontes• 8 years ago

This is amazing, thanks for sharing it! A very useful feature that I always missed but never actually tough about.

I've had a hard time understanding the slices on the beginning will be very useful for troubleshooting bad images also while optimizing image sizes.

Can probably help to understand problems like the one bug where the image size got almost a 2x increase after a CHOWN, because the slice is added again with different owner ( I think ;) ) would be so much easier to see with this.

Ref for the old bug https://github.com/moby/moby/issues/5505

mirimir• 8 years ago

Same here. I'm relatively new to Docker. I've taken a public jessie image, and tweaked and committed locally. I can see that layers exist when I pull images, but just what they are has been a mystery.

avip2• 8 years ago

Newer docker versions have a --chown flag for COPY/ADD exactly to address that.

ravedave5• 8 years ago

We added a lib to a java image and the size went up by about 4x the library size, I spent a few hours trying to track it down to no avail. Hopefully this will help pin down the issue.

dvdbloc• 8 years ago

Let us know if it’s a relatable issue. Might save someone else a headache in the future.

tmkc13• 8 years ago

Nice!! have been waiting for something like this for a while. Gonna try this for sure.

manneshiva• 8 years ago

just curious, how do you intend to use this? I mean, what problem does exploring each layer in a Docker solve for you?

orf2• 8 years ago

"why does this small change increase the size of my image by 500mb"

wagoodman• 8 years ago

It does two things for you: a) you get to visualize and explore the image layer by layer, and b) it will analyze and score the image with a % efficiency, listing all of the potential "inefficient" files.

In this way it's not just showing you a score... the score doesn't help you make the image any better. This is why letting the user explore the layers is good, to help discover and explain why there is an inefficiency (not just that there is one).

king_magic• 8 years ago

This looks spectacular. This could solve a large chunk of my challenges with Docker in one swoop. Really excited to use this!

bepvte2• 8 years ago

Is there a smart way to make more layers than splitting everything up into modules and ADDing each one? Why doesnt docker have delta transfers yet?

orf2• 8 years ago

Layers are delta transfers. Maybe not as smart as they could be, but there is a lot of under-appreciated complexity hiding here.

bepvte2• 8 years ago

layers are not delta transfers in my opinion, they are just new copies or removed files. its like saying sftp is delta transfer because you don't have to send your entire disk image every time. I love layers and dockers very nice reusing of base layers and such but i feel like delta transfers would dramatically improve my workflow and upload times.

maxbendick2• 8 years ago

This is great! Docker feels imperative to me, and using this could help mitigate that.

Also looking into Nix to help my container workflow more declarative.

avip2• 8 years ago

But a Dockerfile is imperative. It just lists, in order, the steps needed to build an image.

maxbendick2• 8 years ago

It's declarative in the sense that the instructions are set in text. But what goes inside a Dockerfile might be imperative, like running apt-get to install packages (i.e., running steps in order).

etaioinshrdlu2• 8 years ago

Project idea: a Google for docker images.

Search for files by hash within all public docker images.

Find images that contain a certain piece of code.

Reverse engineering Dockerfiles for those that were built without.

kylequest• 8 years ago

DockerSlim will reverse engineer / auto-generate a Dockerfile for you :)

bacongobbler2• 8 years ago

The latter can be easily done in a few hours by inspecting the image layer metadata.

Every layer understands the command it was run in the Dockerfile to create itself. Just look at `docker history` and have a look at the "CREATED BY" field for human-readable output of the layer metadata, or depending on your graph driver have a look in /var/lib/docker/image/overlay2/imagedb/content/sha256. From there you can reverse-engineer a Dockerfile.

For layers that were not built using `docker build` (e.g. `docker commit`, OCI-compatible image builders), re-creating the exact command that generated that layer is much harder to do. The only information most tools will give you might just be the diff itself.

etaioinshrdlu2• 8 years ago

Cool!

New project idea ... Crawl a large set of popular docker images lacking Dockerfiles and attempt to recreate the dockerfile with this technique.

edraferi• 8 years ago

Every layer understands the command it was run in the Dockerfile to create itself

How reliable is this? Can it be modified after creation by a malicious party?

That is, if I get a wild docker image, can I trust the results of `docker history`?

divbzero• 8 years ago

A GitHub for Docker images might be the better analogy.

Docker the company could, I imagine, add deep search and browsing as enhancements to their existing Docker Hub.

orliesaurus• 8 years ago

Can someone well versed in Docker explain in their own words what this does and why it is useful? Thanks in advance! I'm definitely not a docker poweruser...other than build start and stopping..

IMTDb• 8 years ago

A docker image is built in layers that stack on top of each other. Think of each layer as a commit in a git repository.

This project takes an image and shows the list of layers (=commits) and for each layer (=commit) allow you to see what was changed (=the diff).

A bit like a git log for a docker image.

djsumdog• 8 years ago

If OP looks up some Dockerfiles on docker hub, this will make more sense. Look at this mysql file for instance:

https://github.com/docker-library/mysql/blob/696fc899126ae00...

If two Dockerfiles use debain:stretch-slim as their base, docker won't download both base images twice. Each command in the Dockerfile creates an image. If you copy a Dockerfile and just change the last line and build them in order, the 2nd build will run a lot faster and you'll see in the output it pulls out "cached images" since it's already run those commands (docker build --no-cache always forced a full build).

If you start making Dockerfiles and playing around with it, it will start to make more sense.

vkaku• 8 years ago

Good tool!

brunoqc2• 8 years ago

Is there a tool to compare 2 or more images to check which layers they have in common?

bacongobbler2• 8 years ago

There's no tool I'm aware of, but with experimental features enabled in the Docker CLI you can use `docker manifest inspect` on each image manifest and diff the content. e.g. `docker manifest inspect ubuntu:latest`.

This requires that you have logged in to the registry, pushed the image to the registry and have `docker pull` rights for the image. You could also run a registry locally, push your image there and inspect your registry's storage db. There's just no CLI command to do that.

brunoqc2• 8 years ago

Thanks!

daveisfera• 8 years ago

This used to be a tool to do it, but it hasn't been kept up to date with changes to image creation and storage. https://imagelayers.io

balibebas• 8 years ago

Beyond Compare for Docker/Moby seems like an ideal use case for an inspection tool such as this. While space is cheap finding dbs which could be consolidated could have some tangible benefits for just about everyone.

jugg1es• 8 years ago

I have been looking for something like this for like 2 years. This will be most useful for experienced devs new to Docker that don't quite understand what's going on and haven't had time to read the specs on how docker works.

Exuma• 8 years ago

dude this is sick

wayoverthecloud• 8 years ago

This is amazing!

kureikain• 8 years ago

Off topic but anyone notices lot of issue with Dockerhub recently? Such as image tag disappear :( randomly fail to push or take a very long time to pull

vachi• 8 years ago

As others have noted here, this is why we use Nix https://nixos.org/

bloopernova• 8 years ago

Very, very useful. Thank you for sharing this!

Dive – A tool for exploring each layer in a Docker image

Related Stories