From d4ac18c4fdd19a842af56b2c60fc8b45e2432444 Mon Sep 17 00:00:00 2001 From: Kuo-tung Kao Date: Thu, 10 Sep 2015 13:46:24 +0800 Subject: [PATCH] build.py fails with error on AUFS add workaround to avoid the issue to image-building document. Change-Id: Icf34acb2f25c813dee7c7a3dfbb71560be5a970f Closes-Bug: #1487458 --- doc/image-building.rst | 20 ++++++++++++++++++-- 1 file changed, 18 insertions(+), 2 deletions(-) diff --git a/doc/image-building.rst b/doc/image-building.rst index 364c22e733..069e15abcd 100644 --- a/doc/image-building.rst +++ b/doc/image-building.rst @@ -2,7 +2,7 @@ Image building ============== The ``tools/build.py`` script in this repository is -responsible for building docker images. +responsible for building docker images. Guide ----- @@ -64,7 +64,7 @@ When building images, there are two methods of the Openstack install. One is ``binary``. Another is ``source``. The ``binary`` means that Openstack will be installed from apt/yum. And the ``source`` means that Openstack will be installed from source code. -The default method of the Openstack install is ``binary``. +The default method of the Openstack install is ``binary``. You can change it to ``source`` using the following command: :: @@ -101,3 +101,19 @@ Then build RHEL containers: :: build -b rhel -i ./rhel-include + + + +Known issues +------------ + + +1. Can't build base image because docker fails to install systemd. + + + There are some issue between docker and AUFS. The simple workaround + to avoid the issue is that add ``-s devicemapper`` to ``DOCKER_OPTS``. + Get more information about the issue from DockerBug_. + + +.. _DockerBug: https://github.com/docker/docker/issues/6980