======
Tobiko
======
Test Big Cloud Operations
-------------------------
Tobiko is an OpenStack testing framework focusing on areas mostly
complementary to `Tempest <https://docs.openstack.org/tempest/latest/>`__.
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
----------
* Free software: Apache License, Version 2.0
* Documentation: https://tobiko.readthedocs.io/
* Release notes: https://docs.openstack.org/releasenotes/tobiko/
* Source code: https://opendev.org/x/tobiko
* Bugs: https://storyboard.openstack.org/#!/project/x/tobiko
* Code review: https://review.opendev.org/q/project:x/tobiko
Related projects
~~~~~~~~~~~~~~~~
* OpenStack: https://www.openstack.org/
* Red Hat OpenStack Platform: https://www.redhat.com/en/technologies/linux-platforms/openstack-platform
* Python: https://www.python.org/
* Testtools: https://github.com/testing-cabal/testtools
* Ansible: https://www.ansible.com/
* InfraRed: https://infrared.readthedocs.io/en/latest/
* DevStack: https://docs.openstack.org/devstack/latest/
* Zuul: https://docs.openstack.org/infra/system-config/zuul.html
* Jenkins: https://www.jenkins.io/
Raw data
{
"_id": null,
"home_page": "https://tobiko.readthedocs.io/",
"name": "tobiko",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": "",
"keywords": "setup,distutils",
"author": "OpenStack",
"author_email": "openstack-discuss@lists.openstack.org",
"download_url": "https://files.pythonhosted.org/packages/73/4d/9a998b6b3d7dfb0651bdc5a57cdc725174dff16a555a17630fb970450c33/tobiko-0.7.2.tar.gz",
"platform": null,
"description": "======\nTobiko\n======\n\n\nTest Big Cloud Operations\n-------------------------\n\nTobiko is an OpenStack testing framework focusing on areas mostly\ncomplementary to `Tempest <https://docs.openstack.org/tempest/latest/>`__.\nWhile Tempest main focus has been testing OpenStack rest APIs, the main Tobiko\nfocus is to test OpenStack system operations while \"simulating\"\nthe use of the cloud as the final user would.\n\nTobiko's test cases populate the cloud with workloads such as Nova instances;\nthey execute disruption operations such as services/nodes restart; finally they\nrun test cases to validate that the cloud workloads are still functional.\n\nTobiko's test cases can also be used, for example, for testing that previously\ncreated workloads are working right after OpenStack services update/upgrade\noperation.\n\n\nProject Requirements\n--------------------\n\nTobiko Python framework is being automatically tested with below Python\nversions:\n\n- Python 3.8\n- Python 3.9\n- Python 3.10 (new)\n\nand below Linux distributions:\n\n- CentOS 9 / RHEL 8 (with Python 3.9)\n- Ubuntu Focal (with Python 3.8)\n- Ubuntu Jammy (with Python 3.10)\n\nTobiko has also been tested for development purposes with below OSes:\n\n- OSX (with Python 3.6 to 3.10)\n\nThe Tobiko Python framework is being used to implement test cases. As Tobiko\ncan be executed on nodes that are not part of the cloud to test against, this\ndoesn't mean Tobiko requires cloud nodes have to run with one of above Python\nversions or Linux distributions.\n\nThere is also a Docker file that can be used to create a container for running\ntest cases from any node that do support containers execution.\n\n\nMain Project Goals\n~~~~~~~~~~~~~~~~~~\n\n- To test OpenStack and Red Hat OpenStack Platform projects before they are\n released.\n- To provide a Python framework to write system scenario test cases (create\n and test workloads).\n- To verify previously created workloads are working fine after executing\n OpenStack nodes update/upgrade.\n- To write white boxing test cases (to log to cloud nodes\n for internal inspection purpose).\n- To write disruptive test cases (to simulate\n service disruptions like for example rebooting/interrupting a service to\n verify cloud reliability).\n- To provide Ansible roles implementing a workflow designed to run an ordered\n sequence of test suites. For example a workflow could do below steps:\n\n - creates workloads;\n - run disruptive test cases (IE reboot OpenStack nodes or services);\n - verify workloads are still working.\n\n The main use of these roles is writing continuous integration jobs for Zuul\n or other services like Jenkins (IE by using the Tobiko InfraRed plug-in).\n- To provide tools to monitor and recollect the healthy status of the cloud as\n seen from user perspective (black-box testing) or from an inside point of\n view (white-box testing built around SSH client).\n\n\nReferences\n----------\n\n* Free software: Apache License, Version 2.0\n* Documentation: https://tobiko.readthedocs.io/\n* Release notes: https://docs.openstack.org/releasenotes/tobiko/\n* Source code: https://opendev.org/x/tobiko\n* Bugs: https://storyboard.openstack.org/#!/project/x/tobiko\n* Code review: https://review.opendev.org/q/project:x/tobiko\n\n\nRelated projects\n~~~~~~~~~~~~~~~~\n* OpenStack: https://www.openstack.org/\n* Red Hat OpenStack Platform: https://www.redhat.com/en/technologies/linux-platforms/openstack-platform\n* Python: https://www.python.org/\n* Testtools: https://github.com/testing-cabal/testtools\n* Ansible: https://www.ansible.com/\n* InfraRed: https://infrared.readthedocs.io/en/latest/\n* DevStack: https://docs.openstack.org/devstack/latest/\n* Zuul: https://docs.openstack.org/infra/system-config/zuul.html\n* Jenkins: https://www.jenkins.io/\n\n\n\n",
"bugtrack_url": null,
"license": "",
"summary": "OpenStack Testing Upgrades Library",
"version": "0.7.2",
"project_urls": {
"Homepage": "https://tobiko.readthedocs.io/"
},
"split_keywords": [
"setup",
"distutils"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "c87754e0dd2d2f77959112a8254205a4eba1b9dc39ef5037859080b4f0593d07",
"md5": "b7ef60321478cef391ddd055d9c9c4b1",
"sha256": "ef1a159b41eac7f95f092045fa6f7b13c087a5fba167e77a7248f3cd3ee3cf25"
},
"downloads": -1,
"filename": "tobiko-0.7.2-py2.py3-none-any.whl",
"has_sig": false,
"md5_digest": "b7ef60321478cef391ddd055d9c9c4b1",
"packagetype": "bdist_wheel",
"python_version": "py2.py3",
"requires_python": ">=3.8",
"size": 663814,
"upload_time": "2024-02-26T11:20:29",
"upload_time_iso_8601": "2024-02-26T11:20:29.594640Z",
"url": "https://files.pythonhosted.org/packages/c8/77/54e0dd2d2f77959112a8254205a4eba1b9dc39ef5037859080b4f0593d07/tobiko-0.7.2-py2.py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "734d9a998b6b3d7dfb0651bdc5a57cdc725174dff16a555a17630fb970450c33",
"md5": "7de66a75cf05281af5951b05f58c3472",
"sha256": "21ab304a2c6cb7ddbf1459db2c2291f70462fa52c8ddad0014bf94307e177cb1"
},
"downloads": -1,
"filename": "tobiko-0.7.2.tar.gz",
"has_sig": false,
"md5_digest": "7de66a75cf05281af5951b05f58c3472",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 513608,
"upload_time": "2024-02-26T11:20:32",
"upload_time_iso_8601": "2024-02-26T11:20:32.091475Z",
"url": "https://files.pythonhosted.org/packages/73/4d/9a998b6b3d7dfb0651bdc5a57cdc725174dff16a555a17630fb970450c33/tobiko-0.7.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-02-26 11:20:32",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "tobiko"
}
JSON