fmeriot/rancher-registrator

概述

本项目旨在为通过Rancher部署的所有容器实现Consul中的第三方注册。自Rancher v1.2.0发布并迁移至CNI框架后，Registrator无法再识别容器的端口映射，本工具通过依赖Docker套接字（docker.sock）和Rancher元数据API解决该问题。

要求与限制

• 需要在基础设施的每个主机上以容器形式运行，且需与本地consul-agent一同部署以完成服务注册。
• 目前仅支持Consul后端，Etcd和Zookeeper暂未支持。

使用说明

需从Rancher启动该容器，配置要求如下：

1. 网络模式设为"host"
2. 添加两个Rancher标签：
   • -l io.rancher.container.network=false
   • -l io.rancher.container.dns=true
3. 映射主机的Docker套接字：
   • -v /var/run/docker.sock:/var/run/docker.sock

启动命令示例：

bash
docker run -it --net=host -v /var/run/docker.sock:/var/run/docker.sock --label io.rancher.container.network=false --label io.rancher.container.dns=true --name=registrator docker.xuanyuan.run/fmeriot/rancher-registrator

可选环境变量：

• SVC_PREFIX：用于为Consul中的服务名称添加前缀（测试场景使用）
• LOCAL_CONSUL_AGENT：默认值为"http://localhost:8500%22%EF%BC%8C%E5%8F%AF%E6%A0%B9%E6%8D%AE%E9%9C%80%E8%A6%81%E4%BF%AE%E6%94%B9

标签说明

移植了原Registrator的基础标签功能：

• SERVICE_NAME：覆盖Consul中注册的服务名称
• SERVICE_IGNORE：设为true时，忽略该服务的注册
• SERVICE_TAGS：逗号分隔的字符串列表，作为Consul中的服务标签（暂不支持JSON格式）
• SERVICE_[private_port]_NAME：为特定端口声明不同的服务名称
• SERVICE_[private_port]_CHECK_HTTP：注册服务时同时声明健康检查路径，例如SERVICE_9000_CHECK_HTTP=/api/ping
• SERVICE_[private_port]_CHECK_INTERVAL：健康检查频率，默认值为10s
• SERVICE_[private_port]_CHECK_TIMEOUT：健康检查超时时间，超时则视为检查不通过

公共Docker Hub镜像

该项目自动构建的镜像地址为：https://hub.docker.com/r/fmeriot/rancher-registrator/
拉取镜像命令：

bash
docker pull docker.xuanyuan.run/fmeriot/rancher-registrator