docker-unpack

Unpack a docker image into a directory. This is useful for using Docker images with Apptainer and CVMFS.

Getting started

Install the package with pip:

pip install git+https://github.com/WATonomous/docker-unpack.git

Unpack an image:

docker pull hello-world
docker save hello-world | APP_LOG_LEVEL=DEBUG docker-unpack unpack - /tmp/hello-world

Start a container using the unpacked image:

apptainer run /tmp/hello-world /hello

Development

pdm install
pdm run docker-unpack --help

Notes

This tool is similar to cvmfs-ducc. The main difference is that cvmfs-ducc is designed to be featureful and compatible with various tools (podman, docker thin image, etc.), whereas docker-unpack is designed to be simple and fast, and only supports unpacking Docker images into flat (not layered) directories.