nginx-upsync-module
是由王晓开用C开发的nginx模块,用于从consul或其它同步upstream模块配置,动态修改后端服务属性(weight、max_fails等等)。修改这些信息后,不像未使用该模块的nginx同样须要reload下nginx。
nginx在做为负载均衡角色时,对于单台nginx,增长、删除后端服务,对于进行单台的nginx,修改nginx配置文件后,要想配置文件生效,必须reload下nginx,这是很方便的。可是对于一个十几台或者几十台的nginx集群,要实现这是一个很大的一个工做量。而且reload nginx会增长系统负载也会暂时下降性能。
nginx-upsync-module
能够很容易解决上面所提到的问题,而且也不会影响性能。 该模块如今仍处于开发,不过已经准备用于生产环境。建议和后端健康检测模块nginx_upstream_check_module
配合使用。nginx
master分支兼容1.9版本及以上的nginx。nginx-upsync-1.8.x兼容1.8版本的nginx。后端
该模块提供了发现后端的方法。支持经过consul动态添加和删除后端服务和调整后端服务的weight
、fail_timeout
、max_fails
等属性。也会从consul
获取新的后端服务并同步到nginx的IP路由表。该模块具备如下优点: api
及时性
会发送给consul
带有索引的key,consul会将该索引和consul的索引进行对比,若是索引没有改变,连接会挂起5分钟,在这期间,对该key-value的任何操做,都会立马获得反馈。服务器
几乎无性能损失
从consul获取后端服务器列表,对于nginx来讲就至关于一个请求。更新nginx的IP路由表,不须要reload nginx,所以只会对nginx的性能有一点影响。微信
稳定
若是此次获取服务器失败,在下一个同步间隔仍会获取服务器列表。这样就保证了后端服务提供服务的稳定性。同时,支持将最近的配置文件备份到本地,即便consul故障宕机了,nginx仍能够随时能够reload配置。
负载均衡
健康检测
该模块支持对后端服务的健康检测,不过须要nginx_upstream_check_module
。所以建议nginx-upsync-module
和nginx_upstream_check_module
配合使用。ide
upsync性能
语法:upsync $consul.api.com:$port/v1/kv/upstreams/$upstream_name [upsync_type=consul] [upsync_interval=seconds/minutes] [upsync_timeout=seconds/minutes] [strong_dependency=off/on]; 默认:upsync_interval=5s upsync_timeout=6m strong_dependency=off 位置:upstream 功能:从consul或etcd获取服务列表
参数解释
upsync_interval:
从consul获取服务列表的间隔时间
upsync_timeout
从consul获取服务列表的请求超时时间
upsync_type
指定从什么类型的服务(consul或etcd)获取服务列表。
strong_dependency
nginx启动是否强制依赖upsync_type指定的服务的开关。若是upsync_type指定的是consul,在nginx启动是,consul并未运行,那么nginx启动会失败。 spa
upsync_dump_pathcode
语法: upsync_dump_path $path; 默认:/tem/servers_$host.conf 位置:upstream 功能:备份upstream配置的后端服务器到指定的路径下
upsync_lb
语法:upsync_lb round_robin/ip_hash/hash 默认:round_robin 位置:upstream 功能:指定使用的调度方法
upstream_show
语法:upstream_show; 默认:None 位置:location 功能:列出指定的upstream配置的全部后端服务器
更多精彩请关注微信公众号: