From b043a95b96886b032cf5137793c393d8523930ff Mon Sep 17 00:00:00 2001
From: Duong Ha-Quang <duonghq@vn.fujitsu.com>
Date: Wed, 28 Sep 2016 18:31:21 +0700
Subject: [PATCH] Add profile usage to kolla-build guide
It's not uncommon case which user need defined set of images to
use in their scenario.
TrivialFix
Change-Id: I903220def8ce263a51257380a19ae9ea67fb4cd5
---
doc/image-building.rst | 24 ++++++++++++++++++++++++
1 file changed, 24 insertions(+)
diff --git a/doc/image-building.rst b/doc/image-building.rst
index 6e15f84aa3..16b1fad213 100644
--- a/doc/image-building.rst
+++ b/doc/image-building.rst
@@ -66,6 +66,30 @@ Multiple names may be specified on the command line::
kolla-build keystone nova
+The set of images built can be defined as a profile in the ``profiles`` section
+of ``kolla-build.conf``. Later, profile can be specified by ``--profile`` CLI
+argument or ``profile`` option in ``kolla-build.conf``. Kolla provides some
+pre-defined profiles:
+
+- ``infra`` infrastructure-related images
+- ``main`` core OpenStack images
+- ``aux`` auxiliary images such as trove, magnum, ironic
+- ``default`` minimal set of images for a working deploy
+
+For example, due to Magnum requires Heat, following profile can be add to
+``profiles`` section in ``kolla-build.conf`` ::
+
+ magnum = magnum,heat
+
+These images can be built using command line ::
+
+ kolla-build --profile magnum
+
+Or put following line to ``DEFAULT`` section in ``kolla-build.conf`` ::
+
+ profile = magnum
+
+
``kolla-build`` uses ``kolla`` as default Docker namespace. This is
controlled with the ``-n`` command line option. To push images to a dockerhub
repository named ``mykollarepo``::
--
GitLab