easyhaproxy 6.0.0__tar.gz → 6.1.0__tar.gz

{easyhaproxy-6.0.0 → easyhaproxy-6.1.0}/.github/workflows/build.yml

@@ -34,7 +34,7 @@ jobs:
 
     steps:
       - name: Checkout repository
-        uses: actions/checkout@v4
+        uses: actions/checkout@v7
 
       - name: Install uv
         run: curl -LsSf https://astral.sh/uv/install.sh | sh
@@ -58,7 +58,7 @@ jobs:
 
     steps:
       - name: Checkout repository
-        uses: actions/checkout@v4
+        uses: actions/checkout@v7
 
       - name: Install uv
         run: curl -LsSf https://astral.sh/uv/install.sh | sh
@@ -82,7 +82,7 @@ jobs:
 
     steps:
       - name: Checkout repository
-        uses: actions/checkout@v4
+        uses: actions/checkout@v7
 
       - name: Install uv
         run: curl -LsSf https://astral.sh/uv/install.sh | sh
@@ -106,7 +106,7 @@ jobs:
 
     steps:
       - name: Checkout repository
-        uses: actions/checkout@v4
+        uses: actions/checkout@v7
 
       - name: Install uv
         run: curl -LsSf https://astral.sh/uv/install.sh | sh
@@ -138,7 +138,7 @@ jobs:
 
     steps:
       - name: Checkout repository
-        uses: actions/checkout@v4
+        uses: actions/checkout@v7
 
       - name: Install uv
         run: curl -LsSf https://astral.sh/uv/install.sh | sh
@@ -170,17 +170,17 @@ jobs:
 
     steps:
       - name: Checkout repository
-        uses: actions/checkout@v4
+        uses: actions/checkout@v7
 
       - name: Set up QEMU
-        uses: docker/setup-qemu-action@v3
+        uses: docker/setup-qemu-action@v4
 
       - name: Set up Docker Buildx
-        uses: docker/setup-buildx-action@v3
+        uses: docker/setup-buildx-action@v4
 
       - name: Log into registry
         if: github.event_name == 'push' || github.event.inputs.push == 'true'
-        uses: docker/login-action@v3
+        uses: docker/login-action@v4
         with:
           registry: ${{ secrets.DOCKER_REGISTRY }}
           username: ${{ secrets.DOCKER_REGISTRY_USER }}
@@ -190,11 +190,11 @@ jobs:
       # https://github.com/docker/metadata-action
       - name: Extract Docker metadata
         id: meta
-        uses: docker/metadata-action@v5
+        uses: docker/metadata-action@v6
         with:
           images: ${{ secrets.DOCKER_REGISTRY }}/${{ env.IMAGE_NAME }}
 
-      - uses: actions/github-script@v6
+      - uses: actions/github-script@v9
         id: tags
         with:
           script: |
@@ -215,7 +215,7 @@ jobs:
         run: |
           echo "${{ steps.tags.outputs.result }}"
 
-      - uses: actions/github-script@v6
+      - uses: actions/github-script@v9
         id: normalized
         with:
           script: |
@@ -239,7 +239,7 @@ jobs:
       # Build and push Docker image with Buildx (don't push on PR)
       # https://github.com/docker/build-push-action
       - name: Build and push Docker image
-        uses: docker/build-push-action@v5
+        uses: docker/build-push-action@v7
         with:
           context: .
           file: deploy/docker/Dockerfile
@@ -271,7 +271,7 @@ jobs:
 
     steps:
       - name: Checkout repository
-        uses: actions/checkout@v4
+        uses: actions/checkout@v7
 
       - name: Install uv
         run: curl -LsSf https://astral.sh/uv/install.sh | sh
@@ -291,12 +291,12 @@ jobs:
     env:
       DOC_GITHUB_TOKEN: '${{ secrets.DOC_TOKEN }}'
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v7
         if: startsWith(github.ref, 'refs/tags/')
         with:
           ref: master
           
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v7
         if: github.ref == 'refs/heads/master'
 
       - name: Get result

{easyhaproxy-6.0.0 → easyhaproxy-6.1.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: easyhaproxy
-Version: 6.0.0
+Version: 6.1.0
 Summary: HAProxy label based routing with service discovery for Docker, Swarm, and Kubernetes
 License: MIT License
         
@@ -45,6 +45,11 @@ Requires-Dist: pyyaml>=6.0
 Requires-Dist: requests>=2.31.0
 Description-Content-Type: text/markdown
 
+---
+sidebar_key: docker-easy-haproxy
+tags: [docker, devops]
+---
+
 # EasyHAProxy
 
 [![Sponsor](https://img.shields.io/badge/Sponsor-%23ea4aaa?logo=githubsponsors&logoColor=white&labelColor=0d1117)](https://github.com/sponsors/byjg)
@@ -60,133 +65,55 @@ Description-Content-Type: text/markdown
 
 ## Service discovery for HAProxy
 
-EasyHAProxy dynamically creates the `haproxy.cfg` based on metadata collected from your workloads (Docker labels, Swarm service labels, or Kubernetes ingress annotations).
-
-EasyHAProxy can detect and configure HAProxy automatically on the following platforms:
-
-- Docker
-- Docker Swarm
-- Kubernetes
-- Static YAML definitions (`EASYHAPROXY_DISCOVER=static`)
-
-## Who is using?
-
-EasyHAProxy is part of some projects:
-- Dokku
-- MicroK8s
-- DigitalOcean Marketplace
-
-See detailed instructions on how to install below.
-
-## EasyHAProxy Mission
-
-Easy to set up and low configuration to numerous features. 
+EasyHAProxy dynamically creates `haproxy.cfg` based on metadata from your workloads — Docker labels, Swarm service labels, or Kubernetes Ingress annotations. No HAProxy knowledge required.
 
 ## Features
 
-EasyHAProxy will discover services based on Docker (or Swarm) labels and Kubernetes ingress annotations, then dynamically build the `haproxy.cfg`. Below, EasyHAProxy main features:
-
-- Support Automatic Certificate Management Environment (ACME) protocol compatible with Let's Encrypt and other CAs.
-- Set your custom SSL certificates
-- Balance traffic between multiple replicas
-- Set SSL policies (`strict`, `default`, `loose`) via `EASYHAPROXY_SSL_MODE`.
-- Set up HAProxy to listen to TCP.
-- Add redirects.
-- Enable/disable Stats on port 1936 with a custom password.
-- Enable/disable custom errors.
-
-Also, it is possible to set up HAProxy from a simple Yaml file instead of creating `haproxy.cfg` file.
-
-## How Does It Work?
-
-You don't need to change your current infrastructure and don't need to learn the HAProxy configuration.
-
-The steps are:
-
-- Run the EasyHAProxy container;
-- Add some labels to the containers you want to be parsed by EasyHAProxy (see detailed instructions below);
-- EasyHAProxy will automatically detect the containers, set up, and reload the HAProxy configurations for you without downtime.
+- **Automatic service discovery** — Docker, Docker Swarm, Kubernetes, or static YAML
+- **Zero-downtime HAProxy reload** — configuration updates happen without dropping connections
+- **Automatic TLS with ACME** — Let's Encrypt, ZeroSSL, BuyPass, and more
+- **Custom SSL certificates** — volume-mount or label-embed your own PEM files
+- **TCP mode** — proxy any TCP service, not just HTTP
+- **Plugin system** — JWT validation, IP whitelisting, Cloudflare IP restoration, FastCGI, path blocking, and custom plugins
+- **Real-time monitoring dashboard** — built-in, zero-dependency web UI with live traffic charts, frontend/backend health, and per-server stats (enabled with a single env var)
+- **Balance algorithms** — roundrobin, leastconn, source, uri, and more
 
-## Detailed Instructions
+## Supported platforms
 
-For detailed instructions on how to use EasyHAProxy, follow the instructions for the platform you want to use:
+[![Kubernetes](docs/easyhaproxy_kubernetes.png)](docs/getting-started/kubernetes.md)
+[![Docker Swarm](docs/easyhaproxy_swarm.png)](docs/getting-started/swarm.md)
+[![Docker](docs/easyhaproxy_docker.png)](docs/getting-started/docker.md)
+[![Static](docs/easyhaproxy_static.png)](docs/getting-started/static.md)
 
-[![Kubernetes](docs/easyhaproxy_kubernetes.png)](docs/kubernetes.md)
-[![Docker Swarm](docs/easyhaproxy_swarm.png)](docs/swarm.md)
-[![Docker](docs/easyhaproxy_docker.png)](docs/docker.md)
-[![Static](docs/easyhaproxy_static.png)](docs/static.md)
+Install using tools:
 
-Or you can install using tools:
+[![Helm](docs/easyhaproxy_helm.png)](docs/guides/helm.md)
+[![MicroK8s](docs/easyhaproxy_microk8s.png)](docs/guides/microk8s.md)
+[![Dokku](docs/easyhaproxy_dokku.png)](docs/guides/dokku.md)
+[![DigitalOcean](docs/easyhaproxy_digitalocean.png)](docs/guides/digitalocean.md)
 
-[![Helm](docs/easyhaproxy_helm.png)](docs/helm.md)
-[![MicroK8s](docs/easyhaproxy_microk8s.png)](docs/microk8s.md)
-[![Dokku](docs/easyhaproxy_dokku.png)](docs/dokku.md)
-[![DigitalOcean](docs/easyhaproxy_digitalocean.png)](docs/digitalocean.md)
+## Documentation
 
-## Special Topics
+| Section | Description |
+|---------|-------------|
+| **[Getting Started](docs/getting-started/)** | Choose your runtime and discovery mode, minimal working setup |
+| **[Guides](docs/guides/ssl.md)** | SSL, ACME, plugins, Helm, MicroK8s, Dokku, DigitalOcean |
+| **[Concepts](docs/concepts/)** | Service discovery, config pipeline, plugin model, TLS termination |
+| **[Reference](docs/reference/environment-variables.md)** | Environment variables, container labels, CLI flags, volumes |
 
-If you already set up the EasyHAProxy, is time to go deeper:
-
-- [Custom SSL](docs/ssl.md)
-- [Automatic Certificate Issuing](docs/acme.md) (e.g. Letsencrypt)
-
-## Configuration Reference
-
-Detailed configuration guides for advanced setups:
-
-- [Container Labels](docs/container-labels.md) - Configure Docker/Swarm containers with labels
-- [Environment Variables](docs/environment-variable.md) - Configure EasyHAProxy behavior
-- [Volumes](docs/volumes.md) - Map volumes for certificates, config, and custom files
-- [Plugins](docs/plugins.md) - Extend HAProxy with plugins ([Development Guide](docs/plugin-development.md))
-  - [JWT Validator](docs/Plugins/jwt-validator.md) - JWT authentication validation
-  - [FastCGI](docs/Plugins/fastcgi.md) - PHP-FPM and FastCGI application support
-  - [Cloudflare](docs/Plugins/cloudflare.md) - Restore visitor IP from Cloudflare CDN
-  - [IP Whitelist](docs/Plugins/ip-whitelist.md) - Restrict access to IPs/CIDR ranges
-  - [Deny Pages](docs/Plugins/deny-pages.md) - Block access to specific paths
-  - [Cleanup](docs/Plugins/cleanup.md) - Automatic cleanup of temporary files
-- [Other Configurations](docs/other.md) - Additional configurations (ports, custom errors, etc.)
-- [Limitations](docs/limitations.md) - Important limitations and considerations
-
-## Development
-
-### Requirements
-
-- Python 3.11 or higher
-- [uv](https://github.com/astral-sh/uv) package manager
-
-### Installation for Development
-
-```bash
-# Install uv (if not already installed)
-curl -LsSf https://astral.sh/uv/install.sh | sh
-
-# Clone the repository
-git clone https://github.com/byjg/docker-easy-haproxy.git
-cd docker-easy-haproxy
-
-# Install dependencies (creates virtual environment automatically)
-uv sync --dev
-
-# Run tests
-make test
-# or directly: uv run pytest tests/ -vv
-
-# Run linting
-make lint
+## Who is using?
 
-# Format code
-make format
-```
+EasyHAProxy is part of some projects:
+- [Dokku](docs/guides/dokku.md)
+- [MicroK8s](docs/guides/microk8s.md)
+- [DigitalOcean Marketplace](docs/guides/digitalocean.md)
 
-### Installing the Package
+## Monitoring Dashboard
 
-```bash
-# Install with uv
-uv pip install easymapping
+[![HAProxy Monitor](docs/dashboard_thumbnail.png)](docs/guides/dashboard.md)
 
-# Or install from source
-uv pip install -e ".[dev]"
-```
+A real-time dashboard is available at `http://<host>:11936/` whenever `HAPROXY_PASSWORD` is set —
+no extra containers, no Prometheus, no Grafana. See the [dashboard guide](docs/guides/dashboard.md).
 
 ## See EasyHAProxy in action
 
@@ -201,6 +128,5 @@ Click on the image to see the videos (use HD for better visualization)
 
 [Here is the code](https://gist.github.com/byjg/e125e478a0562190176d69ea795fd3d4) applied in the test examples above.
 
-
 ----
 [Open source ByJG](http://opensource.byjg.com)

easyhaproxy-6.1.0/README.md

@@ -0,0 +1,85 @@
+---
+sidebar_key: docker-easy-haproxy
+tags: [docker, devops]
+---
+
+# EasyHAProxy
+
+[![Sponsor](https://img.shields.io/badge/Sponsor-%23ea4aaa?logo=githubsponsors&logoColor=white&labelColor=0d1117)](https://github.com/sponsors/byjg)
+[![Opensource ByJG](https://img.shields.io/badge/opensource-byjg-success.svg)](http://opensource.byjg.com)
+[![Build Status](https://github.com/byjg/docker-easy-haproxy/actions/workflows/build.yml/badge.svg?branch=master)](https://github.com/byjg/docker-easy-haproxy/actions/workflows/build.yml)
+[![GitHub source](https://img.shields.io/badge/Github-source-informational?logo=github)](https://github.com/byjg/docker-easy-haproxy/)
+[![GitHub license](https://img.shields.io/github/license/byjg/docker-easy-haproxy.svg)](https://opensource.byjg.com/opensource/licensing.html)
+[![GitHub release](https://img.shields.io/github/release/byjg/docker-easy-haproxy.svg)](https://github.com/byjg/docker-easy-haproxy/releases/)
+[![Helm Version](https://img.shields.io/badge/dynamic/yaml?color=blue&label=Helm&query=%24.entries.easyhaproxy%5B0%5D.version&url=http%3A%2F%2Fopensource.byjg.com%2Fhelm%2Findex.yaml)](https://opensource.byjg.com/helm)
+[![Artifact Hub](https://img.shields.io/endpoint?url=https://artifacthub.io/badge/repository/byjg)](https://artifacthub.io/packages/search?repo=byjg)
+
+![EasyHAProxy](docs/easyhaproxy_logo.png)
+
+## Service discovery for HAProxy
+
+EasyHAProxy dynamically creates `haproxy.cfg` based on metadata from your workloads — Docker labels, Swarm service labels, or Kubernetes Ingress annotations. No HAProxy knowledge required.
+
+## Features
+
+- **Automatic service discovery** — Docker, Docker Swarm, Kubernetes, or static YAML
+- **Zero-downtime HAProxy reload** — configuration updates happen without dropping connections
+- **Automatic TLS with ACME** — Let's Encrypt, ZeroSSL, BuyPass, and more
+- **Custom SSL certificates** — volume-mount or label-embed your own PEM files
+- **TCP mode** — proxy any TCP service, not just HTTP
+- **Plugin system** — JWT validation, IP whitelisting, Cloudflare IP restoration, FastCGI, path blocking, and custom plugins
+- **Real-time monitoring dashboard** — built-in, zero-dependency web UI with live traffic charts, frontend/backend health, and per-server stats (enabled with a single env var)
+- **Balance algorithms** — roundrobin, leastconn, source, uri, and more
+
+## Supported platforms
+
+[![Kubernetes](docs/easyhaproxy_kubernetes.png)](docs/getting-started/kubernetes.md)
+[![Docker Swarm](docs/easyhaproxy_swarm.png)](docs/getting-started/swarm.md)
+[![Docker](docs/easyhaproxy_docker.png)](docs/getting-started/docker.md)
+[![Static](docs/easyhaproxy_static.png)](docs/getting-started/static.md)
+
+Install using tools:
+
+[![Helm](docs/easyhaproxy_helm.png)](docs/guides/helm.md)
+[![MicroK8s](docs/easyhaproxy_microk8s.png)](docs/guides/microk8s.md)
+[![Dokku](docs/easyhaproxy_dokku.png)](docs/guides/dokku.md)
+[![DigitalOcean](docs/easyhaproxy_digitalocean.png)](docs/guides/digitalocean.md)
+
+## Documentation
+
+| Section | Description |
+|---------|-------------|
+| **[Getting Started](docs/getting-started/)** | Choose your runtime and discovery mode, minimal working setup |
+| **[Guides](docs/guides/ssl.md)** | SSL, ACME, plugins, Helm, MicroK8s, Dokku, DigitalOcean |
+| **[Concepts](docs/concepts/)** | Service discovery, config pipeline, plugin model, TLS termination |
+| **[Reference](docs/reference/environment-variables.md)** | Environment variables, container labels, CLI flags, volumes |
+
+## Who is using?
+
+EasyHAProxy is part of some projects:
+- [Dokku](docs/guides/dokku.md)
+- [MicroK8s](docs/guides/microk8s.md)
+- [DigitalOcean Marketplace](docs/guides/digitalocean.md)
+
+## Monitoring Dashboard
+
+[![HAProxy Monitor](docs/dashboard_thumbnail.png)](docs/guides/dashboard.md)
+
+A real-time dashboard is available at `http://<host>:11936/` whenever `HAPROXY_PASSWORD` is set —
+no extra containers, no Prometheus, no Grafana. See the [dashboard guide](docs/guides/dashboard.md).
+
+## See EasyHAProxy in action
+
+Click on the image to see the videos (use HD for better visualization)
+
+[![Docker In Action](docs/video-docker.png)](https://youtu.be/ar8raFK0R1k)
+[![Docker and Letsencrypt](docs/video-docker-ssl.png)](https://youtu.be/xwIdj9mc2mU)
+[![K8s In Action](docs/video-kubernetes.png)](https://youtu.be/uq7TuLIijks)
+[![K8s and Letsencrypt](docs/video-kubernetes-letsencrypt.png)](https://youtu.be/v9Q4M5Al7AQ)
+[![Static Configuration](docs/video-static.png)](https://youtu.be/B_bYZnRTGJM)
+[![TCP Mode](docs/video-tcp-mysql.png)](https://youtu.be/JHqcq9crbDI)
+
+[Here is the code](https://gist.github.com/byjg/e125e478a0562190176d69ea795fd3d4) applied in the test examples above.
+
+----
+[Open source ByJG](http://opensource.byjg.com)

{easyhaproxy-6.0.0 → easyhaproxy-6.1.0}/RELEASE.md

@@ -54,7 +54,7 @@ EasyHAProxy follows [Semantic Versioning](https://semver.org/):
   - **MINOR**: New features, plugin additions, backward-compatible changes
   - **PATCH**: Bug fixes, documentation updates, minor improvements
 
-**Current Version:** `6.0.0` (as of Chart.yaml)
+**Current Version:** `6.1.0` (as of Chart.yaml)
 
 ## Automated Release (Recommended)
 
@@ -329,6 +329,8 @@ helm show chart byjg/easyhaproxy
 
 | Version | Release Date | Type  | Highlights                                                                                                                            |
 |---------|--------------|-------|---------------------------------------------------------------------------------------------------------------------------------------|
+| 6.1.0   | 2026-06-24   | Minor | FastCGI protocol support, certbot sidecar plugin, dependency updates |
+| 6.0.1   | 2026-02-23   | Patch | HAProxy dashboard, real-time monitoring dashboard with live traffic charts, ACME e2e test fixes |
 | 6.0.0   | 2026-XX-XX   | Major | Python module refactoring (one-class-per-file), IngressClassName support (spec.ingressClassName + deprecated annotation fallback), modernized build system (uv/pyproject.toml), improved version management and release tooling, GitHub Actions workflow_dispatch push control |
 | 5.0.0   | 2025-12-04   | Major | Plugin framework (builtin plugins: JWT, FastCGI, Cloudflare, IP whitelist, deny pages, cleanup), docs restructure, examples refreshed |
 | 4.6.0   | 2024-11-27   | Minor | FastCGI plugin, JWT enhancements                                                                                                      |