| vexxhost-bot | de3a8f3 | 2024-05-20 11:57:20 +0100 | [diff] [blame] | 1 | ####### |
| 2 | Horizon |
| 3 | ####### |
| 4 | |
| 5 | The Horizon component serves as the web-based user interface for OpenStack, |
| 6 | allowing users to interact with the cloud infrastructure. |
| 7 | |
| 8 | By default, Horizon is configured to work out of the box with minimal changes |
| 9 | needed. However, it can be extensively customized to fit the branding and |
| 10 | requirements 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 | ******** |
| 22 | Branding |
| 23 | ******** |
| 24 | |
| 25 | To customize the logos used in the Horizon dashboard, you need to update the |
| 26 | Horizon 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 | |
| 40 | It's recommended that you use ``base64`` encoded string for the values since the |
| 41 | content of the files might contain special characters that could be wrongly |
| 42 | handled by Helm, such as SVG files. |