Testing OpenStack upgrades
Go to file
Slawek Kaplonski 8a16dd5375 Add JournalLogDigger class to parse OpenStack services logs
When we use devstack based environment, services like Nova or
Neutron are logging to the journalctl instead of files.
So we need to have som LogDigger class which will be able to parse
such logs in same way like log files.

This patch adds such class and also adds to the topology class
parameters which defines what LogDigger class should be used for
the topology and what are service names to log file names mappings.

Change-Id: Ice25bfa0cae60dc2b5402e59f549e2287808ba87
2020-11-27 15:32:22 +01:00
doc Update documentation 2020-11-26 13:48:41 +01:00
etc/oslo-config-generator Autogenerate config options and sample config file 2019-07-18 17:51:49 +02:00
infrared_plugin Get IR from master branch version 2020-11-26 13:31:51 +01:00
playbooks Remove DevStack support from tobiko repository 2020-10-01 14:34:39 +02:00
releasenotes Fix requirements and use ReadTheDocs HTML documentation theme 2019-05-07 17:00:32 +02:00
roles Remove DevStack support from tobiko repository 2020-10-01 14:34:39 +02:00
tobiko Add JournalLogDigger class to parse OpenStack services logs 2020-11-27 15:32:22 +01:00
tools Fix testenv use of posargs in tox.ini 2020-10-21 06:20:56 +02:00
zuul.d Gate changes using devstack-tobiko-functional-ovn-centos job 2020-11-26 14:01:50 +01: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 Update Dockerfile to use bindep and tox 2020-06-19 07:39:26 +02:00
.gitignore gitignore add .idea 2020-11-22 10:31:22 +02:00
.gitreview OpenDev Migration Patch 2019-04-19 19:51:27 +00:00
.pre-commit-config.yaml Remove -j0 option from pylint pre-commit hook 2020-07-24 10:39:58 +00:00
.stestr.conf Fix requirements and use ReadTheDocs HTML documentation theme 2019-05-07 17:00:32 +02:00
Dockerfile Update Dockerfile to use bindep and tox 2020-06-19 07:39:26 +02:00
LICENSE Introduce pre-commit hooks for linters verifications 2020-07-03 06:15:47 +00:00
Pipfile Add tobiko-fault command 2019-03-20 14:14:33 +02:00
README.rst Update documentation 2020-11-26 13:48:41 +01:00
ansible.cfg Rewrite Vagrant file using ansible and Centos 8 2020-06-23 11:47:17 +02:00
bindep.txt Add centos-7 support 2020-09-01 13:31:28 +02:00
docker-compose.yml Update Dockerfile to use bindep and tox 2020-06-19 07:39:26 +02:00
extra-requirements.txt Add openstack client tests 2020-11-06 11:49:37 +01:00
linters-requirements.txt Fix pylint problem with Python 3.9 2020-11-26 21:56:17 +01:00
lower-constraints.txt Introduce pre-commit hooks for linters verifications 2020-07-03 06:15:47 +00:00
requirements.txt Update requirements: sshtunnel>=0.2.2 2020-11-02 15:18:00 +01:00
setup.cfg Execute test cases with InfraRed plugin on CenOS and Ubuntu 2020-03-20 10:36:35 +00:00
setup.py Add initial structure 2018-08-13 12:58:24 +00:00
test-requirements.txt Add a timeout for workflow stages 2020-09-28 12:04:49 +02:00
tobiko.conf.example Add simple Octavia traffic scenario 2019-11-26 19:13:53 +00:00
tox.ini Fix testenv use of posargs in tox.ini 2020-10-21 06:20:56 +02:00

README.rst

Tobiko 0.3

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 (new)

and below Linux distributions:

  • CentOS 7 / RHEL 7 (with Python 3.6)
  • CentOS 8 / RHEL 8 (with Python 3.6)
  • Ubuntu Focal (with Python 3.8)

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

  • Fedora 31 (with Python 3.7)
  • Fedora 32 (with Python 3.8)
  • Fedora 33 (with Python 3.9)
  • OSX (with Python 3.6 and Python 3.8)
  • Ubuntu Bionic (with Python 3.6)
  • Ubuntu Focal (with Python 3.9)

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.

Main Project Goals

  • To test OpenStakc 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 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 to implement a work-flow designed to run an ordered sequence of test cases groups (like for example tests that creates resources and verify they are working, tests that execute cloud disruptions, and finally tests that verify if resources initially created are still working). The main use of these roles is writing continuous integration jobs for Zuul (via bare Ansible roles) or other services like Jenkins (via the InfraRed plug-in).
  • To verify previously created workloads are working fine after executing OpenStack nodes update/upgrade.
  • To provide tools to monitor and recollect the healthy status of the cloud as seen from user perspective (black-box testing) or from inside (white-box testing).

References