這里將進行簡單的部署和配置,在配置之前,需要先了解一定的拓撲情況
類目 屬性 備注
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管理進程