redis-trib.rb命令詳解

redis-trib.rb命令詳解
redis-trib.rb是官方提供的Redis Cluster的管理工具，無需額外下載，默認(rèn)位于源碼包的src目錄下，但因該工具是用ruby開發(fā)的，所以需要準(zhǔn)備相關(guān)的依賴環(huán)境。

成都創(chuàng)新互聯(lián)公司2013年開創(chuàng)至今，是專業(yè)互聯(lián)網(wǎng)技術(shù)服務(wù)公司，擁有項(xiàng)目成都網(wǎng)站設(shè)計(jì)、成都網(wǎng)站制作網(wǎng)站策劃，項(xiàng)目實(shí)施與項(xiàng)目整合能力。我們以讓每一個(gè)夢(mèng)想脫穎而出為使命，1280元濰坊做網(wǎng)站,已為上家服務(wù),為濰坊各地企業(yè)和個(gè)人服務(wù),聯(lián)系電話:18982081108

官網(wǎng)：https://redis.io/documentation
中文官網(wǎng)：http://www.redis.cn/documentation.html

1 redis-trib.rb支持的操作

[root@node1 src]# ./redis-trib.rb help
Usage: redis-trib <command> <options> <arguments ...>

  create          host1:port1 ... hostN:portN
                  --replicas <arg>
  check           host:port
  info            host:port
  fix             host:port
                  --timeout <arg>
  reshard         host:port
                  --from <arg>
                  --to <arg>
                  --slots <arg>
                  --yes
                  --timeout <arg>
                  --pipeline <arg>
  rebalance       host:port
                  --weight <arg>
                  --auto-weights
                  --use-empty-masters
                  --timeout <arg>
                  --simulate
                  --pipeline <arg>
                  --threshold <arg>
  add-node        new_host:new_port existing_host:existing_port
                  --slave
                  --master-id <arg>
  del-node        host:port node_id
  set-timeout     host:port milliseconds
  call            host:port command arg arg .. arg
  import          host:port
                  --from <arg>
                  --copy
                  --replace
  help            (show this help)

For check, fix, reshard, del-node, set-timeout you can specify the host and port of any working node in the cluster.
[root@node1 src]#

支持的操作如下：

create：創(chuàng)建集群
check：檢查集群
info：查看集群信息
fix：修復(fù)集群
reshard：在線遷移slot
rebalance：平衡集群節(jié)點(diǎn)slot數(shù)量
add-node：將新節(jié)點(diǎn)加入集群
del-node：從集群中刪除節(jié)點(diǎn)
set-timeout：設(shè)置集群節(jié)點(diǎn)間心跳連接的超時(shí)時(shí)間
call：在集群全部節(jié)點(diǎn)上執(zhí)行命令
import：將外部redis數(shù)據(jù)導(dǎo)入集群

對(duì)于check，fix，reshard，del-node，set-timeout，您可以指定集群中任何工作節(jié)點(diǎn)的主機(jī)和端口。

2 創(chuàng)建集群

用戶無需指定哪臺(tái)節(jié)點(diǎn)為master，哪臺(tái)節(jié)點(diǎn)為slave，因?yàn)閞edis內(nèi)部算法幫我們實(shí)現(xiàn)了,也可以先創(chuàng)建主節(jié)點(diǎn)，然后再指定從節(jié)點(diǎn)；

create
--replicas # 可選參數(shù)，replicas表示每個(gè)master需要有幾個(gè)slave。
只有master節(jié)點(diǎn)的創(chuàng)建方式

./redis-trib.rb create 192.168.1.101:7000 192.168.1.102:7000 192.168.1.103:7000 192.168.1.104:7000 192.168.1.105:7000 192.168.1.106:7000

使用 --replicas 1 創(chuàng)建每個(gè)master帶一個(gè) slave 指令

./redis-trib.rb create --replicas 1 192.168.1.101:7000 192.168.1.102:7000 192.168.1.103:7000 192.168.1.104:7000 192.168.1.105:7000 192.168.1.106:7000

16384個(gè)槽全部被分配，集群創(chuàng)建成功。注意：給redis-trib.rb的節(jié)點(diǎn)地址必須是不包含任何槽/數(shù)據(jù)的節(jié)點(diǎn)，否則會(huì)拒絕創(chuàng)建集群。

關(guān)于主從節(jié)點(diǎn)的選擇及槽的分配，其算法如下：

把節(jié)點(diǎn)按照host分類，這樣保證master節(jié)點(diǎn)能分配到更多的主機(jī)中。
遍歷host列表，從每個(gè)host列表中彈出一個(gè)節(jié)點(diǎn)，放入interleaved數(shù)組。直到所有的節(jié)點(diǎn)都彈出為止。
將interleaved數(shù)組中前master個(gè)數(shù)量的節(jié)點(diǎn)保存到masters數(shù)組中。
計(jì)算每個(gè)master節(jié)點(diǎn)負(fù)責(zé)的slot數(shù)量，16384除以master數(shù)量取整，這里記為N。
遍歷masters數(shù)組，每個(gè)master分配N個(gè)slot，最后一個(gè)master，分配剩下的slot。
接下來為master分配slave，分配算法會(huì)盡量保證master和slave節(jié)點(diǎn)不在同一臺(tái)主機(jī)上。對(duì)于分配完指定slave數(shù)量的節(jié)點(diǎn)，還有多余的節(jié)點(diǎn)，也會(huì)為這些節(jié)點(diǎn)尋找master。分配算法會(huì)遍歷兩次masters數(shù)組。
第一次遍歷master數(shù)組，在余下的節(jié)點(diǎn)列表找到replicas數(shù)量個(gè)slave。每個(gè)slave為第一個(gè)和master節(jié)點(diǎn)host不一樣的節(jié)點(diǎn)，如果沒有不一樣的節(jié)點(diǎn)，則直接取出余下列表的第一個(gè)節(jié)點(diǎn)。
第二次遍歷是分配節(jié)點(diǎn)數(shù)除以replicas不為整數(shù)而多出的一部分節(jié)點(diǎn)。

3 檢查集群情況：check

指定任意一個(gè)節(jié)點(diǎn)即可。

./redis-trib.rb check 192.168.1.101:7000

顯示：

[root@NUC-2 src]# ./redis-trib.rb check 192.168.1.101:7000
>>> Performing Cluster Check (using node 192.168.1.101:7000)
S: afaa82815a7fc2d0e19ffa664677dde03aa8ab36 192.168.1.101:7000
   slots: (0 slots) slave
   replicates 845674c71b1f43f9297501903e616140b2a0a1f6
M: b7cada75939d960f8ca98aad875b8f2e49020b19 192.168.1.102:7000
   slots:5461-10922 (5462 slots) master
   1 additional replica(s)
M: f1946135289c8c76bb9817213cbb1730d9a0b052 192.168.1.103:7000
   slots:10923-16383 (5461 slots) master
   1 additional replica(s)
S: 9f9a36f2da46bd18f9df785900b5a8e3c53b5ca3 192.168.1.106:7000
   slots: (0 slots) slave
   replicates b7cada75939d960f8ca98aad875b8f2e49020b19
M: 845674c71b1f43f9297501903e616140b2a0a1f6 192.168.1.105:7000
   slots:0-5460 (5461 slots) master
   1 additional replica(s)
S: 15fc1bd754a2e02ec571e23c7d81a80c7322a100 192.168.1.104:7000
   slots: (0 slots) slave
   replicates f1946135289c8c76bb9817213cbb1730d9a0b052
[OK] All nodes agree about slots configuration.
>>> Check for open slots...
>>> Check slots coverage...
[OK] All 16384 slots covered.
[root@NUC-2 src]#

4 查看集群信息：info

[root@NUC-2 src]# ./redis-trib.rb info 192.168.20.61:7000
192.168.20.62:7000 (b7cada75...) -> 2 keys | 5462 slots | 1 slaves.
192.168.20.63:7000 (f1946135...) -> 2 keys | 5461 slots | 1 slaves.
192.168.20.65:7000 (845674c7...) -> 4 keys | 5461 slots | 1 slaves.
[OK] 8 keys in 3 masters.
0.00 keys per slot on average.
[root@NUC-2 src]#

5 修復(fù)集群

目前fix命令能修復(fù)兩種異常:

節(jié)點(diǎn)中存在處于遷移中（importing或migrating狀態(tài)）的slot。
節(jié)點(diǎn)中存在未分配的slot。
其它異常不能通過fix命令修復(fù)。

[root@NUC-2 src]# ./redis-trib.rb fix 192.168.20.61:7000
>>> Performing Cluster Check (using node 192.168.20.61:7000)
S: afaa82815a7fc2d0e19ffa664677dde03aa8ab36 192.168.20.61:7000
   slots: (0 slots) slave
   replicates 845674c71b1f43f9297501903e616140b2a0a1f6
M: b7cada75939d960f8ca98aad875b8f2e49020b19 192.168.20.62:7000
   slots:5461-10922 (5462 slots) master
   1 additional replica(s)
M: f1946135289c8c76bb9817213cbb1730d9a0b052 192.168.20.63:7000
   slots:10923-16383 (5461 slots) master
   1 additional replica(s)
S: 9f9a36f2da46bd18f9df785900b5a8e3c53b5ca3 192.168.20.66:7000
   slots: (0 slots) slave
   replicates b7cada75939d960f8ca98aad875b8f2e49020b19
M: 845674c71b1f43f9297501903e616140b2a0a1f6 192.168.20.65:7000
   slots:0-5460 (5461 slots) master
   1 additional replica(s)
S: 15fc1bd754a2e02ec571e23c7d81a80c7322a100 192.168.20.64:7000
   slots: (0 slots) slave
   replicates f1946135289c8c76bb9817213cbb1730d9a0b052
[OK] All nodes agree about slots configuration.
>>> Check for open slots...
>>> Check slots coverage...
[OK] All 16384 slots covered.
[root@NUC-2 src]#

6 在線遷移：slot

格式：

redis-trib.rb reshard host:port --from <arg> --to <arg> --slots <arg> --yes --timeout <arg> --pipeline <arg>

選項(xiàng)：

reshard
host:port：必傳參數(shù)，集群內(nèi)任意節(jié)點(diǎn)地址，用來獲取整個(gè)集群信息。
--from <arg>：需要從哪些源節(jié)點(diǎn)上遷移slot，可從多個(gè)源節(jié)點(diǎn)完成遷移，以逗號(hào)隔開，傳遞的是節(jié)點(diǎn)的node id，還可以直接傳遞--from all，這樣源節(jié)點(diǎn)就是集群的所有節(jié)點(diǎn)，不傳遞該參數(shù)的話，則會(huì)在遷移過程中提示用戶輸入。
--to <arg>：slot需要遷移的目的節(jié)點(diǎn)的node id，目的節(jié)點(diǎn)只能填寫一個(gè)，不傳遞該參數(shù)的話，則會(huì)在遷移過程中提示用戶輸入。
--slots <arg>：需要遷移的slot數(shù)量，不傳遞該參數(shù)的話，則會(huì)在遷移過程中提示用戶輸入。
--yes：設(shè)置該參數(shù)，可以在打印執(zhí)行reshard計(jì)劃的時(shí)候，提示用戶輸入yes確認(rèn)后再執(zhí)行reshard。
--timeout <arg>：控制每次migrate操作的超時(shí)時(shí)間，默認(rèn)為60000毫秒。
--pipeline <arg>：定義cluster getkeysinslot命令一次取出的key數(shù)量，不傳的話使用默認(rèn)值為10。

例：

./redis-trib.rb reshard --from all --to 845674c71b1f43f9297501903e616140b2a0a1f6 --slots 11

7 平衡集群節(jié)點(diǎn)slot數(shù)量

選項(xiàng)：

rebalance       host:port
                  --weight <arg>
                  --auto-weights
                  --use-empty-masters
                  --timeout <arg>
                  --simulate
                  --pipeline <arg>
                  --threshold <arg>

說明

rebalance
host:port：這個(gè)是必傳參數(shù)，用來從一個(gè)節(jié)點(diǎn)獲取整個(gè)集群信息，相當(dāng)于獲取集群信息的入口。
--weight <arg>：節(jié)點(diǎn)的權(quán)重，格式為node_id=weight，如果需要為多個(gè)節(jié)點(diǎn)分配權(quán)重的話，需要添加多個(gè)--weight <arg>參數(shù)，即--weight b31e3a2e=5 --weight 60b8e3a1=5，node_id可為節(jié)點(diǎn)名稱的前綴，只要保證前綴位數(shù)能唯一區(qū)分該節(jié)點(diǎn)即可。沒有傳遞–weight的節(jié)點(diǎn)的權(quán)重默認(rèn)為1。
--auto-weights：這個(gè)參數(shù)在rebalance流程中并未用到。
--threshold <arg>：只有節(jié)點(diǎn)需要遷移的slot閾值超過threshold，才會(huì)執(zhí)行rebalance操作。具體計(jì)算方法可以參考下面的rebalance命令流程的第四步。
--use-empty-masters：rebalance是否考慮沒有節(jié)點(diǎn)的master，默認(rèn)沒有分配slot節(jié)點(diǎn)的master是不參與rebalance的，設(shè)置--use-empty-masters可以讓沒有分配slot的節(jié)點(diǎn)參與rebalance。
--timeout <arg>：設(shè)置migrate命令的超時(shí)時(shí)間。
--simulate：設(shè)置該參數(shù)，可以模擬rebalance操作，提示用戶會(huì)遷移哪些slots，而不會(huì)真正執(zhí)行遷移操作。
--pipeline <arg>：與reshar的pipeline參數(shù)一樣，定義cluster getkeysinslot命令一次取出的key數(shù)量，不傳的話使用默認(rèn)值為10。

例：

redis-trib.rb rebalance --weight 845674c71b1f43f9297501903e616140b2a0a1f6=3 --weight b7cada75939d960f8ca98aad875b8f2e49020b19=2 --use-empty-masters  192.168.20.61:7000

增加一個(gè)主節(jié)點(diǎn)

./redis-trib.rb add-node 192.168.1.107:7000 192.168.1.108:7000

# 添加成功，但是并沒有指定 slot ,所以必須遷移slot節(jié)點(diǎn)
./redis-trib.rb reshard 192.168.1.108:7000

# 提示一 ：How many slots do you want to move (from 1 to 16384)?
為了平衡每個(gè)master管理的slot的個(gè)數(shù)，所以輸入 16384/master  的數(shù)量。如這里為4 那么就是 16384/4 = 4096個(gè)。
輸入 4096

# 提示二：What is the receiving node ID?(接受的node ID是多少)
            890d2c8d989cce50e5fa48e37cd35738887f3f7d # 107的ID

# 提示三： Please enter all the source node IDs.
           Type 'all' to use all the nodes as source nodes for the hash slots.
           Type 'done' once you entered all the source nodes IDs.
                  （要從哪個(gè)節(jié)點(diǎn)中獲取lost ？）
不打算從特定的節(jié)點(diǎn)上取出指定數(shù)量的哈希槽， 那么可以輸入 all
否則輸入某個(gè)節(jié)點(diǎn)的 node ID

# 檢查是否成功
./redis-trib.rb check 192.168.1.108:7000

添加新節(jié)點(diǎn)

格式：

redis-trib add-node new_host:new_port existing_host:existing_port --slave --master-id <arg>

其中，
new_host:new_port：待添加的節(jié)點(diǎn)，必須確保其為空或不在其它集群中。否則，會(huì)提示以下錯(cuò)誤。

[ERR] Node 192.168.1.101:7000 is not empty. Either the node already knows other nodes (check with CLUSTER NODES) or contains some key in database 0.

所以，線上建議使用redis-trib.rb添加新節(jié)點(diǎn)，因?yàn)槠鋾?huì)對(duì)新節(jié)點(diǎn)的狀態(tài)進(jìn)行檢查。如果手動(dòng)使用cluster meet命令加入已經(jīng)存在于其它集群的節(jié)點(diǎn)，會(huì)造成被加入節(jié)點(diǎn)的集群合并到現(xiàn)有集群的情況，從而造成數(shù)據(jù)丟失和錯(cuò)亂，后果非常嚴(yán)重，線上謹(jǐn)慎操作。

existing_host:existing_port：集群中任意一個(gè)節(jié)點(diǎn)的地址。

如果添加的是主節(jié)點(diǎn)，只需指定源節(jié)點(diǎn)和目標(biāo)節(jié)點(diǎn)的地址即可。

redis-trib.rb add-node 192.168.1.101:7000 127.0.0.1:6384

如果添加的是從節(jié)點(diǎn)，其語法如下，

redis-trib.rb add-node --slave --master-id f413fb7e6460308b17cdb71442798e1341b56cbc 192.168.1.101:7000 127.0.0.1:6384

注意：--slave和--master-id必須寫在前面，同樣的參數(shù)，如果是下面這樣寫法，會(huì)提示錯(cuò)誤，

# redis-trib.rb add-node 192.168.1.101:7000 127.0.0.1:6384 --slave --master-id f413fb7e6460308b17cdb71442798e1341b56cbc
[ERR] Wrong number of arguments for specified sub command

添加從節(jié)點(diǎn)，可不設(shè)置--master-id，此時(shí)會(huì)隨機(jī)選擇主節(jié)點(diǎn)。

從節(jié)點(diǎn)會(huì)自動(dòng)匹配主節(jié)點(diǎn)

./redis-trib.rb add-node --slave 127.0.0.1:7007 127.0.0.1:7000

增加從節(jié)點(diǎn)的時(shí)候指定主節(jié)點(diǎn)。

./redis-trib.rb add-node --slave --master-id 890d2c8d989cce50e5fa48e37cd35738887f3f7d 192.168.66.3:7008 192.168.66.2:7000

刪除節(jié)點(diǎn)

格式

redis-trib.rb del-node host:port node_id

參數(shù)：

del-node：刪除節(jié)點(diǎn)的指令；
host:port：從該節(jié)點(diǎn)獲取集群信息；
node_id：需要?jiǎng)h除的節(jié)點(diǎn)id。

在刪除節(jié)點(diǎn)之前，其對(duì)應(yīng)的槽必須為空，所以，在進(jìn)行節(jié)點(diǎn)刪除動(dòng)作之前，必須使用redis-trib.rb reshard將其遷移出去。

需要注意的是，如果某個(gè)節(jié)點(diǎn)的槽被完全遷移出去，其對(duì)應(yīng)的slave也會(huì)隨著更新，指向遷移的目標(biāo)節(jié)點(diǎn)。

./redis-trib.rb del-node 192.168.66.2:7000 d5f6d1d17426bd564a6e309f32d0f5b96962fe53

設(shè)置節(jié)點(diǎn)的超時(shí)時(shí)間

redis-trib.rb set-timeout host:port milliseconds

其實(shí)就是批量修改集群各節(jié)點(diǎn)的cluster-node-timeout參數(shù)。

# redis-trib.rb set-timeout 192.168.1.101:7000 20000
/usr/local/ruby/lib/ruby/gems/2.5.0/gems/redis-3.3.0/lib/redis/client.rb:459: warning: constant ::Fixnum is deprecated
>>> Reconfiguring node timeout in every cluster node...
*** New timeout set for 192.168.1.101:7000
*** New timeout set for 192.168.1.102:7000
*** New timeout set for 192.168.1.103:7000
*** New timeout set for 192.168.1.104:7000
*** New timeout set for 192.168.1.105:7000
*** New timeout set for 192.168.1.106:7000
>>> New node timeout set. 6 OK, 0 ERR.

將外部redis數(shù)據(jù)導(dǎo)入集群

redis-trib.rb import --from 127.0.0.1:6378 127.0.0.1:6379

其內(nèi)部處理流程如下：

1> 通過load_cluster_info_from_node方法加載集群信息，check_cluster方法檢查集群是否健康。

2> 連接外部redis節(jié)點(diǎn)，如果外部節(jié)點(diǎn)開啟了cluster_enabled，則提示錯(cuò)誤（[ERR] The source node should not be a cluster node.）

3> 通過scan命令遍歷外部節(jié)點(diǎn)，一次獲取1000條數(shù)據(jù)。

4> 遍歷這些key，計(jì)算出key對(duì)應(yīng)的slot。

5> 執(zhí)行migrate命令,源節(jié)點(diǎn)是外部節(jié)點(diǎn),目的節(jié)點(diǎn)是集群slot對(duì)應(yīng)的節(jié)點(diǎn)，如果設(shè)置了--copy參數(shù)，則傳遞copy參數(shù)，其會(huì)保留源節(jié)點(diǎn)的key，如果設(shè)置了--replace，則傳遞replace參數(shù)。如果目標(biāo)節(jié)點(diǎn)中存在同名key，其值會(huì)被覆蓋。兩個(gè)參數(shù)可同時(shí)指定。

6> 不停執(zhí)行scan命令，直到遍歷完所有key。

7> 遷移完成。

宕機(jī)情況

當(dāng)某個(gè)從節(jié)點(diǎn)掛掉之后，對(duì)于redis集群來說幾乎沒有什么影響，相當(dāng)于這個(gè)從節(jié)點(diǎn)對(duì)應(yīng)的主節(jié)點(diǎn)少了一個(gè)備份而已。
當(dāng)某一個(gè)主節(jié)點(diǎn)掛掉之后，redis 會(huì)從這個(gè) 主節(jié)點(diǎn) 的多個(gè)從節(jié)點(diǎn) 中推選一個(gè)出來，擔(dān)當(dāng)master的工作，并且把之前依附在
主節(jié)點(diǎn)的從節(jié)點(diǎn)調(diào)整依附到新的master上。如果新任的master也掛掉并且他沒有從節(jié)點(diǎn)了，那么這個(gè)集群也真正的掛掉了。

集群創(chuàng)建時(shí) replicas 參數(shù) 指定情況。

使用 --replicas 1 參數(shù)時(shí)，如果節(jié)點(diǎn)數(shù)量少于六個(gè)。
報(bào)錯(cuò)

*** ERROR: Invalid configuration for cluster creation.
*** Redis Cluster requires at least 3 master nodes.
*** This is not possible with 5 nodes and 1 replicas per node.
*** At least 6 nodes are required.

使用 --replicas 1 參數(shù)時(shí)，如果節(jié)點(diǎn)數(shù)量大于六個(gè)，且為單數(shù)時(shí)。
這樣會(huì)造成某個(gè)master擁有兩個(gè)salve

參考

https://www.cnblogs.com/ivictor/p/9768010.html

文章標(biāo)題：redis-trib.rb命令詳解
文章分享：http://jinyejixie.com/article20/iihhco.html

成都網(wǎng)站建設(shè)公司_創(chuàng)新互聯(lián)，為您提供網(wǎng)站導(dǎo)航、關(guān)鍵詞優(yōu)化、企業(yè)網(wǎng)站制作、網(wǎng)站內(nèi)鏈、動(dòng)態(tài)網(wǎng)站、微信小程序

聲明：本網(wǎng)站發(fā)布的內(nèi)容（圖片、視頻和文字）以用戶投稿、用戶轉(zhuǎn)載內(nèi)容為主，如果涉及侵權(quán)請(qǐng)盡快告知，我們將會(huì)在第一時(shí)間刪除。文章觀點(diǎn)不代表本網(wǎng)站立場(chǎng)，如需處理請(qǐng)聯(lián)系客服。電話：028-86922220；郵箱：631063699@qq.com。內(nèi)容未經(jīng)允許不得轉(zhuǎn)載，或轉(zhuǎn)載時(shí)需注明來源：創(chuàng)新互聯(lián)

猜你還喜歡下面的內(nèi)容

成人午夜视频全免费观看高清-秋霞福利视频一区二区三区-国产精品久久久久电影小说-亚洲不卡区三一区三区一区

redis-trib.rb命令詳解

1 redis-trib.rb支持的操作

支持的操作如下：

2 創(chuàng)建集群

關(guān)于主從節(jié)點(diǎn)的選擇及槽的分配，其算法如下：

3 檢查集群情況：check

4 查看集群信息：info

5 修復(fù)集群

6 在線遷移：slot

格式：

選項(xiàng)：

例：

7 平衡集群節(jié)點(diǎn)slot數(shù)量

選項(xiàng)：

說明

例：

增加一個(gè)主節(jié)點(diǎn)

添加新節(jié)點(diǎn)

刪除節(jié)點(diǎn)

格式

參數(shù)：

設(shè)置節(jié)點(diǎn)的超時(shí)時(shí)間

將外部redis數(shù)據(jù)導(dǎo)入集群

宕機(jī)情況

集群創(chuàng)建時(shí) replicas 參數(shù) 指定情況。

參考

關(guān)于主從節(jié)點(diǎn)的選擇及槽的分配，其算法如下：