openstack-ansible-os_nova/doc/source/index.rst
Dmitriy Rabotyagov 604085ffe6 Remove mention of haproxy-endpoints role
Keystone role was never migrated to usage of haproxy-endpoints role
and included task was used instead the whole time.
With that to reduce complexity and to have unified approach, all mention
of the role and handler are removed from the code.

Change-Id: I3693ee3a9a756161324e3a79464f9650fb7a9f1a
2022-06-14 19:41:53 +02:00

102 lines
2.6 KiB
ReStructuredText

===============================
Nova role for OpenStack-Ansible
===============================
.. toctree::
:maxdepth: 2
configure-nova.rst
:tags: openstack, nova, cloud, ansible
:category: \*nix
This role will install the following Systemd services:
* nova-server
* nova-compute
To clone or view the source code for this repository, visit the role repository
for `os_nova <https://github.com/openstack/openstack-ansible-os_nova>`_.
Default variables
~~~~~~~~~~~~~~~~~
.. literalinclude:: ../../defaults/main.yml
:language: yaml
:start-after: under the License.
Dependencies
~~~~~~~~~~~~
This role needs pip >= 7.1 installed on the target host.
Example playbook
~~~~~~~~~~~~~~~~
.. literalinclude:: ../../examples/playbook.yml
:language: yaml
Tags
~~~~
This role supports two tags: ``nova-install`` and ``nova-config``
The ``nova-install`` tag can be used to install and upgrade.
The ``nova-config`` tag can be used to manage configuration.
CPU platform compatibility
~~~~~~~~~~~~~~~~~~~~~~~~~~
This role supports multiple CPU architecture types. At least one repo_build
node must exist for each CPU type that is in use in the deployment.
Currently supported CPU architectures:
- x86_64 / amd64
- ppc64le
At this time, ppc64le is only supported for the Compute node type. It can not
be used to manage the OpenStack-Ansible management nodes.
Compute driver compatibility
~~~~~~~~~~~~~~~~~~~~~~~~~~~~
This role supports multiple nova compute driver types. The following
compute drivers are supported:
- libvirt (default)
- ironic
The driver type is automatically detected by the OpenStack Ansible Nova role
for the following compute driver types:
- libvirt (kvm / qemu)
Any mix and match of compute node types can be used for those platforms,
except for ironic.
The ``nova_virt_type`` may be set in
``/etc/openstack_deploy/user_variables.yml``, for example:
.. code-block:: shell-session
nova_virt_type: ironic
You can set ``nova_virt_type`` per host by using ``host_vars`` in
``/etc/openstack_deploy/openstack_user_config.yml``. For example:
.. code-block:: shell-session
compute_hosts:
aio1:
ip: 172.29.236.100
host_vars:
nova_virt_type: ironic
If ``nova_virt_type`` is set in ``/etc/openstack_deploy/user_variables.yml``,
all nodes in the deployment are set to that hypervisor type. Setting
``nova_virt_type`` in both ``/etc/openstack_deploy/user_variables.yml`` and
``/etc/openstack_deploy/openstack_user_config.yml`` will always result in the
value specified in ``/etc/openstack_deploy/user_variables.yml`` being set on
all hosts.