7f2d203354
Custom themes support for horizon deployment. - horizon role task added for copying theme files - added theme copying into the container in templates - docs and reno updated Change-Id: If9982c8e18be31772cb031ef72b7eebd4d768be5 Co-Authored-By: Jakub Darmach <jakub@stackhpc.com> Depends-On: https://review.opendev.org/c/openstack/kayobe/+/824565 Depends-On: https://review.opendev.org/c/openstack/kolla/+/826672
54 lines
1.5 KiB
ReStructuredText
54 lines
1.5 KiB
ReStructuredText
.. _horizon-guide:
|
|
|
|
=============================
|
|
Horizon - OpenStack dashboard
|
|
=============================
|
|
|
|
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'),
|
|
]
|
|
|
|
As a result material theme will be the only one available, and used by default.
|
|
Other way of setting default theme is shown in the next section.
|
|
|
|
Adding custom themes
|
|
--------------------
|
|
|
|
It is possible to add custom themes to be available for Horizon
|
|
by using ``horizon_custom_themes`` configuration variable in ``globals.yml``.
|
|
This entry updates AVAILABLE_THEMES adding the new theme at the list end.
|
|
|
|
.. code-block:: yaml
|
|
|
|
horizon_custom_themes:
|
|
- name: my_custom_theme
|
|
label: CustomTheme
|
|
|
|
Theme files have to be copied into:
|
|
``{{ node_custom_config }}/horizon/themes/my_custom_theme``.
|
|
The new theme can be set as default in custom_local_settings:
|
|
|
|
.. code-block:: python
|
|
|
|
DEFAULT_THEME = 'my_custom_theme'
|
|
|