64 lines
1.5 KiB
Markdown
64 lines
1.5 KiB
Markdown
|
Undocker
|
||
|
--------
|
||
|
|
||
|
Convert a Docker image to a root file system.
|
||
|
|
||
|
Why?
|
||
|
---
|
||
|
|
||
|
Docker images seems to be the lingua franca of distributing application
|
||
|
containers. It's hell convenient. But is it the best runtime environment? Not
|
||
|
for everyone.
|
||
|
|
||
|
Undocker bridges the gap between image configurations and container runtimes:
|
||
|
now you can run a Docker image with systemd-nspawn and/or lxc.
|
||
|
|
||
|
Usage -- extract docker image
|
||
|
-----------------------------
|
||
|
|
||
|
Download `nginx` docker image from docker hub and convert it to a rootfs:
|
||
|
```
|
||
|
skopeo copy docker://docker.io/nginx:latest docker-archive:nginx.tar
|
||
|
undocker rootfs nginx.tar - | tar -xv
|
||
|
```
|
||
|
|
||
|
Usage -- systemd-nspawn example
|
||
|
-------------------------------
|
||
|
|
||
|
```
|
||
|
systemd-nspawn -D $PWD nginx -g 'daemon off;'
|
||
|
```
|
||
|
|
||
|
Usage -- lxc example
|
||
|
--------------------
|
||
|
|
||
|
Converting and creating the archive:
|
||
|
|
||
|
```
|
||
|
undocker rootfs nginx.tar - | xz -T0 > nginx.tar.xz
|
||
|
undocker lxcconfig nginx.tar config
|
||
|
tar -cJf meta.tar.xz config
|
||
|
```
|
||
|
|
||
|
Importing it to lxc and running it:
|
||
|
|
||
|
```
|
||
|
lxc-create -n bb -t local -- -m meta.tar.xz -f nginx.tar.xz
|
||
|
lxc-start -F -n bb -s lxc.net.0.type=none
|
||
|
lxc-start -F -n bb -s lxc.net.0.type=none -- /docker-entrypoint.sh nginx -g "daemon off;"
|
||
|
```
|
||
|
|
||
|
Note: automatic entrypoint does not work well with parameters with spaces; not
|
||
|
sure what lxc expects here to make it work.
|
||
|
|
||
|
Contributions
|
||
|
-------------
|
||
|
|
||
|
These are the contributions I will accept:
|
||
|
|
||
|
- pull requests for code.
|
||
|
- documentation updates.
|
||
|
|
||
|
I am very unlikely to react to bug reports (even if they are legit) without
|
||
|
accopmanying pull requests.
|