1,安装go语言环境,(Go版本要求1.3以上)

wget https://storage.googleapis.com/golang/go1.6.3.linux-amd64.tar.gz

tar -C /usr/local/ -xzf go1.6.3.linux-amd64.tar.gz

配置环境变量,在/etc/profile中加入下列设置:

export GOROOT=/usr/local/go  

export PATH=$GOROOT/bin:$PATH  

创建工作区/usr/local/go/work(自己指定目录),在/etc/profile中加入下列设置:

export GOPATH=/usr/local/go/work

2,安装git

yum install -y git


3,安装kingshard

git clone https://github.com/flike/kingshard.git src/github.com/flike/kingshard

cd src/github.com/flike/kingshard

source ./dev.sh

make


4, 设置配置文件

etc目录下面有两个配置文件模板,对应shard和非shard版本,可根据需求自由选择。

cat unshard.yaml

addr : 0.0.0.0:9696

user :  kingshard

password : kingshard

log_level : warn


nodes :

-

    name : node1

    max_conns_limit : 32

    user :  kingshard

    password : kingshard


    master : 172.31.18.104:3306

    slave : 172.31.18.105:3306@1,172.31.38.150:3306@1

    down_after_noalive : 32


schema :

    db : kingshard

    nodes: [node1]

    default: node1

    shard:

    -


5,按照配置文件里面的设置对用户授权

GRANT ALL PRIVILEGES ON *.* TO 'kingshard'@'172.31.38.151' IDENTIFIED BY 'kingshard';



7. 运行kingshard。

./bin/kingshard -config=etc/unshard.yaml

ps -ef | grep kingshard

root      6942 26963  0 02:44 pts/2    00:00:00 ./bin/kingshard -config=etc/unshard.yaml



8. 配置文件参数说明

# kingshard的地址和端口

addr : 0.0.0.0:9696


# 连接kingshard的用户名和密码

user :  kingshard

password : kingshard


# 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

#日志文件路径,如果不配置则会输出到终端。

log_path : /Users/flike/log


# sql黑名单文件路径

# 所有在该文件中的sql都会被kingshard拒绝转发

#blacklist_sql_file: /Users/flike/blacklist


# 只允许下面的IP列表连接kingshard,如果不配置则对连接kingshard的IP不做限制。

allow_ips: 127.0.0.1


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

#proxy_charset: utf8mb4


# 一个node节点表示mysql集群的一个数据分片,包括一主多从(可以不配置从库)

nodes :

-

    #node节点名字

    name : node1


    # 连接池中最大空闲连接数,也就是最多与后端DB建立max_conns_limit个连接

    max_conns_limit : 16


    # kingshard连接该node中mysql的用户名和密码,master和slave的用户名和密码必须一致

    user :  kingshard

    password : kingshard


    # master的地址和端口

    master : 127.0.0.1:3306


    # slave的地址、端口和读权重,@后面的表示该slave的读权重。可不配置slave

    #slave : 192.168.0.12@2,192.168.0.13@3

    #kingshard在300秒内都连接不上mysql,kingshard则会下线该mysql

    down_after_noalive : 300

-

    name : node2

    max_conns_limit : 16

    user :  kingshard

    password : kingshard


    master : 192.168.59.103:3307

    slave :

    down_after_noalive: 100


# 分表规则

schema :

    #分表使用的db,所有的分表必须都在这个db中,连接ks时如果没有指定database默认使用该db。

    db : kingshard

    #分表分布的node名字

    nodes: [node1,node2]

    #所有未分表的SQL,都会发往默认node。

    default: node1

    shard:

    -

        #分表名字

        table: test_shard_hash

        #分表字段

        key: id

        #分表分布的node

        nodes: [node1, node2]

        #分表类型

        type: hash

        #子表个数分布,表示node1有4个子表,

        #node2有4个子表。

        locations: [4,4]


    -

        #分表名字

        table: test_shard_range

        #分表字段

        key: id

        #分表类型

        type: range

        #分表分布的node

        nodes: [node1, node2]

        #子表个数分布,表示node1有4个子表,

        #node2有4个子表。

        locations: [4,4]

        #表示每个子表包含的最大记录数,也就是说每

        #个子表最多包好10000条记录。即子表1对应的id为[0,10000),子表2[10000,20000)....

        table_row_limit: 10000



kingshard采用的是yaml方式解析配置文件,需要注意的是yaml配置文件不允许出现tab键,且冒号后面需要跟一个空格。配置文件编写完成后,可以在yaml lint网站验证是否有格式错误


参考:https://github.com/flike/kingshard/blob/master/doc/KingDoc/kingshard_install_document.md