中间件kingshard入门(一):基本安装

这里将进行简单的部署和配置,在配置之前，需要先了解一定的拓扑情况

类目           属性                备注

kingshard  10.11.10.214  无

master       10.11.10.215 主库

slave         10.11.10.216  读库

详细了解地址 https://github.com/flike/kingshard/blob/master/README_ZH.md

安装

由于kingshard使用的是go语言开发。故此需要在kingshard这台机器中安装对应的go支持的编译软件(go版本为1.6以上)

[root@gzsd-ks01-101110214 ~]# yum -y install go git
[root@gzsd-ks01-101110214 ~]# mkdir /data/download
[root@gzsd-ks01-101110214 ~]# cd /data/download/
[root@gzsd-ks01-101110214 download]# git clone https://github.com/flike/kingshard.git /etc/kingshard
[root@gzsd-ks01-101110214 download]# cd /etc/kingshard/
[root@gzsd-ks01-101110214 kingshard]# source ./dev.sh
[root@gzsd-ks01-101110214 kingshard]# make

到这里，编译完成，对配置文件进行修改

[root@gzsd-ks01-101110214 kingshard]# cp etc/ks.yaml etc/ks.yaml.bak
[root@gzsd-ks01-101110214 kingshard]# vi etc/ks.yaml

# kingshard的地址和端口
addr : 0.0.0.0:9696

# prometheus server listen addr
prometheus_addr : 0.0.0.0:7080

# 连接kingshard的用户名和密码的用户列表
user_list:
-
user : root
password : root
# -
# user : kingshard 注册一个账号
# password : kingshard

#kingshard的web API 端口
web_addr : 0.0.0.0:9797
#调用API的用户名和密码
web_user : admin
web_password : admin

# if set log_path, the sql log will write into log_path/sql.log,the system log
# will write into log_path/sys.log
# log_path : /Users/flike/log

# log级别，[debug|info|warn|error],默认是error
log_level : debug

# 打开SQL日志，设置为on;关闭SQL日志，设置为off
log_sql: on

#如果设置了该项，则只输出SQL执行时间超过slow_log_time(单位毫秒)的SQL日志，不设置则输出全部SQL日志
#slow_log_time : 100

# the path of blacklist sql file
# all these sqls in the file will been forbidden by kingshard
#blacklist_sql_file: /Users/flike/blacklist

# 只允许下面的IP列表连接kingshard，如果不配置则对连接kingshard的IP不做限制。
# support ip and ip segment
#allow_ips : 127.0.0.1,192.168.15.0/24

# kingshard使用的字符集，如果不设置该选项，则kingshard使用utf8作为默认字符集
proxy_charset: utf8mb4

# node is an agenda for real remote mysql server.
nodes :
-
#node节点名字
name : node1

# 连接池中最大空闲连接数，也就是最多与后端DB建立max_conns_limit个连接
max_conns_limit : 32
# kingshard连接该node中mysql的用户名和密码，master和slave的用户名和密码必须一致 grant option设置的密码需要一致

user : root
password : root

# master的地址和端口
master : 192.168.248.130:3306

# slave的地址、端口和读权重，@后面的表示该slave的读权重。可不配置slave
#slave : 192.168.59.101:3307@2,192.168.59.101:3307@3
slave : 192.168.248.131:3306@3
#down_after_noalive : 32
#kingshard在300秒内都连接不上mysql，kingshard则会下线该mysql
down_after_noalive : 32

# schema defines sharding rules, the db is the sharding table database.
schema_list :
-
#schema的所属用户名
user: root
#分表分布的node名字
nodes: [node1]
#所有未分表的SQL，都会发往默认node。
default: node1
shard:
-
#分表使用的db
db : kingshard
#分表名字
table: test_shard_hash
#分表字段
key: id
#分表分布的node
nodes: [node1]
#分表类型
type: hash
#子表个数分布，表示node1有4个子表，
locations: [4]

-
db : hidb
table: test_hash
key: id
nodes: [node1]
type: hash
locations: [4]
-
db : kingshard
table: test_shard_range
key: id
type: range
nodes: [node1]
locations: [4]
#个子表最多包好10000条记录。即子表1对应的id为[0,10000),子表2[10000,20000)....
table_row_limit: 10000
# -
# db : kingshard
# table: test_shard_time
# key: id
# nodes: [node1]
# type: hash
# locations: [2]
# -
# db : kingshard
# table: test_shard_month
# key: dtime
# type: date_month
# nodes: [node1]
# date_range: [201603-201605,201609-201612]
# -
# db : kingshard
# table: test_shard_day
# key: mtime
# type: date_day
# nodes: [node1]
# date_range: [20160306-20160307,20160308-20160309]

建立软连接

ln /etc/kingshard /usr/bin/kingshard

测试使用screen来执行启动脚本

[root@gzsd-ks01-101110214 kingshard]# yum -y install screen
[root@gzsd-ks01-101110214 kingshard]# screen -R ks
[root@gzsd-ks01-101110214 kingshard]# kingshard --config=etc/ks.yaml

可以用supervisor管理进程