Testing OpenStack upgrades
Go to file
Slawek Kaplonski dc7e3b87b9 Stop using "system_packages" in readthedocs builds
It was removed on Aug 29th. See [1] for details.

[1] https://blog.readthedocs.com/drop-support-system-packages/

Change-Id: I0a97d33236f198670351dab7da61dc8f82981ac5
2023-09-15 06:36:51 +00:00
doc Dropping python3.6 and python3.7 support 2023-08-25 15:39:07 +02:00
etc Update tobiko.conf documentation page 2022-01-21 11:23:52 +00:00
infrared_plugin Merge "Delegate tasks from the tobiko-cleanup role to undercloud" 2023-09-13 15:04:47 +00:00
playbooks Download ubuntu images prior to pytest execution 2023-02-03 08:20:04 +00:00
releasenotes Dropping python3.6 and python3.7 support 2023-08-25 15:39:07 +02:00
roles Delegate tasks from the tobiko-cleanup role to undercloud 2023-09-12 10:38:38 +02:00
tobiko Lock VM creation until guest OS is ready and cloud-init done 2023-09-14 17:18:21 +02:00
tools Add script which helps abandon old patches in gerrit 2023-02-16 09:00:00 +01:00
zuul.d Dropping python3.6 and python3.7 support 2023-08-25 15:39:07 +02:00
.ansible-lint Spliting infrared plugin into roles 2020-03-17 11:07:08 +00:00
.coveragerc Relax low coverage trealdshold 2019-10-16 12:51:55 +02:00
.dockerignore Refactor container files 2021-11-12 13:40:42 +00:00
.gitignore Move TripleO ansible inventory file to .ansible/inventory folder 2022-05-25 14:46:25 +02:00
.gitreview OpenDev Migration Patch 2019-04-19 19:51:27 +00:00
.pre-commit-config.yaml Update URL for flake8 from gitlab to github 2022-11-16 15:22:30 +01:00
.pylintrc Add .pylintrc file and disable dict-values-not-iterating check 2022-03-11 23:09:15 +01:00
.readthedocs.yaml Stop using "system_packages" in readthedocs builds 2023-09-15 06:36:51 +00:00
.stestr.conf Fix requirements and use ReadTheDocs HTML documentation theme 2019-05-07 17:00:32 +02:00
ansible.cfg Rewrite Vagrant file using ansible and Centos 8 2020-06-23 11:47:17 +02:00
bindep.txt Dropping python3.6 and python3.7 support 2023-08-25 15:39:07 +02:00
docker-compose.yml Update OpenStack jobs 2022-07-21 16:22:12 +00:00
Dockerfile Update OpenStack jobs 2022-07-21 16:22:12 +00:00
extra-requirements.txt Add pytest-subtests plugin 2022-07-25 09:35:42 +02:00
LICENSE Introduce pre-commit hooks for linters verifications 2020-07-03 06:15:47 +00:00
linters-requirements.txt Update pre-commit hooks configuration 2021-12-21 14:46:44 +01:00
lower-constraints.txt Use Subnet pools to avoid cidr concurrency issues 2023-04-21 10:05:09 +02:00
mypy.ini Make Actor class generic type 2022-03-01 13:01:53 +01:00
Pipfile Dropping python3.6 and python3.7 support 2023-08-25 15:39:07 +02:00
pytest.ini Don't run some of the stateless SG tests in ovn migration workflow 2023-04-27 16:30:57 +02:00
README.rst Dropping python3.6 and python3.7 support 2023-08-25 15:39:07 +02:00
requirements.txt Use Subnet pools to avoid cidr concurrency issues 2023-04-21 10:05:09 +02:00
setup.cfg Dropping python3.6 and python3.7 support 2023-08-25 15:39:07 +02:00
setup.py Add initial structure 2018-08-13 12:58:24 +00:00
test-requirements.txt Update lower constraints file 2022-02-04 12:58:17 +00:00
tobiko.conf.example Update tobiko.conf documentation page 2022-01-21 11:23:52 +00:00
tox.ini Skip some more tests related to ovn-migration 2023-05-08 12:15:35 +02:00
upper-constraints.txt Dropping python3.6 and python3.7 support 2023-08-25 15:39:07 +02:00

Tobiko

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.8
  • Python 3.9
  • Python 3.10 (new)

and below Linux distributions:

  • CentOS 9 / RHEL 8 (with Python 3.9)
  • Ubuntu Focal (with Python 3.8)
  • Ubuntu Jammy (with Python 3.10)

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

  • OSX (with Python 3.6 to 3.10)

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).

References