ttssdev/haproxy-confd

HAProxy与confd结合的HTTP负载均衡镜像

该镜像基于yaronr/haproxy-confd、cstpdk/haproxy-confd及xcompass/haproxy-confd，整合HAProxy与confd工具，提供动态配置的负载均衡能力。

镜像概述

• HAProxy版本：1.6.x
• confd版本：0.12.0-alpha
• 基于官方Alpine HAProxy镜像构建，体积更小
• 支持零停机重新配置（逐步转移新连接而非直接重载）

核心功能

1. 动态负载均衡：通过confd从KV存储（如etcd）获取配置，实时更新HAProxy规则
2. URL正则路由：除主机名匹配外，支持URL正则表达式路由
3. KV键验证：确保KV存储中必要键存在，避免配置失败
4. 多域名支持：可配置多个域名的负载均衡规则
5. SSL/HTTPS支持：提供SSL卸载功能，支持HTTP到HTTPS的重定向
6. 零停机更新：新增或移除上游节点时，不中断现有连接

使用场景

• 微服务架构下的服务发现与负载均衡
• 需要动态调整后端节点的Web应用场景
• 需SSL卸载的HTTPS服务部署

配置说明

1. 初始化KV存储路径

使用etcdctl创建必要的路径：

bash
etcdctl mkdir "/services"
etcdctl mkdir "/tcp-services"
etcdctl mkdir "/config"

2. 创建HTTP服务

以example.org/foo/bar/blech路径为例，配置后端节点1.2.3.4:80（nodeA）和2.3.4.5:80（nodeB）：

bash
etcdctl mkdir "/services/example"
etcdctl set "/services/example/host" "example.org"
etcdctl set "/services/example/path" "/foo/bar/blech"
etcdctl set "/services/example/upstreams/nodeA" "1.2.3.4:80"
etcdctl set "/services/example/upstreams/nodeB" "2.3.4.5:80"

3. 启用SSL支持

bash
etcdctl mkdir "/config/services"
etcdctl set "/config/services/enable_ssl" "true"
etcdctl set "/services/example/scheme" "https"

scheme可选值：http（默认）、https（HTTP重定向到HTTPS）、http-and-https（同时支持）。需将证书/密钥文件挂载到容器的/keys目录。

4. 启动容器

暴露80、443端口，并挂载证书目录：

bash
docker run -e ETCD_NODE=http://172.17.42.1:2379 -p 1000:1000 -p 80:80 -p 443:443 -v `pwd`/keys:/keys compass/haproxy-confd

动态管理节点

• 添加上游节点：

  bash
  etcdctl set "/services/example/upstreams/nodeB2" "2.3.4.5:90"
  

• 移除上游节点：

  bash
  etcdctl rm "/services/example/upstreams/nodeB2"
  

• 删除服务：

  bash
  etcdctl rmdir "/services/example"
  

TCP服务配置

TCP服务配置与HTTP服务类似，只需将路径中的/services替换为/tcp-services即可。