From 18f197114427cc0a49df4d852a9383991057905a Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Martin=20Andr=C3=A9?= <m.andre@redhat.com>
Date: Thu, 10 Mar 2016 15:19:16 +0900
Subject: [PATCH] Document the new 'local' type for source build
Change-Id: Ia385364e3fd8fc3441ebd07adcd981154f34ebb8
---
doc/image-building.rst | 14 +++++++++++++-
1 file changed, 13 insertions(+), 1 deletion(-)
diff --git a/doc/image-building.rst b/doc/image-building.rst
index d451d91d39..8f2c02a84d 100644
--- a/doc/image-building.rst
+++ b/doc/image-building.rst
@@ -93,7 +93,11 @@ You can change it to ``source`` using the following command:
The locations of OpenStack source code are written in
``etc/kolla/kolla-build.conf``.
-Now the source type support ``url`` and ``git``. The
+Now the source type supports ``url``, ``git``, and ``local``. The location of
+the ``local`` source type can point to either a directory containing the source
+code or to a tarball of the source. The ``local`` source type permits to make
+the best use of the docker cache.
+
``etc/kolla/kolla-build.conf`` looks like:
::
@@ -107,6 +111,14 @@ Now the source type support ``url`` and ``git``. The
location = https://github.com/openstack/keystone
reference = stable/kilo
+ [heat-base]
+ type = local
+ location = /home/kolla/src/heat
+
+ [ironic-base]
+ type = local
+ location = /tmp/ironic.tar.gz
+
To build RHEL containers, it is necessary to use the -i (include header)
feature to include registration with RHN of the container runtime operating
system. To obtain a RHN username/password/pool id, contact Red Hat.