最近公司打算起一个IM的项目, 让所有人参与预研一下,本着学习的态度, 将goim环境的搭建过程在这里做个记录
大佬直接绕过就好,菜鸟进来看看
1. 出于性能方面的考虑,计划使用go语言来做开发
a. go语言学习,初步入门, 看菜鸟教程就好,简单易入手
b.重新开发,那是不可能的,一个im框架,协议,缓存, 消息队列, 分布式管理, 想要短时间内完成,不可能
上github, goim这个框架star 3k+, 可以一试, 源码地址
2. 好了,选好了框架, 接下去就是起个demo(?hello world)
看到goim的架构图, 就知道这事没那么简单(倾删)
依赖还挺多, discovery, kafka, redis。redis还好,这kafka不熟啊, 还有discovery是什么玩意儿?
kafka一个高性能分布式消息队列, 用来存数据;
redis用来存储一些在线状态数据
discovery用来做服务治理的。
3. goim代码环境,这个相对比较简单
a.搭建golang环境, 怎么配置,看这里就好了,看不懂,自行百度就好, 没有特别要求
b. 环境好了, clone一下goim源码到GOPATH/src/目录底下
c.安装goim依赖, github上都有说明,过程不报错就是下载成功了
4. redis以及kafka
可以自己下载安装包进行安装,测试:redis安装包,kafka安装包, 这里顺便附上kafka简单文档
繁琐, 但是傻瓜式操作, 到这里各个组件独立部分的安装就结束了。但是, 怎么能这么玩呢?必须装一下逼
还记得docker这么个好东西吗, 必须用起来啊, 安装环境什么的,自己是不可能去安装了, 上docker。
docker看起来还是麻烦啊,还要拉取镜像, 做配置, 启动容器...
docker-compose怎样, 工具就是拿来用的(docker-compose环境怎么装, 自行百度,不会的留言)
我自己简单弄了一个用于运行demo的docker-compose.yml配置文件,如下(可以直接用哦)
version: '2'
services:
zookeeper:
image: wurstmeister/zookeeper
ports:
- "2181:2181"
networks:
- dev
redis:
image: redis
ports:
- "6379:6379"
networks:
- dev
kafka:
image: wurstmeister/kafka
ports:
- "9094:9094"
environment:
KAFKA_CREATE_TOPICS: "goim-push-topic"
KAFKA_ADVERTISED_LISTENERS: INSIDE://kafka:9092,OUTSIDE://127.0.0.1:9094
KAFKA_LISTENERS: INSIDE://kafka:9092,OUTSIDE://kafka:9094
KAFKA_LISTENER_SECURITY_PROTOCOL_MAP: INSIDE:PLAINTEXT,OUTSIDE:PLAINTEXT
KAFKA_INTER_BROKER_LISTENER_NAME: INSIDE
KAFKA_ZOOKEEPER_CONNECT: zookeeper:2181
volumes:
- /var/run/docker.sock:/var/run/docker.sock
networks:
- dev
networks:
dev:
driver: bridge
配置看不懂, 没关系,看这里
创建一个文件夹,放入这个文件,执行
docker-compse up -d
redis+zookeeper+kafka 几个环境全部OK
5 discovery, 服务发现依赖(b站出的)
不建议使用源码编译, 因为依赖有点乱, 根本编译不了好伐。
直接下载编译好的文件,直接下载
运行命令如下
./discovery -conf {path-to-config}/discovery-example.toml
配置当中的IP地址自行替换成启动该服务的IP地址
6. 依赖的模块都安装好了, 接下去就是起demo了
目录切换到goim源码底下
go build
在源码底下生成target目录,target底下其他文件不用看, 就看三个comet.toml, logic.toml, job.toml
我这里给出几个配置样例, 具体的IP要根据,每个服务所在IP和端口号
comet.toml文件如下
# This is a TOML document. Boom
#discovery服务IP以及地址
[discovery]
nodes = ["192.168.65.130:7171"]
[rpcServer]
addr = ":3109"
timeout = "1s"
[rpcClient]
dial = "1s"
timeout = "1s"
[tcp]
bind = [":3101"]
sndbuf = 4096
rcvbuf = 4096
keepalive = false
reader = 32
readBuf = 1024
readBufSize = 8192
writer = 32
writeBuf = 1024
writeBufSize = 8192
[websocket]
bind = [":3102"]
tlsOpen = false
tlsBind = [":3103"]
certFile = "../../cert.pem"
privateFile = "../../private.pem"
[protocol]
timer = 32
timerSize = 2048
svrProto = 10
cliProto = 5
handshakeTimeout = "8s"
[whitelist]
Whitelist = [123]
WhiteLog = "/tmp/white_list.log"
[bucket]
size = 32
channel = 1024
room = 1024
routineAmount = 32
routineSize = 1024
logic.toml文件如下
# This is a TOML document. Boom
#discovery服务IP端口号
[discovery]
nodes = ["192.168.65.130:7171"]
[regions]
"bj" = ["北京","天津","河北","山东","山西","内蒙古","辽宁","吉林","黑龙江","甘肃","宁夏","新疆"]
"sh" = ["上海","江苏","浙江","安徽","江西","湖北","重庆","陕西","青海","河南","台湾"]
"gz" = ["广东","福建","广西","海南","湖南","四川","贵州","云南","西藏","香港","澳门"]
[node]
#goim相关域名和端口号设置, 需要和comet当中对应
defaultDomain = "localhost"
hostDomain = "localhost"
heartbeat = "4m"
heartbeatMax = 2
tcpPort = 3101
wsPort = 3102
wssPort = 3103
regionWeight = 1.6
[backoff]
maxDelay = 300
baseDelay = 3
factor = 1.8
jitter = 0.3
[rpcServer]
network = "tcp"
addr = ":3119"
timeout = "1s"
[rpcClient]
dial = "1s"
timeout = "1s"
[httpServer]
network = "tcp"
addr = ":3111"
readTimeout = "1s"
writeTimeout = "1s"
#kafka配置
[kafka]
topic = "goim-push-topic"
brokers = ["192.168.65.130:9094"]
#redis配置
[redis]
network = "tcp"
addr = "192.168.65.130:6379"
active = 60000
idle = 1024
dialTimeout = "200ms"
readTimeout = "500ms"
writeTimeout = "500ms"
idleTimeout = "120s"
expire = "30m"
job.toml文件如下
[discovery]
nodes = ["192.168.65.130:7171"]
[kafka]
topic = "goim-push-topic"
group = "goim-push-group-job"
brokers = ["192.168.65.130:9094"]
切会goim源码目录
make run
到这里, goim的服务已经启用完毕
7. 结合client测试服务启动情况
goim在github已经给出了例子
将这几个文件拷贝到任意目录,修改websocket的访问IP(即goim启用服务器的IP或域名), 如果直接使用上述配置文件里的端口号,那么就不用改端口后, 编译一下main.go文件,直接run生成的main文件
打开浏览器, 输入客户端所在IP或域名
http://{your-ip-address}:{port_number}
看到status=ok, 说明启用成功
第二个红圈划出来的就是测试消息发送的命令行,将域名改成goim服务所在IP或者名称, 就可以测试了
如果在下面message那块出现你发送的消息, 恭喜你,demo好了
备注:
1. 配置文件当中的IP地址就是哪些服务所在的IP地址,请自行修改(过程有任何问题,欢迎留言)
2. 当然,到这里, 也仅仅是demo阶段,具体的业务逻辑,需要修改goim代码(开源的,放心用)
我这里使用的redis和kafka都是单机形式, 生产上一般都会使用高可用, 有时间再详细说明。