Testing OpenStack upgrades
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Federico Ressi e59840857e Create a port for new router interface if gateway IP is already assigned 1 day ago
doc Update user guide: subunit files are not generated by actual Tobiko test runner (PyTest) 2 months ago
etc Update tobiko.conf documentation page 4 months ago
infrared_plugin Add quota option to tobiko IR plugin 1 month ago
playbooks Generate SSH keys on the first host in the inventory 3 months ago
releasenotes Moves RTD theme requirements definition 8 months ago
roles Add sanity test cases to Octavia workflow 4 weeks ago
tobiko Create a port for new router interface if gateway IP is already assigned 1 day ago
tools Fix bindeps installation on CentOS 4 months ago
zuul.d Workaround multiuser git issue in Tobiko containers 2 days ago
.ansible-lint Spliting infrared plugin into roles 2 years ago
.coveragerc Relax low coverage trealdshold 3 years ago
.dockerignore Refactor container files 6 months ago
.gitignore Ignore named report files .gitignore 4 months ago
.gitreview OpenDev Migration Patch 3 years ago
.pre-commit-config.yaml Add .pylintrc file and disable dict-values-not-iterating check 2 months ago
.pylintrc Add .pylintrc file and disable dict-values-not-iterating check 2 months ago
.stestr.conf Fix requirements and use ReadTheDocs HTML documentation theme 3 years ago
Dockerfile Workaround multiuser git issue in Tobiko containers 2 days ago
LICENSE Introduce pre-commit hooks for linters verifications 2 years ago
Pipfile Add tobiko-fault command 3 years ago
README.rst Remove version from the README file 3 months ago
ansible.cfg Rewrite Vagrant file using ansible and Centos 8 2 years ago
bindep.txt python3-wheel is called python3-pip-wheel on rhel9 2 months ago
docker-compose.yml Allow containers to write to ~/.ssh 4 months ago
extra-requirements.txt Add ReporPortal PyTest plugin 3 months ago
linters-requirements.txt Update pre-commit hooks configuration 5 months ago
lower-constraints.txt Bump paramiko version 3 weeks ago
mypy.ini Make Actor class generic type 3 months ago
pytest.ini Add 'minimal' marker to pytest.ini file 3 months ago
requirements.txt Bump paramiko version 3 weeks ago
setup.cfg Mark Python 3.9 and 3.10 as supported runtime 3 months ago
setup.py Add initial structure 4 years ago
test-requirements.txt Update lower constraints file 3 months ago
tobiko.conf.example Update tobiko.conf documentation page 4 months ago
tox.ini HA tests included in the faults-neutron workflow 3 months ago
upper-constraints.txt Bump paramiko version 3 weeks ago



Test Big Cloud Operations

Tobiko is an OpenStack testing framework focusing on areas mostly complementary to Tempest. While Tempest main focus has been testing OpenStack rest APIs, the main Tobiko focus is to test OpenStack system operations while "simulating" the use of the cloud as the final user would.

Tobiko's test cases populate the cloud with workloads such as Nova instances; they execute disruption operations such as services/nodes restart; finally they run test cases to validate that the cloud workloads are still functional.

Tobiko's test cases can also be used, for example, for testing that previously created workloads are working right after OpenStack services update/upgrade operation.

Project Requirements

Tobiko Python framework is being automatically tested with below Python versions:

  • Python 3.6
  • Python 3.8
  • Python 3.9
  • Python 3.10 (new)

and below Linux distributions:

  • CentOS 7 / RHEL 7 (with Python 3.6)
  • CentOS 8 / RHEL 8 (with Python 3.6)
  • CentOS 9 / RHEL 8 (with Python 3.9) (new)
  • Fedora 34 (with Python 3.9)
  • Fedora 35 (with Python 3.10)
  • Ubuntu Focal (with Python 3.8)

Tobiko has also been tested for development purposes with below OSes:

  • OSX (with Python 3.6 to 3.10)
  • Ubuntu Bionic (with Python 3.6)

The Tobiko Python framework is being used to implement test cases. As Tobiko can be executed on nodes that are not part of the cloud to test against, this doesn't mean Tobiko requires cloud nodes have to run with one of above Python versions or Linux distributions.

There is also a Docker file that can be used to create a container for running test cases from any node that do support containers execution.

Main Project Goals

  • To test OpenStack and Red Hat OpenStack Platform projects before they are released.

  • To provide a Python framework to write system scenario test cases (create and test workloads).

  • To verify previously created workloads are working fine after executing OpenStack nodes update/upgrade.

  • To write white boxing test cases (to log to cloud nodes for internal inspection purpose).

  • To write disruptive test cases (to simulate service disruptions like for example rebooting/interrupting a service to verify cloud reliability).

  • To provide Ansible roles implementing a workflow designed to run an ordered sequence of test suites. For example a workflow could do below steps:

    • creates workloads;
    • run disruptive test cases (IE reboot OpenStack nodes or services);
    • verify workloads are still working.

    The main use of these roles is writing continuous integration jobs for Zuul or other services like Jenkins (IE by using the Tobiko InfraRed plug-in).

  • To provide tools to monitor and recollect the healthy status of the cloud as seen from user perspective (black-box testing) or from an inside point of view (white-box testing built around SSH client).