mesosphere/marathon-lb

marathon-lb

marathon-lb是一款用于管理HAProxy的工具，通过消费Marathon的应用状态动态生成HAProxy配置并完成重载。HAProxy是高效可靠的负载均衡器，广泛应用于高流量网站。

核心功能

• 无状态设计：仅依赖Marathon，无需第三方状态存储（如ZooKeeper/etcd）
• 实时更新：通过Marathon事件总线接收状态变化，即时更新HAProxy配置
• 多证书TLS支持：可配置多个SSL证书用于HTTPS服务
• 零 downtime部署：支持蓝绿部署和流量拆分，确保服务更新无中断
• 高扩展性：单实例达线速处理能力，多实例提供容错与更高吞吐量
• DC/OS集成：可通过DC/OS包管理器直接安装
• 模板定制：支持全局和应用级HAProxy模板覆盖

使用场景

1. DC/OS集群内服务的负载均衡与服务发现
2. 微服务架构下的流量分发与高可用保障
3. 需要实时配置更新的动态服务环境
4. 要求零 downtime部署的生产级应用场景

配置说明

App Labels配置

在Marathon应用定义中通过标签定制HAProxy行为，示例：

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

• HAPROXY_GROUP：指定负载均衡器组，仅同组LB处理该应用
• HAPROXY_{n}_VHOST：为应用设置虚拟主机（n为服务端口索引）

SSL证书配置

• 环境变量：HAPROXY_SSL_CERT（单个证书）或HAPROXY_SSL_CERT0-HAPROXY_SSL_CERT100（多个证书）
• 命令行参数：--ssl-certs指定证书路径列表

Docker部署示例

SSE模式（实时事件监听）

bash
docker run -e PORTS=9090 --net=host docker.xuanyuan.run/mesosphere/marathon-lb sse --marathon http://your-marathon-ip:8080

• PORTS：HAProxy绑定端口
• sse：通过Marathon事件总线接收状态变化

Poll模式（定期轮询）

bash
docker run -e PORTS=9090 -e POLL_INTERVAL=30 --net=host docker.xuanyuan.run/mesosphere/marathon-lb poll --marathon http://your-marathon-ip:8080

• POLL_INTERVAL：轮询间隔（默认60秒）
• poll：定期轮询Marathon API获取状态变化