make linter happy

Author: Alex-Welsh

doc/source/operations/gpu-in-openstack.rst

@@ -6,7 +6,7 @@ PCI Passthrough
 ###############
 
 Prerequisite - BIOS Configuration
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+---------------------------------
 
 On an Intel system:
 
@@ -23,14 +23,14 @@ It may be possible to configure passthrough without these settings, though
 stability or performance may be affected.
 
 Host and Service Configuration
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+------------------------------
 
 PCI passthrough GPU variables can be found in the
 ``etc/kayobe/stackhpc-compute.yml`` file.
 
 The ``gpu_group_map`` is a dictionary mapping inventory groups to GPU types.
 This is used to determine which GPU types each compute node should pass through
-to OpenStack. The keys are group names, the values are a list of GPU types. 
+to OpenStack. The keys are group names, the values are a list of GPU types.
 
 Possible GPU types are defined in the ``stackhpc_gpu_data`` dictionary. It
 contains data for many common GPUs. If you have a GPU that is not included,
@@ -76,7 +76,7 @@ Once host configuration is complete, deploy the OpenStack services:
     kayobe overcloud service deploy -kt nova --kolla-limit compute_a100,compute_v100,compute_multi_gpu
 
 Create a flavor
-^^^^^^^^^^^^^^^
+---------------
 
 For example, to request two of the GPUs with alias **v100_32**
 
@@ -109,7 +109,7 @@ Invoke configuration playbooks afterwards:
    tools/openstack-config --vault-password-file <Vault password file path>
 
 Create instance with GPU passthrough
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+------------------------------------
 
 .. code-block:: text
 
@@ -273,7 +273,7 @@ hosts can automatically be mapped to these groups by configuring
 .. _NVIDIA Role Configuration:
 
 Role Configuration
-^^^^^^^^^^^^^^^^^^
+------------------
 
 Configure the VGPU devices:
 
@@ -319,7 +319,7 @@ Configure the VGPU devices:
 .. _NVIDIA Kolla Ansible Configuration:
 
 Kolla-Ansible configuration
-^^^^^^^^^^^^^^^^^^^^^^^^^^^
+---------------------------
 
 See upstream documentation: `Kolla Ansible configuration <https://docs.openstack.org/kayobe/latest/configuration/reference/vgpu.html#kolla-ansible-configuration>`__
 then follow the rest.
@@ -367,12 +367,12 @@ You will need to reconfigure nova for this change to be applied:
   kayobe overcloud service deploy -kt nova --kolla-limit compute_vgpu
 
 Openstack flavors
-^^^^^^^^^^^^^^^^^
+-----------------
 
 See upstream documentation: `OpenStack flavors <https://docs.openstack.org/kayobe/latest/configuration/reference/vgpu.html#openstack-flavors>`__
 
 NVIDIA License Server
-^^^^^^^^^^^^^^^^^^^^^
+---------------------
 
 The Nvidia delegated license server is a virtual machine based appliance. You simply need to boot an instance
 using the image supplied on the NVIDIA Licensing portal. This can be done on the OpenStack cloud itself. The
@@ -449,7 +449,7 @@ Booting the VM:
 
 
 Manual VM driver and licence configuration
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+------------------------------------------
 
 vGPU client VMs need to be configured with Nvidia drivers to run GPU workloads.
 The host drivers should already be applied to the hypervisor.
@@ -519,7 +519,7 @@ includes the drivers and licencing token. Alternatively, an image can be
 created using Diskimage Builder.
 
 Disk image builder recipe to automatically license VGPU on boot
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+---------------------------------------------------------------
 
 `stackhpc-image-elements <https://github.com/stackhpc/stackhpc-image-elements>`__ provides a ``nvidia-vgpu``
 element to configure the nvidia-gridd service in VGPU mode. This allows you to boot VMs that automatically license themselves.
@@ -597,7 +597,7 @@ into your openstack-config repository and vault encrypt it. The ``file`` lookup
 the file (as shown in the example above).
 
 Testing vGPU VMs
-^^^^^^^^^^^^^^^^
+----------------
 
 vGPU VMs can be validated using the following test workload. The test should
 succeed if the VM is correctly licenced and drivers are correctly installed for
@@ -657,7 +657,7 @@ Example output:
     Test passed
 
 Changing VGPU device types
-^^^^^^^^^^^^^^^^^^^^^^^^^^
+--------------------------
 
 See upstream documentation: `Changing VGPU device types <https://docs.openstack.org/kayobe/latest/configuration/reference/vgpu.html#changing-vgpu-device-types>`__