This project aims to provide a simplified web based user interface to switch between maintenance and ready/up states in HAProxy Open Source edition. If You are using HAProxy Enterprise edition you already have a sufficient UI to control your proxy.
By default, the application uses the HAProxy backend to post specific states. This means it uses the stats site to manage states. This way one does not have to publish an application which has to write into the HAProxy socket which can do a lot more than the statistics backend.
The project also provides controls for Hetzner Cloud API routing and floating IP to manage which server should be attached.
Despite the lengthy repository name just call it "Simple backend controller".
See requirements.txt
In production you will need a WSGI service and a webserver such as Gunicor and Nginx.
- Django
- django[argon2,bcrypt]
- numpy
- argon2 >= 0.1
- bcrypt >= 4.2
- haproxyctl
- Change
SECRET_KEYto a save and secret value. - Change
DEBUGtoFalse - Change
LANGUAGE_CODEaccording to your needs. Default is'de-de' - Change
TIME_ZONEaccording to your needs. Default is'Europe/Berlin' - Change
ALLOWED_HOSTSaccording to your needs. Default is['*'] - Set up your database connections with
DATABASE. By default, a SQLITE database is used.
Contributions are appreciated.
We strongly advise to use pre-commit with our provided .pre-commit-config.yaml before you commit and push your
contribution.
This assures code style and some quality standards are met before you create some unclean states of your work. However, since nobody can be trusted the same tools run in CI pipelines.
foo@bar:~$ pip install pre-commit
foo@bar:~$ pre-commit installPre commit hooks running pylint, pytest and flake8 with flake8-bandit and flake8-black.
Additionally, we use atheris to provide fuzzing and pytest for unit testing purposes.
We do not merge until everything is green.