diff options
| author | Michael Still <mikal@stillhq.com> | 2026-04-03 07:05:13 +1100 |
|---|---|---|
| committer | Michael Still <mikal@stillhq.com> | 2026-04-03 07:05:13 +1100 |
| commit | 71c3f6d284a1400074ee3ea84648da1e33b044d4 (patch) | |
| tree | fd994bf6366fc410beb7c690bd65dc2e7988a86c /doc | |
| parent | ac1c40288cdb86ce2a5a8f974edd059551fd4bc1 (diff) | |
| download | kolla-ansible-71c3f6d284a1400074ee3ea84648da1e33b044d4.tar.gz kolla-ansible-71c3f6d284a1400074ee3ea84648da1e33b044d4.zip | |
Add additional SPICE configuration options
Recent changes to OpenStack Compute have added a number of new
configuration options for SPICE VDI consoles. Additionally, it is
not always desirable to enable the HTML5 transcoding proxy for
SPICE consoles in Horizon. This patch adds configuration to
globals.yml for most of these new options. Specifically:
* nova_spice_html5: whether to enable the HTML5 transcoding proxy
or not. Defaults to the previous behaviour of enabling the proxy.
Notably, nova_spice_require_secure is not exposed here as it implies
that qemu is configured to support TLS, and that TLS certificates
have been configured in the nova_libvirt container. These changes
are large, and are included in a separate patch for clarity.
Additionally, OpenStack Compute added these configuration options
in 2023.1, and they are exposed as well:
* nova_spice_image_compression: "auto_glz"
* nova_spice_jpeg_compression: "auto"
* nova_spice_zlib_compression: "auto"
* nova_spice_playback_compression: true
* nova_spice_streaming_mode: "filter"
All configuration options and their various values are documented
by OpenStack Compute in their documentation.
Partial-Bug: #2131793 (spice-direct consoles)
Change-Id: I07f6890f1c7c4e543667d3cbd7b3e82bd9ec83e3
Signed-off-by: Michael Still <mikal@stillhq.com>
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/source/reference/compute/nova-guide.rst | 15 |
1 files changed, 15 insertions, 0 deletions
diff --git a/doc/source/reference/compute/nova-guide.rst b/doc/source/reference/compute/nova-guide.rst index 8e083f241..87757f930 100644 --- a/doc/source/reference/compute/nova-guide.rst +++ b/doc/source/reference/compute/nova-guide.rst @@ -45,6 +45,21 @@ Valid options are ``none``, ``novnc`` and ``spice``. Additionally, serial console support can be enabled by setting ``enable_nova_serialconsole_proxy`` to ``yes``. +``spice`` consoles have additional configuration options used by Kolla Ansible: + +* nova_spice_html5: configures whether the HTML5 transcoding proxy used by + Horizon is enabled, and defaults to ``true``. +* nova_spice_image_compression: which compression algorithm to use for images + when using the SPICE console type. Defaults to ``auto_glz``. +* nova_spice_jpeg_compression: whether or not to use JPEG compression with + SPICE consoles. Defaults to ``auto``. +* nova_spice_zlib_compression: whether or not to use zlib compression with + SPICE consoles. Defaults to ``auto``. +* nova_spice_playback_compression: whether or not to use compression for video + playback. Defaults to ``true``. +* nova_spice_streaming_mode: what streaming mode to use with SPICE consoles. + Defaults to ``filter``. + Cells ===== |