convert docker images to rootfs
Go to file
Motiejus Jakštys 6de3355893 add similar projects 2021-05-24 07:39:40 +03:00
internal/tartest remove bazelishms 2021-05-24 00:11:58 +03:00
rootfs fix include paths 2021-05-24 00:11:58 +03:00
LICENSE add license 2021-05-24 00:11:58 +03:00
README.md add similar projects 2021-05-24 07:39:40 +03:00
go.mod fix include paths 2021-05-24 00:11:58 +03:00
main.go simple doc 2021-05-24 00:11:58 +03:00
main_test.go update README and misc files 2021-05-24 00:11:58 +03:00

README.md

Undocker

Converts a Docker image (a bunch of layers) to a flattened "rootfs" tarball.

Why?

Docker images became a popular way to distribute applications with their dependencies. However, Docker itself is not the best runtime environment. At least not for everyone. May boring technology run our software.

Undocker bridges the gap between application images (in docker image format) and container runtimes: now you can run a Docker image with old-fashioned tools: lxc, systemd-nspawn or systemd itself.

Usage -- extract docker image

Download busybox docker image from docker hub and convert it to a rootfs:

skopeo copy docker://docker.io/busybox:latest docker-archive:busybox.tar
undocker busybox.tar - | tar -xv

You can also refer to this for other ways to download Docker images. There are many.

Usage -- systemd-nspawn example

Start with systemd-nspawn:

systemd-nspawn -D $PWD busybox httpd -vfp 8080

Usage -- plain old systemd

systemd-run \
  --wait --pty --collect --service-type=exec \
  -p PrivateUsers=true \
  -p DynamicUser=yes \
  -p ProtectProc=invisible \
  -p RootDirectory=$PWD \
  -- busybox httpd -vfp 8080

Good things like PrivateUsers, DynamicUser, ProtectProc and other systemd protections are available, just like to any systemd unit.

Notes & gotchas

unocker does not magically enable you to run containers from the internet. Many will need significant tuning or not work at all; one will still need to understand what's inside.

Similar Projects

Changelog

0.1

  • initial release: rootfs.Flatten and a simple command-line application.

Contributions

I want this project to be useful for others, but not become a burden for me. If undocker fails for you (for example, you found a container that undocker cannot extract, or extracts incorrectly), you are on the hook to triage and fix it.

Therefore, the following contributions are welcome:

  • Pull rquests (diffs) with accompanying tests.
  • Documentation.

Issues without accompanying patches will most likely be rejected, with one exception: reports about regressions do not have to contain patches, but a failing commit is mandatory, and a failing test case is highly appreciated.

LICENSE

MIT