andrewprotenus/marathon-lb

marathon-lb

marathon-lb是一款基于HAProxy的负载均衡工具，通过消费Marathon应用状态动态生成HAProxy配置，为Mesos/DC/OS集群提供高效、高可用的服务发现与负载分发能力，支持实时更新、TLS/SSL、零停机部署等核心特性。

核心功能

• 无状态设计：仅依赖Marathon，无需第三方状态存储（如ZooKeeper），可水平扩展
• 实时配置更新：通过Marathon事件总线接收应用状态变化，自动生成并重载HAProxy配置
• 多证书TLS支持：支持单/多SSL证书配置，满足多域名HTTPS服务需求
• 零停机部署：支持蓝绿部署模式，通过zdd.py脚本实现服务版本切换无中断
• 健康检查集成：同步Marathon应用的健康检查状态，确保流量仅分发至健康实例
• 模板自定义：允许通过模板文件或应用标签覆盖HAProxy配置，适配个性化需求

使用场景

1. DC/OS集群服务入口：作为集群外部服务的统一入口，实现负载均衡与高可用
2. 多域名HTTPS服务：通过多证书配置支持多个域名的HTTPS访问
3. 零停机服务更新：采用蓝绿部署模式，避免服务更新过程中的业务中断
4. 内部/外部负载分离：通过分组标签（如HAPROXY_GROUP=external）区分内部与外部服务的负载均衡

配置说明

App Labels配置

在Marathon应用定义中添加标签可自定义HAProxy行为，示例：

json
{
  "id": "http-service",
  "labels": {
    "HAPROXY_GROUP": "external",
    "HAPROXY_0_VHOST": "service.example.com"
  }
}

• HAPROXY_GROUP：指定负载均衡分组，仅同分组的LB会处理该应用流量
• HAPROXY_0_VHOST：为服务端口0设置虚拟主机，支持多域名（逗号分隔）

SSL证书配置

• 环境变量方式：通过HAPROXY_SSL_CERT（单证书）或HAPROXY_SSL_CERT0~100（多证书）传入证书内容
• 命令行方式：使用--ssl-certs参数指定证书路径列表（如--ssl-certs /etc/ssl/site1.pem,/etc/ssl/site2.pem）

Docker部署示例

SSE模式（实时事件监听）

bash
docker run -e PORTS=9090 --net=host andrewprotenus/marathon-lb sse --marathon http://marathon:8080

Poll模式（定期轮询）

bash
docker run -e PORTS=9090 -e POLL_INTERVAL=30 --net=host andrewprotenus/marathon-lb poll --marathon http://marathon:8080

带SSL证书的部署

bash
docker run -e PORTS=9090,443 -e HAPROXY_SSL_CERT="$(cat cert.pem)" --net=host andrewprotenus/marathon-lb sse --marathon http://marathon:8080

零停机部署示例

bash
./zdd.py -j app.json -m http://marathon:8080 -l http://marathon-lb:9090 --new-instances 2

（需提前配置应用的HAPROXY_DEPLOYMENT_GROUP和HAPROXY_DEPLOYMENT_ALT_PORT标签）