072394923b
Patch fixes titles for doc files and resolves naming problems Change-Id: I7ceca25d48801c79348e23ca7c8a65db0a6daf4e
122 lines
3.4 KiB
ReStructuredText
122 lines
3.4 KiB
ReStructuredText
===============================
|
|
Zun role for OpenStack-Ansible
|
|
===============================
|
|
|
|
.. toctree::
|
|
:maxdepth: 2
|
|
|
|
configure-zun.rst
|
|
app-powervm.rst
|
|
|
|
:tags: openstack, zun, cloud, ansible
|
|
:category: \*nix
|
|
|
|
This role will install the following Systemd services:
|
|
* zun-server
|
|
* zun-compute
|
|
|
|
To clone or view the source code for this repository, visit the role repository
|
|
for `os_zun <https://github.com/openstack/openstack-ansible-os_zun>`_.
|
|
|
|
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
|
|
|
|
External Restart Hooks
|
|
~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
When the role performs a restart of the service, it will notify an Ansible
|
|
handler named ``Manage LB``, which is a noop within this role. In the
|
|
playbook, other roles may be loaded before and after this role which will
|
|
implement Ansible handler listeners for ``Manage LB``, allowing external roles
|
|
to manage the load balancer endpoints responsible for sending traffic to the
|
|
servers being restarted by marking them in maintenance or active mode,
|
|
draining sessions, etc. For an example implementation, please reference the
|
|
`ansible-haproxy-endpoints role <https://github.com/Logan2211/ansible-haproxy-endpoints>`_
|
|
used by the openstack-ansible project.
|
|
|
|
Tags
|
|
~~~~
|
|
|
|
This role supports two tags: ``zun-install`` and ``zun-config``
|
|
|
|
The ``zun-install`` tag can be used to install and upgrade.
|
|
|
|
The ``zun-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 zun compute driver types. The following
|
|
compute drivers are supported:
|
|
|
|
- libvirt (default)
|
|
- ironic
|
|
- lxd (via zun-lxd)
|
|
- powervm (via zun-powervm)
|
|
|
|
The driver type is automatically detected by the OpenStack Ansible Nova role
|
|
for the following compute driver types:
|
|
|
|
- libvirt (kvm / qemu)
|
|
- powervm
|
|
|
|
Any mix and match of compute node types can be used for those platforms,
|
|
except for ironic.
|
|
|
|
If using the lxd driver, the compute type must be specified using the
|
|
``zun_virt_type`` variable.
|
|
|
|
The ``zun_virt_type`` may be set in
|
|
``/etc/openstack_deploy/user_variables.yml``, for example:
|
|
|
|
.. code-block:: shell-session
|
|
|
|
zun_virt_type: lxd
|
|
|
|
You can set ``zun_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:
|
|
zun_virt_type: lxd
|
|
|
|
If ``zun_virt_type`` is set in ``/etc/openstack_deploy/user_variables.yml``,
|
|
all nodes in the deployment are set to that hypervisor type. Setting
|
|
``zun_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.
|