cloud-hosting-platform/haproxy-manager-base
3
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Update README.md for changes to script
All checks were successful
HAProxy Manager Build and Push / Build-and-Push (push) Successful in 39s
Details

Browse Source
This commit is contained in:
jknapp 2025-02-21 10:29:31 -08:00
parent c5f29374e1
commit de2957fcd2
1 changed files with 24 additions and 20 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

44
README.md
View File

@ -1,11 +1,32 @@
# HAProxy Manager Base # HAProxy Manager
A Flask-based API service for managing HAProxy configurations, domains, and SSL certificates. A Flask-based API service for managing HAProxy configurations, domains, and SSL certificates.
A Flask-based API service for managing HAProxy configurations with dynamic SSL certificate management and health monitoring.
To run the container: To run the container:
```bash ```bash
docker run -d -p 80:80 -p 443:443 -p 8000:8000 -v lets-encrypt:/etc/letsencrypt -v haproxy:/etc/haproxy --name haproxy-manager repo.anhonesthost.net/cloud-hosting-platform/haproxy-manager-base:latest docker run -d -p 80:80 -p 443:443 -p 8000:8000 -v lets-encrypt:/etc/letsencrypt -v haproxy:/etc/haproxy --name haproxy-manager repo.anhonesthost.net/cloud-hosting-platform/haproxy-manager-base:latest
``` ```
## Features
- RESTful API for HAProxy configuration management
- Database-backed configuration storage using SQLite
- Automatic HAProxy configuration generation from templates
- Let's Encrypt SSL certificate integration with auto-renewal
- Health monitoring endpoint
- Dynamic backend server management
- Template override support for custom backend configurations
- Process monitoring and auto-restart capabilities
- Socket-based HAProxy runtime API integration
## Requirements
- HAProxy
- Python 3.x
- Flask
- SQLite3
- Certbot (for Let's Encrypt certificates)
- OpenSSL (for self-signed start-up certificate)
## API Endpoints ## API Endpoints
@ -33,6 +54,7 @@ Content-Type: application/json
{ {
"domain": "example.com", "domain": "example.com",
"backend_name": "example_backend", "backend_name": "example_backend",
"template_override": null,
"servers": [ "servers": [
{ {
"name": "server1", "name": "server1",
@ -41,7 +63,7 @@ Content-Type: application/json
"options": "check" "options": "check"
}, },
{ {
"name": "server2", "name": "server2",
"address": "10.0.0.2", "address": "10.0.0.2",
"port": 8080, "port": 8080,
"options": "check backup" "options": "check backup"
@ -90,21 +112,3 @@ Content-Type: application/json
"message": "Domain configuration removed" "message": "Domain configuration removed"
} }
``` ```
## Features
- Automatic HAProxy configuration generation
- Let's Encrypt SSL certificate integration
- Backend server management
- Self-signed certificate generation for development
- Health monitoring
- Database-backed configuration storage
## Requirements
- HAProxy
- Python 3.x
- Flask
- SQLite3
- Certbot (for Let's Encrypt certificates)
- OpenSSL (for self-signed certificates)