blob: c20344755a1f3cc393c8336d3b9250da47054454 [file] [log] [blame]
vexxhost-botde3a8f32024-05-20 11:57:20 +01001#######
2Horizon
3#######
4
5The Horizon component serves as the web-based user interface for OpenStack,
6allowing users to interact with the cloud infrastructure.
7
8By default, Horizon is configured to work out of the box with minimal changes
9needed. However, it can be extensively customized to fit the branding and
10requirements of your organization.
11
12.. admonition:: Deploying Horizon
13
14 If you make any changes to Horizon only and you want to deploy the Horizon
15 changes only, you can run the following command:
16
17 .. code-block:: bash
18
19 ansible-playbook vexxhost.atmosphere.openstack -t horizon
20
21********
22Branding
23********
24
25To customize the logos used in the Horizon dashboard, you need to update the
26Horizon Helm values with your custom logo files. Follow the steps below:
27
28.. code-block:: yaml
29
30 horizon_helm_values:
31 conf:
32 horizon:
33 branding:
34 logo: "{{ lookup('file', inventory_dir ~ '/files/logo.svg') | b64encode }}"
35 logo_splash: "{{ lookup('file', inventory_dir ~ '/files/logo-splash.svg') | b64encode }}"
36 favicon: "{{ lookup('file', inventory_dir ~ '/files/favicon.svg') | b64encode }}"
37 manifests:
38 configmap_logo: true
39
40It's recommended that you use ``base64`` encoded string for the values since the
41content of the files might contain special characters that could be wrongly
42handled by Helm, such as SVG files.