aboutsummaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorKonstantinos Mouzakitis <kon.mouzakitis@vscaler.com>2020-06-09 12:59:52 -0400
committerRadosław Piliszek <radoslaw.piliszek@gmail.com>2020-06-18 17:33:51 +0000
commitf6d8c0d481306a45d61ed224c02ff12615e83ec9 (patch)
tree97b2fa40bcb50682abb4cbb0578e0ec0d093e257 /doc
parentce1dc6da0a9de197c149cd045d48ff7a25c54701 (diff)
downloadkolla-ansible-f6d8c0d481306a45d61ed224c02ff12615e83ec9.tar.gz
kolla-ansible-f6d8c0d481306a45d61ed224c02ff12615e83ec9.zip
Adding support for multiple globals files
Added a spec file for this blueprint. Changed the kolla-ansible script to accept more than one globals.yml file. That will still be the main one but operators will be able to create more, under the /etc/kolla/globals.d directory. Also added some paragraphs in the quickstart documentation about this. Finally, Adding a release note Change-Id: I34eb91d0e2ed80694594b8fc6801cf8ad77da754 Implements: blueprint multiple-globals-files
Diffstat (limited to 'doc')
-rw-r--r--doc/source/user/quickstart.rst15
1 files changed, 15 insertions, 0 deletions
diff --git a/doc/source/user/quickstart.rst b/doc/source/user/quickstart.rst
index ee14729e2..f0496c0a9 100644
--- a/doc/source/user/quickstart.rst
+++ b/doc/source/user/quickstart.rst
@@ -453,6 +453,21 @@ There are a few options that are required to deploy Kolla-Ansible:
:kolla-ansible-doc:`Services Reference Guide
<reference/index.html>`.
+* Multiple globals files
+
+ For a more granular control, enabling any option from the main
+ ``globals.yml`` file can now be done using multiple yml files. Simply,
+ create a directory called ``globals.d`` under ``/etc/kolla/`` and place
+ all the relevant ``*.yml`` files in there. The ``kolla-ansible`` script
+ will, automatically, add all of them as arguments to the ``ansible-playbook``
+ command.
+
+ An example use case for this would be if an operator wants to enable cinder
+ and all its options, at a later stage than the initial deployment, without
+ tampering with the existing ``globals.yml`` file. That can be achieved, using
+ a separate ``cinder.yml`` file, placed under the ``/etc/kolla/globals.d/``
+ directory and adding all the relevant options in there.
+
* Virtual environment
It is recommended to use a virtual environment to execute tasks on the remote