x/tobiko
Code Issues Proposed changes
Testing OpenStack upgrades
2,205 Commits 2 Branches 29 Tags 41 MiB
Python 99.5%
Shell 0.2%
Dockerfile 0.2%
b56811af76
Go to file
Federico Ressi b56811af76 Update tobiko.conf documentation page 
- add autogenerated tobiko.conf.sample file to the repo
- add links to the tobiko.conf.sample to tobiko.conf locations
- sligthly simplify documentation structure

Change-Id: I4d239798bef931460c63ed69ad1b94d6c8807e83
2022-01-21 11:23:52 +00:00
doc Update tobiko.conf documentation page 2022-01-21 11:23:52 +00:00
etc Update tobiko.conf documentation page 2022-01-21 11:23:52 +00:00
infrared_plugin Fix typo in InfrRed spec file. 2022-01-20 14:23:46 +01:00
playbooks Install docker-compose using pip 2022-01-10 13:12:53 +00:00
releasenotes Moves RTD theme requirements definition 2021-09-29 11:29:25 +00:00
roles Install docker-compose using pip 2022-01-10 13:12:53 +00:00
tobiko Merge "Change TCP port number used in the unit tests" 2022-01-20 10:15:46 +00:00
tools Update run_tests.py environment variable names 2022-01-07 14:06:45 +00:00
zuul.d Use Fedora Linux to gate changes with the infrared plugin 2022-01-18 10:26:37 +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 Refactor container files 2021-11-12 13:40:42 +00:00
.gitignore Update tobiko.conf documentation page 2022-01-21 11:23:52 +00:00
.gitreview OpenDev Migration Patch 2019-04-19 19:51:27 +00:00
.pre-commit-config.yaml Update mypy linters hook 2022-01-10 13:42:54 +01: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 Restore CentOS 7 infrared job to test Podman 1.6 integration 2021-05-31 12:44:54 +02:00
docker-compose.yml Deploy OpenShift InfraRed files from Tobiko InfraRed plugin 2022-01-19 15:10:15 +00:00
Dockerfile Check container on top of arm64 architecture 2022-01-10 13:48:14 +00:00
extra-requirements.txt Add podman 1.6.0 source files and update requirements 2021-10-27 16:34:09 +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 Revert "Remove voting from requirements-check job" 2021-11-19 09:03:05 +01:00
Pipfile Add tobiko-fault command 2019-03-20 14:14:33 +02:00
pytest.ini Add initial post OVN migration test 2021-05-25 13:02:22 +03:00
README.rst Add review.opendev to README References 2022-01-14 11:28:57 +00:00
requirements.txt Remove six from project dependencies 2021-10-28 03:42:14 +00:00
setup.cfg Fix default documentation page URL 2021-09-09 14:02:08 +00:00
setup.py Add initial structure 2018-08-13 12:58:24 +00:00
test-requirements.txt Add podman 1.6.0 source files and update requirements 2021-10-27 16:34:09 +02:00
tobiko.conf.example Update tobiko.conf documentation page 2022-01-21 11:23:52 +00:00
tox.ini Update run_tests.py environment variable names 2022-01-07 14:06:45 +00:00
upper-constraints.txt Update upper constraints file 2021-12-21 14:49:16 +00:00

README.rst

Tobiko 0.4

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

Related projects