container-diff

TLDR

Analyze image size

$ container-diff analyze [image:tag]

Diff two images for apt packages

$ container-diff diff [image1] [image2] --type=apt

Diff pip packages

$ container-diff diff [image1] [image2] --type=pip

Diff filesystem changes

$ container-diff diff [image1] [image2] --type=file

Compare multiple analyzers

$ container-diff diff [image1] [image2] --type=apt --type=pip --type=node

Output as JSON

$ container-diff diff [image1] [image2] --type=apt -j

Compare local and remote

$ container-diff diff daemon://[local:tag] remote://[repo/image:tag]

SYNOPSIS

container-diff command [options] image...

container-diff analyzes and compares container images. Shows semantic differences in packages, files, and metadata. Supports Docker daemon, remote registries, and tarballs. From Google Container Tools.

PARAMETERS

--type analyzer

Analyzer type: apt, pip, node, file, size, history

-j, --json

Output as JSON

-c, --cache dir

Cache directory

--filename path

Compare specific file

COMMANDS

analyze

Analyze single image

diff

Compare two images

IMAGE SOURCES

daemon://image: Local Docker daemon
remote://image: Remote registry
path/to/image.tar: Local tarball

ANALYZERS

apt: Debian/Ubuntu packages
pip: Python packages
node: npm packages
file: Filesystem differences
size: Image size
history: Layer history

CAVEATS

Project in maintenance mode. Does not support Docker IDs directly (tag first). Use docker-credential-helpers for registry auth.