Common testing content for OpenStack-Ansible
Go to file
Andreas Jaeger d89297c2d6 Switch to newer openstackdocstheme and reno versions
Switch to openstackdocstheme 2.2.1 and reno 3.1.0 versions. Using
these versions will allow especially:
* Linking from HTML to PDF document
* Allow parallel building of documents
* Fix some rendering problems

Update Sphinx version as well.

Set openstackdocs_pdf_link to link to PDF file. Note that
the link to the published document only works on docs.openstack.org
where the PDF file is placed in the top-level html directory. The
site-preview places the PDF in a pdf directory.

openstackdocstheme renames some variables, so follow the renames
before the next release removes them. A couple of variables are also
not needed anymore, remove them.

See also
http://lists.openstack.org/pipermail/openstack-discuss/2020-May/014971.html

Change-Id: Iaf0ccf47069546ecd3c6931b6fa5dd9fd830ef3a
2020-06-03 17:56:19 +02:00
ansible-lint Fix usage of "|" for tests 2018-07-12 16:44:20 +02:00
common-tasks Add LXC COPR cache 2018-09-12 16:40:51 -06:00
doc Switch to newer openstackdocstheme and reno versions 2020-06-03 17:56:19 +02:00
releasenotes Switch to newer openstackdocstheme and reno versions 2020-06-03 17:56:19 +02:00
sync Update openstackdocstheme to 2.0.0 2020-05-11 11:54:43 +01:00
tests Retire repo_build and pip_install roles 2020-04-10 12:37:45 +03:00
zuul.d Increase timout for linters job to 30mins 2020-05-13 11:12:04 +00:00
.gitignore Dissuade .gitignore references to personal tools 2019-01-21 09:51:26 +08:00
.gitreview OpenDev Migration Patch 2019-04-19 19:31:44 +00:00
CONTRIBUTING.rst [ussuri][goal] Update contributor documentation 2020-05-12 21:08:10 +03:00
LICENSE Introduced all the scaffolding for test repo 2016-08-12 14:50:07 +00:00
README.rst Add source code repository link for README 2019-08-15 02:12:53 -07:00
Vagrantfile Drop support for Ubuntu Xenial 2019-07-19 12:10:25 +03:00
bindep.txt Remove gzip installation 2020-05-12 15:56:36 +03:00
create-grant-db.yml Do not log passwords 2018-04-11 13:49:00 +02:00
destroy_containers.yml Use 'become' for destroy container playbook. 2018-07-12 10:20:33 -04:00
gen-projects-list.sh Replace git.openstack.org with opendev.org 2019-05-08 19:49:28 +03:00
get-ansible-role-requirements.yml Install python3 tools and libraries instead of python2 2020-03-10 14:44:33 +02:00
iptables-clear.sh Setup iptables-clear.sh 2016-05-26 11:33:41 +01:00
listening-port-report.yml Gather different port status on different hosts 2019-01-25 18:27:20 +05:30
manual-test.rc Update README description of how to use the tests repo 2016-09-28 13:23:01 +01:00
run_tests.sh Updated the Vagrantfile 2019-07-18 15:21:13 -05:00
run_tests_common.sh Remove workaround for missing debian stretch security repo 2020-05-13 11:56:28 +01:00
setting-nodepool-variables.yml Simplify nodepool variable gathering 2018-03-08 15:36:06 -06:00
setup.cfg Cleanup py27 support 2020-04-10 12:34:59 +02:00
setup.py Cleanup py27 support 2020-04-10 12:34:59 +02:00
sync-test-repos.sh sync: keep doc/requirements.txt syncd across all repos 2019-07-18 16:51:28 -04:00
test-ansible-deps.txt Update ansible to 2.9.9 2020-05-14 06:30:12 +01:00
test-ansible-env-prep.sh Use "pip -m install" 2020-04-26 14:48:25 +02:00
test-ansible-functional.sh Add centos-8 non voting check jobs 2020-04-30 10:12:13 -04:00
test-ansible-lint.sh Only execute lint unit tests for the tests repo 2018-03-12 15:08:51 +00:00
test-ansible-role-requirements.yml Replace git.openstack.org with opendev.org 2019-05-08 19:49:28 +03:00
test-ansible-syntax.sh Improve lint test flexibility 2017-11-17 15:38:43 +00:00
test-ansible.cfg Use the config_template module from the dedicated repo 2019-02-08 13:52:34 +00:00
test-bashate.sh Fix bashate xargs run 2019-03-13 12:09:39 -05:00
test-distro_install-vars.yml Merge "Add mistral_install_method for distro installations" 2019-02-09 04:05:27 +00:00
test-install-cinder.yml Remove all MQ vhost/user creation tasks/vars 2018-07-27 13:19:10 +01:00
test-install-etcd.yml Ensure remote_user and become are consistently implemented 2018-07-06 09:45:29 +01:00
test-install-galera.yml Ensure remote_user and become are consistently implemented 2018-07-06 09:45:29 +01:00
test-install-glance.yml Merge "Ensure remote_user and become are consistently implemented" 2018-07-09 07:54:50 +00:00
test-install-gnocchi.yml Ensure remote_user and become are consistently implemented 2018-07-06 09:45:29 +01:00
test-install-haproxy.yml Use local connection and become for localhost plays 2018-07-14 14:37:06 +01:00
test-install-heat.yml Remove all MQ vhost/user creation tasks/vars 2018-07-27 13:19:10 +01:00
test-install-horizon.yml Use local connection and become for localhost plays 2018-07-14 14:37:06 +01:00
test-install-infra.yml use include_tasks instead of include 2018-09-09 08:04:47 +00:00
test-install-ironic.yml Remove all MQ vhost/user creation tasks/vars 2018-07-27 13:19:10 +01:00
test-install-keystone.yml use include_tasks instead of include 2018-09-09 08:04:47 +00:00
test-install-memcached.yml Ensure remote_user and become are consistently implemented 2018-07-06 09:45:29 +01:00
test-install-neutron.yml use include_tasks instead of include 2018-09-09 08:04:47 +00:00
test-install-nova.yml use include_tasks instead of include 2018-09-09 08:04:47 +00:00
test-install-openstack-hosts.yml Remove redundant apt cache update task 2018-07-14 14:37:28 +01:00
test-install-rabbitmq.yml Ensure remote_user and become are consistently implemented 2018-07-06 09:45:29 +01:00
test-install-swift.yml use include_tasks instead of include 2018-09-09 08:04:47 +00:00
test-install-tempest.yml Remove use of 'private' for include_role for ansible 2.8 2019-05-16 21:56:15 +01:00
test-log-collect.sh Collect log from mariadb journal 2020-05-04 07:38:25 +01:00
test-pep8.sh Implement centralised Ansible test scripts 2016-10-05 09:56:12 +01:00
test-prepare-containers.yml use include_tasks instead of include 2018-09-09 08:04:47 +00:00
test-prepare-host.yml Remove use of 'private' for include_role for ansible 2.8 2019-05-16 21:56:15 +01:00
test-prepare-keys.yml Use buster jobs instead of stretch 2020-02-24 20:08:35 +02:00
test-repo-setup.yml Replace git.openstack.org with opendev.org 2019-05-08 19:49:28 +03:00
test-requirements.txt Cleanup py27 support 2020-04-10 12:34:59 +02:00
test-setup-cinder-localhost.yml Use local connection and become for localhost plays 2018-07-14 14:37:06 +01:00
test-setup-host.yml use include_tasks instead of include 2018-09-09 08:04:47 +00:00
test-setup-swifthosts.yml Remove the unnecessary space 2018-07-11 23:18:55 -04:00
test-vars.yml Merge "Set apparmor statement based on LXC version used" 2020-05-06 17:25:37 +00:00
tox.ini Enable warnings for docs build 2020-04-26 14:49:12 +02:00

README.rst

Team and repository tags

image

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:

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:

- include: common/test-prepare-keys.yml

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.

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:

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