Gru是一个长连接服务解决方案，可用于各种类型的实时交互应用。

• common 通用的一些代码、工具类等
• idgen 消息id、某些业务id生成服务
• ticket
  • 处于最前端，客户端首先请求该服务拿到ticket才能建立长连接
  • 目前实现了基于一致性hash的负载均衡，将客户端路由到不同的spear节点
  • 其它位于前端的策略，如准入机制等可在此模块扩展
• stat 统计模块、业务模块
  • 目前实现了在线统计，数据存储在redis
  • 若还需要后端接入其他业务服务，可在此模块扩展
• spear 长连接服务模块
  • 提供长连接接入的模块
  • 最小化模式部署时只需要此模块的一个实例即可
• minions 监控模块
  • 目前可监控集群长连接服务spear节点数、每个节点的用户数等
  • 节点间管理、用户管理可在此模块扩展
• spear-client 客户端模拟，压测示例代码
• 示例项目: gru-example
  • 以IM作为示例展示基于Gru构建实时应用
  • 支持群聊和单聊

• 支持单点部署和集群模式部署
• 采用socket.io协议
• 各模块均支持水平扩展
• 单节点可服务10W 以上长连接，具体为在不断发消息的情况下(1000条/秒)，单长连接服务节点支持的稳定连接数量在10W (8核16G)
• 节点间通讯支持多种方式：进程内、redis、rocketmq

git clone https://github.com/sumory/gru.git /data/tmp/gru

如果只想体验单节点的部署模式，不需要监控、负载均衡及其它业务服务，只需要部署一个spear节点即可。部署方式如下：

cd /data/tmp/gru
mvn install #本地安装
cd spear
mvn clean package -Pdev #生成spear可运行包，使用dev的配置文件
cd target/release #该目录下有所有spear运行需要的文件
ll conf # 主要配置文件位于conf/system.properties下，默认以single模式运行，不依赖zookeeper/redis等
sh bin/start.sh # 启动

以上步骤完成后即可在本地的31001端口开启一个spear实例监听，等待客户端连接。

若想查看如何使用该spear实例，请移步gru-example,启动该项目，访问http://127.0.0.1:60000即可。

集群的安装配置较为复杂，详见Gru集群安装配置