aristanetworks/haproxy-confd

haproxy-confd 镜像文档

镜像概述

haproxy-confd 是一个集成了 HAProxy 和 confd 工具的 Docker 镜像，旨在提供动态配置管理的负载均衡解决方案。通过 confd 实现配置的自动更新，结合 HAProxy 的高性能负载均衡能力，可简化负载均衡服务的部署与维护流程。

核心功能与特性

• 动态配置管理：基于 confd 工具，支持从多种数据源（如 etcd、Consul、环境变量等）动态拉取配置，实现 HAProxy 配置的自动更新
• 高性能负载均衡：集成 HAProxy，提供 TCP/HTTP 层负载均衡、健康检查、会话保持等功能
• 轻量级部署：基于官方基础镜像构建，体积小巧，适合容器化环境快速部署
• 灵活扩展：支持自定义配置模板，可根据实际需求调整负载均衡策略

使用场景与适用范围

• 微服务架构中需要动态调整后端服务节点的负载均衡场景
• 需要自动更新负载均衡配置以适应服务扩缩容的场景
• 对负载均衡服务可用性和配置一致性有较高要求的环境
• 容器化部署的应用集群负载均衡需求

使用方法与配置说明

基本使用（Docker Run）

bash
docker run -d \
  --name haproxy-confd \
  -p 80:80 \
  -e CONFD_BACKEND=etcd \
  -e CONFD_NODE=http://etcd:2379 \
  -e HAPROXY_CONFIG_TEMPLATE=/etc/confd/templates/haproxy.tmpl \
  haproxy-confd

Docker Compose 配置示例

yaml
version: '3'
services:
  haproxy-confd:
    image: haproxy-confd
    ports:
      - "80:80"
      - "443:443"
    environment:
      - CONFD_BACKEND=consul
      - CONFD_NODE=http://consul:8500
      - CONFD_INTERVAL=60
    volumes:
      - ./confd/templates:/etc/confd/templates
      - ./confd/conf.d:/etc/confd/conf.d
    restart: always

环境变量配置

自定义配置模板

通过挂载本地目录到容器内的 /etc/confd/templates 和 /etc/confd/conf.d 目录，可自定义 HAProxy 配置模板及 confd 配置：

1. 创建模板文件 haproxy.tmpl（示例）：

global
    log /dev/log local0
    maxconn 4096

defaults
    log global
    mode http
    timeout connect 5000ms
    timeout client 50000ms
    timeout server 50000ms

frontend http_front
    bind *:80
    default_backend http_back

backend http_back
{{range getvs "/haproxy/backends/http/*"}}
    server {{base .Key}} {{.Value}} check
{{end}}

2. 创建 confd 配置文件 haproxy.toml（示例）：

toml
[template]
src = "haproxy.tmpl"
dest = "/etc/haproxy/haproxy.cfg"
keys = [
    "/haproxy/backends/http",
]
reload_cmd = "haproxy -f /etc/haproxy/haproxy.cfg -c && systemctl reload haproxy"

3. 启动容器时挂载上述文件所在目录：

bash
docker run -d \
  --name haproxy-confd \
  -p 80:80 \
  -e CONFD_BACKEND=etcd \
  -e CONFD_NODE=http://etcd:2379 \
  -v ./confd/templates:/etc/confd/templates \
  -v ./confd/conf.d:/etc/confd/conf.d \
  haproxy-confd

注意事项

• 确保数据源（如 etcd/consul）已正确配置并可被容器访问
• 自定义配置模板时需遵循 HAProxy 配置语法，避免因语法错误导致服务启动失败
• 生产环境中建议挂载持久化卷保存关键配置，避免容器重启后配置丢失