aboutsummaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorJorge Niedbalski <jorge.niedbalski@linaro.org>2018-03-08 13:06:33 +0100
committerJorge Niedbalski <jorge.niedbalski@linaro.org>2018-05-18 13:27:18 -0400
commitd516ad7da2d86ad03374f8244f6738ee65d6f6a4 (patch)
tree9e9b2941d867f9bd4166b3e56c0117705c56074c /doc
parent5c1f0226d341adb0ccdee33a7aa9ba7d026f90dd (diff)
downloadkolla-ansible-d516ad7da2d86ad03374f8244f6738ee65d6f6a4.tar.gz
kolla-ansible-d516ad7da2d86ad03374f8244f6738ee65d6f6a4.zip
horizon: allow to configure by custom_local_settings.j2
kolla-ansible should provide a mechanism to allow operators to overwrite the default (or not exposed through configuration) options for the local_settings. local_settings.j2 may be good place to configure horizon but requires operator to sync it every release. custom_local_settings.j2 can be used to overwrite things from local_settings.j2 without a need of syncing it first. This patch also adds a release note and a documentation section under the advanced configuration page. Partial-Bug: #1769970 Depends-On: https://review.openstack.org/#/c/567006/ Change-Id: I84b54ba737276114e512d4577ac4b9010682bb98
Diffstat (limited to 'doc')
-rw-r--r--doc/source/reference/horizon-guide.rst30
-rw-r--r--doc/source/reference/index.rst1
2 files changed, 31 insertions, 0 deletions
diff --git a/doc/source/reference/horizon-guide.rst b/doc/source/reference/horizon-guide.rst
new file mode 100644
index 000000000..450d408ed
--- /dev/null
+++ b/doc/source/reference/horizon-guide.rst
@@ -0,0 +1,30 @@
+.. _horizon-guide:
+
+================
+Horizon in Kolla
+================
+
+Overview
+~~~~~~~~
+
+Kolla can deploy a full working Horizon dashboard setup in either
+a **all-in-one** or **multinode** setup.
+
+Extending the default local_settings options
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+It is possible to extend the default configuration options for
+Horizon by using a custom python settings file that will override
+the default options set on the local_settings file.
+
+As an example, for setting a different (material) theme as the default one,
+a file named custom_local_settings should be created under the directory
+``{{ node_custom_config }}/horizon/`` with the following contents:
+
+.. code-block:: python
+
+ AVAILABLE_THEMES = [
+ ('material', 'Material', 'themes/material'),
+ ]
+
+.. end
diff --git a/doc/source/reference/index.rst b/doc/source/reference/index.rst
index 92fbc5bf9..b9d041d6d 100644
--- a/doc/source/reference/index.rst
+++ b/doc/source/reference/index.rst
@@ -26,3 +26,4 @@ Projects Deployment References
vmware-guide
tacker-guide
xenserver-guide
+ horizon-guide