From b043a95b96886b032cf5137793c393d8523930ff Mon Sep 17 00:00:00 2001 From: Duong Ha-Quang 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``::