A Streamlit web application to display Teuthology test runs from a Paddles API. This dashboard provides a user-friendly interface to view and analyze Teuthology test runs.
Before you begin, ensure you have the following installed:
- Access to paddles: A running instance of the paddles REST API.
- Python 3.11+: Recommended for compatibility with modern paddles environments.
- uv: The extremely fast Python package manager.
-
Clone the repository:
git clone <your-repository-url> && cd ceph-test-dashboard
-
Install dependencies:
Install
uv:pip install uv
Sync environment:
uv sync
-
Configure the application:
The dashboard requires a configuration file to specify the Paddles API endpoint. A template for this file is provided as
templates/config.ini.template.Copy the template to your user configuration directory:
mkdir -p ~/.config cp templates/config.ini.template ~/.config/ceph-test-dashboard.ini
Then, edit
~/.config/ceph-test-dashboard.iniand replacehttp://paddles.example.comwith the actual URL of your Paddles instance.The file content should look like this:
[paddles] base_url = http://paddles.example.com
-
Run the application:
Once configured, you can run the dashboard using Streamlit:
uv run streamlit run app.py
The application will be accessible in your web browser at the local URL provided by Streamlit (usually
http://localhost:8501).