vitorz / horreum

Benchmark results repository service

Horreum

---

What is Horreum?

Horreum is a service for storing performance data and regression analysis.

Please, visit our project website:

https://horreum.hyperfoil.io

for more information.

Horreum is a Quarkus based application which uses Quinoa as its nodejs engine.

Prerequisites

• Java 11
• Apache Maven 3.8
• Docker
  • or
• Podman 4.5.1

Local development with Podman

Install of the podman packages:

dnf install -y podman podman-plugins podman-docker

In one terminal do

podman system service -t 0

And then configure DOCKER_HOST environment variable to resolve to the podman socket

export DOCKER_HOST=unix:///run/user/${UID}/podman/podman.sock

Getting Started with development server

To run with test cases do

mvn install
mvn quarkus:dev -pl '!horreum-integration-tests'

To run without test cases do

mvn -DskipTests=true -DskipITs install
mvn -Dquarkus.test.continuous-testing=disabled quarkus:dev  -pl '!horreum-integration-tests'

Get Access

• For the create-react-app live code server localhost:3000
• For the Quarkus development code server localhost:8080

Example configuration

You can preload Horreum with some example data with

./infra-legacy/example-configuration.sh

once Horreum is running.

Credentials

Horreum

Horreum is running on localhost:8080

Role	Name	Password
User	user	secret

Keycloak

Keycloak is running on localhost:8180

Role	Name	Password	Realm
Admin	admin	secret
User	user	secret	horreum

Troubleshooting development infrastructure

1. Clean cached files and rebuild

$ mvn clean -p remove-node-cache
$ mvn clean install -DskipTests -DskipITs

TODO:: troubleshooting with dev services

Tested platforms

• Linux (Fedora, RHEL)
• Windows/WSL2 (Windows 10 and Windows 11)
• MacOS (13.3) on M2 hardware

Operator

The Horreum operator can help to setup a production environment.

🧑‍💻 Contributing

Contributions to Horreum Please check our CONTRIBUTING.md

If you have any idea or doubt 👇

• Ask a question
• Raise an issue
• Feature request
• Code submission

Contribution is the best way to support and get involved in community !

Please, consult our Code of Conduct policies for interacting in our community.

Consider giving the project a star on GitHub if you find it useful.

License

Apache-2.0 license

Thanks to all the Contributors ❤️