1
0
Fork 0
mirror of https://github.com/moby/moby.git synced 2022-11-09 12:21:53 -05:00
moby--moby/docs/sources/articles/baseimages.md
Sven Dowideit ac999a9cb2 now, with shiney markdown
Docker-DCO-1.1-Signed-off-by: Sven Dowideit <SvenDowideit@fosiki.com> (github: SvenDowideit)
2014-04-16 11:04:14 +10:00

2.1 KiB
Raw Blame History

page_title: Create a Base Image page_description: How to create base images page_keywords: Examples, Usage, base image, docker, documentation, examples

Create a Base Image

So you want to create your own Base Image? Great!

The specific process will depend heavily on the Linux distribution you want to package. We have some examples below, and you are encouraged to submit pull requests to contribute new ones.

Create a full image using tar

In general, youll want to start with a working machine that is running the distribution youd like to package as a base image, though that is not required for some tools like Debians Debootstrap, which you can also use to build Ubuntu images.

It can be as simple as this to create an Ubuntu base image:

$ sudo debootstrap raring raring > /dev/null
$ sudo tar -C raring -c . | sudo docker import - raring
a29c15f1bf7a
$ sudo docker run raring cat /etc/lsb-release
DISTRIB_ID=Ubuntu
DISTRIB_RELEASE=13.04
DISTRIB_CODENAME=raring
DISTRIB_DESCRIPTION="Ubuntu 13.04"

There are more example scripts for creating base images in the Docker GitHub Repo:

Creating a simple base image using scratch

There is a special repository in the Docker registry called scratch, which was created using an empty tar file:

$ tar cv --files-from /dev/null | docker import - scratch

which you can docker pull. You can then use that image to base your new minimal containers FROM:

FROM scratch
ADD true-asm /true
CMD ["/true"]

The Dockerfile above is from extremely minimal image - tianon/true.