2013-08-27 21:49:43 -04:00
|
|
|
:title: Base Image Creation
|
|
|
|
:description: How to create base images
|
|
|
|
:keywords: Examples, Usage, base image, docker, documentation, examples
|
|
|
|
|
|
|
|
.. _base_image_creation:
|
|
|
|
|
|
|
|
Base Image Creation
|
|
|
|
===================
|
|
|
|
|
|
|
|
So you want to create your own :ref:`base_image_def`? 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.
|
|
|
|
|
|
|
|
Getting Started
|
|
|
|
...............
|
|
|
|
|
|
|
|
In general, you'll want to start with a working machine that is
|
|
|
|
running the distribution you'd like to package as a base image, though
|
|
|
|
that is not required for some tools like Debian's `Debootstrap
|
|
|
|
<https://wiki.debian.org/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
|
2013-09-28 09:54:34 -04:00
|
|
|
$ sudo docker run raring cat /etc/lsb-release
|
2013-08-27 21:49:43 -04:00
|
|
|
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:
|
|
|
|
|
|
|
|
* `BusyBox <https://github.com/dotcloud/docker/blob/master/contrib/mkimage-busybox.sh>`_
|
2013-09-28 09:54:34 -04:00
|
|
|
* `CentOS
|
|
|
|
<https://github.com/dotcloud/docker/blob/master/contrib/mkimage-centos.sh>`_
|
|
|
|
* `Debian/Ubuntu
|
2013-10-15 04:26:10 -04:00
|
|
|
<https://github.com/dotcloud/docker/blob/master/contrib/mkimage-debootstrap.sh>`_
|