96 lines
3.2 KiB
ReStructuredText
96 lines
3.2 KiB
ReStructuredText
========================
|
|
Team and repository tags
|
|
========================
|
|
|
|
.. image:: https://governance.openstack.org/tc/badges/openstack-ansible-tests.svg
|
|
:target: https://governance.openstack.org/tc/reference/tags/index.html
|
|
|
|
.. Change things from this point on
|
|
|
|
OpenStack-Ansible testing
|
|
=========================
|
|
|
|
This is the ``openstack-ansible-tests`` repository, providing a framework and
|
|
consolidation of testing configuration and playbooks. This can be used to
|
|
integrate new projects, and ensure that code duplication is minimized whilst
|
|
allowing the addition of new testing scenarios with greater ease.
|
|
|
|
Role Integration
|
|
~~~~~~~~~~~~~~~~
|
|
|
|
To enable the ``openstack-ansible-tests`` repository, ensure that the
|
|
``tox.ini`` configuration in the role repository matches the `galera_client
|
|
repository tox.ini`_ with the exception of the value for ``ROLE_NAME``.
|
|
A more advanced configuration which implements multiple functional test
|
|
scenarios is available in the `neutron role tox.ini`_.
|
|
|
|
To override variables you can create a ``${rolename}-overrides.yml`` file inside the
|
|
role's tests folder. This variable file can be includes in the functional tox
|
|
target configuration in ``tox.ini`` as demonstrated in the following extract:
|
|
|
|
.. code-block:: bash
|
|
|
|
ansible-playbook -i {toxinidir}/tests/inventory \
|
|
-e @{toxinidir}/tests/${rolename}-overrides.yml \
|
|
{toxinidir}/tests/test.yml -vvvv
|
|
|
|
In your repositories ``tests/test.yml`` file, you can call any of the
|
|
included playbooks, for example:
|
|
|
|
.. code-block:: yaml
|
|
|
|
- include: common/test-prepare-keys.yml
|
|
|
|
.. _galera_client repository tox.ini: https://opendev.org/openstack/openstack-ansible-galera_client/src/tox.ini
|
|
.. _neutron role tox.ini: https://opendev.org/openstack/openstack-ansible-os_neutron/src/tox.ini
|
|
|
|
Network Settings
|
|
~~~~~~~~~~~~~~~~
|
|
|
|
The networking can be configured and setup using the ``bridges`` variable.
|
|
|
|
The base option, when only 1 interface is required is to specify just a single
|
|
base - this is only for backwards compatibility with existing test setup and
|
|
will default to ``br-mgmt`` with an IP of ``10.1.0.1``.
|
|
|
|
.. code-block:: yaml
|
|
|
|
bridges:
|
|
- "br-mgmt"
|
|
|
|
To allow a more complicated network setup we can specify
|
|
``ip_addr``: The IP address on the interface.
|
|
``netmask``: Netmask of the interface (defaults to 255.255.255.0)
|
|
``name``: Name of the interface
|
|
``veth_peer``: Set up a veth peer for the interface
|
|
``alias``: Add an alias IP address
|
|
|
|
For example, a Nova setup may look like this:
|
|
|
|
.. code-block:: yaml
|
|
|
|
bridges:
|
|
- name: "br-mgmt"
|
|
ip_addr: "10.1.0.1"
|
|
- name: "br-vxlan"
|
|
ip_addr: "10.1.1.1"
|
|
- name: "br-vlan"
|
|
ip_addr: "10.1.2.200"
|
|
veth_peer: "eth12"
|
|
alias: "10.1.2.1"
|
|
|
|
Documentation for the project can be found at:
|
|
https://docs.openstack.org/openstack-ansible-tests/latest/
|
|
|
|
Release notes for the project can be found at:
|
|
https://docs.openstack.org/releasenotes/openstack-ansible-tests/
|
|
|
|
The project source code repository is located at:
|
|
https://opendev.org/openstack/openstack-ansible-tests
|
|
|
|
The project home is at:
|
|
https://launchpad.net/openstack-ansible
|
|
|
|
The project bug tracker is located at:
|
|
https://bugs.launchpad.net/openstack-ansible
|