Differences between revisions 1 and 20 (spanning 19 versions)
Revision 1 as of 2014-03-05 17:05:17
Size: 552
Comment:
Revision 20 as of 2015-05-14 13:55:57
Size: 3719
Editor: jmtd
Comment: reword intro
Deletions are marked like this. Additions are marked like this.
Line 1: Line 1:
Hints on how to create a Debian image for [[Docker]]. This page attempts to document how to create a Debian image for [[Docker]].
Line 3: Line 3:
See http://sfxpt.wordpress.com/2013/11/17/debianubuntu-package-developing-with-docker-continued/ for original reference. [[https://index.docker.io/_/debian/|Docker.com provide Debian images]] they describe as "semi-official". They are modified from stock Debian (see [[http://joeyh.name/blog/entry/docker_run_debian/|Joey H's blog post]] for some of the differences) and there is no secure way of obtaining the images or proving they have not been tampered with.
Line 5: Line 5:
The following is work in progress WITHOUT ANY WARANTY You can create your own Debian Docker images using the methods described below.
Line 7: Line 7:
Note that due to bug #740855 `/usr/share/docker.io/contrib/mkimage-debootstrap.sh` needs to be patched at the moment. '''The following is work in progress WITHOUT ANY WARRANTY'''
Line 9: Line 9:
You may create an image with : This page describes different methods for building your own Debian docker images.

<<TableOfContents()>>

== Using (upstream provided "contrib" script) mkimage.sh ==

The `docker.io` package ships the `/usr/share/docker.io/contrib/mkimage.sh` script which may be used, alongside the companion script `/usr/share/docker.io/contrib/mkimage/debootstrap` to create a Docker image for Debian (or Ubuntu) using `debootstrap`, and with or without further tweaks.

You may create an image for the `stable` suite (using the `minbase` debootstrap variant) with :
Line 11: Line 19:
.../mkimage-debootstrap.sh $USER/debian sid sudo .../mkimage.sh -t $USER/minbase debootstrap --variant=minbase stable
Line 16: Line 24:
sudo docker.io run -i $USER/debian:sid echo "hello world" sudo docker.io run -i $USER/minbase echo "hello world"
Line 18: Line 26:

Contrary to the former mkimage-debootstrap.sh (now deprecated, see below), contrib/mkimage/debootstrap does not need the mandatory `variant` parameter, and can invoke debootstrap without a specific variant, using its default settings.

== Using mkimage-debootstrap.sh (now flagged as deprecated by upstream) ==

The `docker.io` package still ships the, now deprecated, `/usr/share/docker.io/contrib/mkimage-debootstrap.sh` script which may be used to create a Docker image for Debian (or Ubuntu) using `debootstrap`, and with or without further tweaks.

You may create an image for the `stable` suite (using the `minbase` debootstrap variant) with :
{{{
.../mkimage-debootstrap.sh $USER/minbase stable
}}}

The image may then be used with :
{{{
sudo docker.io run -i $USER/minbase:stable echo "hello world"
}}}

As an alternative to upstream's choices, you may modify the script so that it does not use the minbase variant by default (see for instance [[https://raw.github.com/olberger/docker/debian/contrib/mkimage-debootstrap.sh|obergix's version]] and adjust to your needs), or use the newer mkimage.sh (see above).

== Manual method ==

To build pristine debian images, without cloud/docker-specific, customisations, you can use the scripts at <https://github.com/jmtd/debian-docker>. These use {{{debootstrap}}} to prepare a basic filesystem and add them into a docker image. Suggestions for improvements are very welcome.

Images built from these scripts are pushed to the Docker Registry as {{{jmtd/debian:wheezy}}}, {{{jmtd/debian:jessie}}} etc., but there is presently no image verification in place (so no way to cryptographically prove the provenance of the images).

See also <http://www.debian-administration.org/article/696/A_brief_introduction_to_using_docker#a2>.

== Using the newly built image to create a test container ==

A dockerfile may then refer to your image using the following directive :
{{{
FROM YOURUSER/minbase:stable
}}}

You may test it with :
{{{
echo "FROM $USER/minbase:stable" | docker.io build -t $USER/test:stable -
}}}

== Resources ==
 * See http://sfxpt.wordpress.com/2013/11/17/debianubuntu-package-developing-with-docker-continued/ for a description of using `mkimage-debootstrap.sh`.
 * Nickoloff, Jeff, Docker in Action (http://www.manning.com/nickoloff/), Manning Publications, 2014, ISBN 978-1-6334-3023-5

This page attempts to document how to create a Debian image for Docker.

Docker.com provide Debian images they describe as "semi-official". They are modified from stock Debian (see Joey H's blog post for some of the differences) and there is no secure way of obtaining the images or proving they have not been tampered with.

You can create your own Debian Docker images using the methods described below.

The following is work in progress WITHOUT ANY WARRANTY

This page describes different methods for building your own Debian docker images.

Using (upstream provided "contrib" script) mkimage.sh

The docker.io package ships the /usr/share/docker.io/contrib/mkimage.sh script which may be used, alongside the companion script /usr/share/docker.io/contrib/mkimage/debootstrap to create a Docker image for Debian (or Ubuntu) using debootstrap, and with or without further tweaks.

You may create an image for the stable suite (using the minbase debootstrap variant) with :

sudo .../mkimage.sh -t $USER/minbase debootstrap --variant=minbase stable

The image may then be used with :

sudo docker.io run -i $USER/minbase echo "hello world"

Contrary to the former mkimage-debootstrap.sh (now deprecated, see below), contrib/mkimage/debootstrap does not need the mandatory variant parameter, and can invoke debootstrap without a specific variant, using its default settings.

Using mkimage-debootstrap.sh (now flagged as deprecated by upstream)

The docker.io package still ships the, now deprecated, /usr/share/docker.io/contrib/mkimage-debootstrap.sh script which may be used to create a Docker image for Debian (or Ubuntu) using debootstrap, and with or without further tweaks.

You may create an image for the stable suite (using the minbase debootstrap variant) with :

.../mkimage-debootstrap.sh $USER/minbase stable

The image may then be used with :

sudo docker.io run -i $USER/minbase:stable echo "hello world"

As an alternative to upstream's choices, you may modify the script so that it does not use the minbase variant by default (see for instance obergix's version and adjust to your needs), or use the newer mkimage.sh (see above).

Manual method

To build pristine debian images, without cloud/docker-specific, customisations, you can use the scripts at <https://github.com/jmtd/debian-docker>. These use debootstrap to prepare a basic filesystem and add them into a docker image. Suggestions for improvements are very welcome.

Images built from these scripts are pushed to the Docker Registry as jmtd/debian:wheezy, jmtd/debian:jessie etc., but there is presently no image verification in place (so no way to cryptographically prove the provenance of the images).

See also <http://www.debian-administration.org/article/696/A_brief_introduction_to_using_docker#a2>.

Using the newly built image to create a test container

A dockerfile may then refer to your image using the following directive :

FROM YOURUSER/minbase:stable

You may test it with :

echo "FROM $USER/minbase:stable" | docker.io build -t $USER/test:stable -

Resources