1
0
Fork 0
docker-easy-haproxy/examples/docker
Joao Gilberto Magalhaes 5767e55dea Refactor Docker Compose examples and plugins, add pytest tests
- Adjusted Compose files to build images locally instead of pulling.
- Simplified examples by removing `/etc/hosts` entry instructions.
- Enhanced `cloudflare.py` plugin with a configurable log format.
- Improved `generate-keys.sh` for portability using `$SCRIPT_DIR`.
- Added end-to-end tests for Compose examples using pytest.
2026-02-11 19:19:08 -05:00
..
php-app Add FastCGI Plugin for PHP-FPM support with examples, tests, and documentation 2025-12-01 13:04:32 -05:00
python-app Refactor Docker Compose examples and plugins, add pytest tests 2026-02-11 19:19:08 -05:00
AGENTS.md Refactor Docker Compose examples and plugins, add pytest tests 2026-02-11 19:19:08 -05:00
docker-compose-acme.yml Bump version to 5.0.0 across repository for major release 2025-12-04 13:12:12 -05:00
docker-compose-changed-label.yml Refactor Docker Compose examples and plugins, add pytest tests 2026-02-11 19:19:08 -05:00
docker-compose-cloudflare.yml Refactor Docker Compose examples and plugins, add pytest tests 2026-02-11 19:19:08 -05:00
docker-compose-ip-whitelist.yml Refactor Docker Compose examples and plugins, add pytest tests 2026-02-11 19:19:08 -05:00
docker-compose-jwt-validator.yml Refactor Docker Compose examples and plugins, add pytest tests 2026-02-11 19:19:08 -05:00
docker-compose-multi-containers.yml Refactor Docker Compose examples and plugins, add pytest tests 2026-02-11 19:19:08 -05:00
docker-compose-php-fpm.yml Refactor Docker Compose examples and plugins, add pytest tests 2026-02-11 19:19:08 -05:00
docker-compose-plugins-combined.yml Refactor Docker Compose examples and plugins, add pytest tests 2026-02-11 19:19:08 -05:00
docker-compose-portainer-app-example.yml Revamp Swarm example documentation and streamline deployment instructions 2025-12-04 10:07:17 -05:00
docker-compose-portainer.yml Bump version to 5.0.0 across repository for major release 2025-12-04 13:12:12 -05:00
docker-compose.yml Refactor Docker Compose examples and plugins, add pytest tests 2026-02-11 19:19:08 -05:00
README.md Revamp Swarm example documentation and streamline deployment instructions 2025-12-04 10:07:17 -05:00
test_docker_compose.py Refactor Docker Compose examples and plugins, add pytest tests 2026-02-11 19:19:08 -05:00

Docker Compose Examples

Self-contained examples for EasyHAProxy. All documentation is in the docker-compose files as header comments.

Quick Start

  1. Pick an example below
  2. Open the docker-compose file
  3. Read the header comments for complete instructions
  4. Run the commands step-by-step

Basic Examples

File Description
docker-compose.yml Basic SSL setup with two virtual hosts and stats interface
docker-compose-acme.yml Let's Encrypt SSL with automatic certificate generation
docker-compose-multi-containers.yml Load balancing across multiple container replicas
docker-compose-changed-label.yml Using custom label prefix (for multiple EasyHAProxy instances)

Real-World Application Examples

File Description
docker-compose-portainer.yml Portainer behind EasyHAProxy with Let's Encrypt
docker-compose-portainer-app-example.yml Additional app alongside Portainer (shared network)

Plugin Examples

File Description
docker-compose-php-fpm.yml FastCGI plugin with PHP-FPM and PATH_INFO routing
docker-compose-jwt-validator.yml JWT token validation for API protection
docker-compose-ip-whitelist.yml IP whitelist for admin panels or sensitive services
docker-compose-cloudflare.yml Restore real client IPs when behind Cloudflare CDN
docker-compose-plugins-combined.yml Multiple plugins combined for layered security

Documentation Structure

Each docker-compose file contains:

  • WHAT THIS DEMONSTRATES - Key features and concepts
  • REQUIREMENTS - Idempotent setup commands (safe to run multiple times)
  • HOW TO START - Command to launch the stack
  • HOW TO VERIFY IT'S WORKING - Test commands with expected outputs
  • CLEAN UP - Commands to stop and remove resources

Additional Documentation