Welcome to Regress Stack! Regress Stack is a straightforward Ubuntu OpenStack package configurator. It is designed to simplify the process of setting up an OpenStack environment for testing purposes. With Regress Stack, you can easily configure OpenStack packages on a single node and run basic smoke tests to verify the functionality of the packages.
To get started with Regress Stack, follow these simple steps:
-
Clone the Repository:
git clone https://github.com/canonical/regress-stack.git cd regress-stack -
Install pre-commit:
uvx pre-commit install
-
Install Dependencies:
sudo apt install dpkg-dev python3-dev python-apt-dev uv sync
-
Run Tests:
uv run py.test
-
Run the Regress Stack:
uv run regress-stack setup uv run regress-stack test
Regress Stack currently supports the following OpenStack modules:
- Ceph:
ceph-mgr,ceph-mon,ceph-osd,ceph-volume - Cinder:
cinder-api,cinder-scheduler,cinder-volume - Glance:
glance-api - Heat:
heat-api,heat-api-cfn,heat-engine - Keystone:
keystone,apache2,libapache2-mod-wsgi-py3 - Magnum:
magnum-api,magnum-conductor - Neutron:
neutron-server,neutron-ovn-metadata-agent - Nova:
nova-api,nova-conductor,nova-scheduler,nova-compute,nova-spiceproxy,spice-html5 - OVN:
ovn-central,openvswitch-switch,ovn-host - Placement:
placement-api
The following modules are available on Sunbeam but are not currently supported by Regress Stack:
- Horizon
- Ironic
- Masakari
- Octavia
- Watcher
- Manila
- Barbican
- AODH
- Ceilometer
- Gnocchi
We welcome contributions from the community! If you have ideas for new features or improvements, feel free to open an issue or submit a pull request.
This project is licensed under the GNU General Public License v3.0 only. See the LICENSE file for details.
Happy Testing!