The QEM Dashboard is a graphical user interface addon for qem-bot. It can show the current state for all incidents that are being processed. To help identify which tests are currently blocking which incidents. Its deployment happens once a day via GitLab pipelines.
To install all required dependencies, run
sudo zypper in -C postgresql-server postgresql-contrib
sudo zypper in -C perl-Mojolicious perl-Mojolicious-Plugin-Webpack \
perl-Mojo-Pg perl-Cpanel-JSON-XS perl-JSON-Validator perl-IO-Socket-SSL nodejs-default npm
npm install
if you are on an apt-based system, run
npx playwright install --with-deps
if you are on a zypper-based system, omit the --with-deps parameter
npx playwright install
and ignore the missing dependencies
The postgresql-server package installation in the previous step, created a database called postgres by the user postgres.
Allow this user to connect to the local postgres server by modifying /var/lib/psgql/data/pg_hba.conf
# TYPE DATABASE USER ADDRESS METHOD
# "local" is for Unix domain socket connections only
local all all ident
# IPv4 local connections:
host postgres postgres 127.0.0.1/32 trust
host all all 127.0.0.1/32 reject
# IPv6 local connections:
host postgres postgres ::1/128 trust
host all all ::1/128 reject
# Allow replication connections from localhost, by a user with the
# replication privilege.
local replication all reject
host replication all 127.0.0.1/32 reject
host replication all ::1/128 reject
Make sure the config file dashboard.yml points to your PostgreSQL database (and other services where appropriate):
---
secrets:
- some_secret_to_protect_sessions
pg: postgresql://[email protected]:5432/postgres
rabbitmq: amqp://user:[email protected]:5672
tokens:
- a_secret_token_openQABot_will_use
status: 0
openqa:
url: https://openqa.opensuse.org
obs:
url: https://build.opensuse.org
smelt:
url: https://smelt.suse.de
And finally use the mojo webpack development web server to make the web application available under
http://127.0.0.1:3000.
$ mojo webpack script/dashboard
Web application available at http://127.0.0.1:3000
This project lives on GitHub at https://github.com/openSUSE/qem-dashboard. Feel free to add issues or send pull requests there.
- For git commit messages use the rules stated on How to Write a Git Commit Message as a reference
If this is too much hassle for you feel free to provide incomplete pull requests for consideration or create an issue with a code change proposal.
To execute all tests a PostgreSQL instance is needed and needs to specified in the environment variable TEST_ONLINE.
For a local PostgreSQL instance with a username and password one could call:
TEST_ONLINE=postgresql://postgres:postgres@localhost:5432/postgres prove -l t/*.t t/*.t.js
For further documentation, please see docs
A containerized environment could be used to build and run the dashboard and its dependencies. For a concrete example, checkout the (so far) internal documentation under https://gitlab.suse.de/qe-core/dev-dashboard.
This project is licensed under the GPLv2 license, see the COPYING file for details.