mayuresh82/gocast

GoCast

GoCast是一款从主机控制BGP路由公告的工具，它运行自定义健康检查并向BGP对等体公告或撤回路由（最常见的是VIP或虚拟IP）。其核心应用场景是基于任播（VIP）的基础设施服务（如DNS、Syslog等）负载均衡——地理分布的多个实例公告相同的任播VIP，客户端会被引导至最近的可用实例。

核心功能

1. BGP路由管理：通过GoBGP库与远程对等体（如TOR交换机）建立连接，动态公告/撤回路由；
2. 健康检查机制：支持端口监控、命令执行监控及Consul健康检查，确保仅健康节点保留路由；
3. 多方式注册：应用可通过HTTP调用、配置文件或Consul自动发现注册到GoCast；
4. Consul集成：自动发现Consul中的服务并同步健康状态；
5. 容器化支持：提供Docker镜像，适配容器化环境的网络需求。

使用场景

• 任播VIP负载均衡：DNS、Syslog等服务的地理分布式部署，实现就近访问；
• 服务高可用：当节点服务故障时自动撤回路由，避免流量流向故障节点；
• 容器化服务管理：监控容器内服务状态，适配Nomad等编排工具的网络场景。

配置说明

注册方式

1. HTTP调用：
   向GoCast实例发送HTTP请求注册应用：

   bash
   http://gocast-addr/register?name=<appName>&vip=<addr/mask>&monitor=port:tcp:5000
   

   支持多个监控器（需全部通过才视为健康）。
2. 配置文件：在config.yaml中定义自定义应用（参考示例文件）；
3. Consul自动发现：服务需添加Consul标签enable_gocast（必填）、gocast_vip=<addr/mask>（必填）、gocast_monitor=monitor:params（可选）。

监控器类型

• 端口监控：格式port:protocol:portnum（如port:tcp:5000）；
• 执行监控：格式exec:command（命令退出码为0视为健康）；
• Consul监控：直接使用consul，同步Consul自身的健康检查结果。

Docker部署示例

GoCast容器需启用NET_ADMIN权限和主机网络模式：

bash
docker run -d \
  --cap-add=NET_ADMIN \
  --net=host \
  -v /path/to/host-config:/path/to/container-config \
  mayuresh82/gocast \
  -config=/path/to/config.yaml \
  -logtostderr

注意事项

• 容器内被监控服务需监听0.0.0.0（而非特定IP）；
• 若使用Nomad等编排工具，可通过以下方式解决端口监听问题：
  1. 服务容器启用主机网络模式；
  2. 添加nat=protocol:port标签（如Consul或HTTP注册时），GoCast会自动创建NAT规则映射VIP到物理IP。

设计优势

相比ExaBGP等工具，GoCast提供开箱即用的容器化支持，避免脚本拼凑，API更简洁且文档完善，适用于现代基础设施的服务管理需求。