redis集羣詳細配置

集羣簡介

Redis 集羣是一個可以在多個 Redis 節點之間進行數據共享的設施（installation）。

Redis 集羣不支持那些需要同時處理多個鍵的 Redis 命令，因爲執行這些命令需要在多個 Redis 節點之間移動數據，並且在高負載的情況下，這些命令將降低 Redis 集羣的性能，並導致不可預測的行爲。

Redis 集羣通過分區（partition）來提供一定程度的可用性（availability）：即使集羣中有一部分節點失效或者無法進行通訊，集羣也可以繼續處理命令請求。

Redis 集羣提供了以下兩個好處：

將數據自動切分（split）到多個節點的能力。
當集羣中的一部分節點失效或者無法進行通訊時，仍然可以繼續處理命令請求的能力。

Redis 集羣數據共享

Redis 集羣使用數據分片（sharding）而非一致性哈希（consistency hashing）來實現：一個 Redis 集羣包含 16384 個哈希槽（hash slot），數據庫中的每個鍵都屬於這 16384 個哈希槽的其中一個，集羣使用公式 CRC16(key) % 16384 來計算鍵 key 屬於哪個槽，其中 CRC16(key) 語句用於計算鍵 key 的 CRC16 校驗和。

集羣中的每個節點負責處理一部分哈希槽。舉個例子，一個集羣可以有三個哈希槽，其中：

節點 A 負責處理 0 號至 5500 號哈希槽。
節點 B 負責處理 5501 號至 11000 號哈希槽。
節點 C 負責處理 11001 號至 16384 號哈希槽。

這種將哈希槽分佈到不同節點的做法使得用戶可以很容易地向集羣中添加或者刪除節點。比如說：

如果用戶將新節點 D 添加到集羣中，那麼集羣只需要將節點 A 、B 、 C 中的某些槽移動到節點 D 就可以了。
與此類似，如果用戶要從集羣中移除節點 A ，那麼集羣只需要將節點 A 中的所有哈希槽移動到節點 B 和節點 C ，然後再移除空白（不包含任何哈希槽）的節點 A 就可以了。

因爲將一個哈希槽從一個節點移動到另一個節點不會造成節點阻塞，所以無論是添加新節點還是移除已存在節點，又或者改變某個節點包含的哈希槽數量，都不會造成集羣下線。

Redis 集羣中的主從複製

爲了使得集羣在一部分節點下線或者無法與集羣的大多數（majority）節點進行通訊的情況下，仍然可以正常運作， Redis 集羣對節點使用了主從複製功能：集羣中的每個節點都有 1 個至 N 個複製品（replica），其中一個複製品爲主節點（master），而其餘的 N-1 個複製品爲從節點（slave）。

在之前列舉的節點 A 、B 、C 的例子中，如果節點 B 下線了，那麼集羣將無法正常運行，因爲集羣找不到節點來處理 5501 號至 11000 號的哈希槽。

另一方面，假如在創建集羣的時候（或者至少在節點 B 下線之前），我們爲主節點 B 添加了從節點 B1 ，那麼當主節點 B 下線的時候，集羣就會將 B1 設置爲新的主節點，並讓它代替下線的主節點 B ，繼續處理 5501 號至 11000 號的哈希槽，這樣集羣就不會因爲主節點 B 的下線而無法正常運作了。

不過如果節點 B 和 B1 都下線的話， Redis 集羣還是會停止運作。

Redis 集羣的一致性保證（guarantee）

Redis 集羣不保證數據的強一致性（strong consistency）：在特定條件下， Redis 集羣可能會丟失已經被執行過的寫命令。

使用異步複製（asynchronous replication）是 Redis 集羣可能會丟失寫命令的其中一個原因。考慮以下這個寫命令的例子：

客戶端向主節點 B 發送一條寫命令。
主節點 B 執行寫命令，並向客戶端返回命令回覆。
主節點 B 將剛剛執行的寫命令複製給它的從節點 B1 、 B2 和 B3 。

如你所見，主節點對命令的複製工作發生在返回命令回覆之後，因爲如果每次處理命令請求都需要等待複製操作完成的話，那麼主節點處理命令請求的速度將極大地降低 —— 我們必須在性能和一致性之間做出權衡。

如果真的有必要的話， Redis 集羣可能會在將來提供同步地（synchronou）執行寫命令的方法。

Redis 集羣另外一種可能會丟失命令的情況是，集羣出現網絡分裂（network partition），並且一個客戶端與至少包括一個主節點在內的少數（minority）實例被孤立。

舉個例子，假設集羣包含 A 、 B 、 C 、 A1 、 B1 、 C1 六個節點，其中 A 、B 、C 爲主節點，而 A1 、B1 、C1 分別爲三個主節點的從節點，另外還有一個客戶端 Z1 。

假設集羣中發生網絡分裂，那麼集羣可能會分裂爲兩方，大多數（majority）的一方包含節點 A 、C 、A1 、B1 和 C1 ，而少數（minority）的一方則包含節點 B 和客戶端 Z1 。

在網絡分裂期間，主節點 B 仍然會接受 Z1 發送的寫命令：

如果網絡分裂出現的時間很短，那麼集羣會繼續正常運行；
但是，如果網絡分裂出現的時間足夠長，使得大多數一方將從節點 B1 設置爲新的主節點，並使用 B1 來代替原來的主節點 B ，那麼 Z1 發送給主節點 B 的寫命令將丟失。

注意，在網絡分裂出現期間，客戶端 Z1 可以向主節點 B 發送寫命令的最大時間是有限制的，這一時間限制稱爲節點超時時間（node timeout），是 Redis 集羣的一個重要的配置選項：

對於大多數一方來說，如果一個主節點未能在節點超時時間所設定的時限內重新聯繫上集羣，那麼集羣會將這個主節點視爲下線，並使用從節點來代替這個主節點繼續工作。
對於少數一方，如果一個主節點未能在節點超時時間所設定的時限內重新聯繫上集羣，那麼它將停止處理寫命令，並向客戶端報告錯誤。

創建並使用 Redis 集羣

Redis 集羣由多個運行在集羣模式（cluster mode）下的 Redis 實例組成，實例的集羣模式需要通過配置來開啓，開啓集羣模式的實例將可以使用集羣特有的功能和命令。

以下是一個包含了最少選項的集羣配置文件示例：

port 7000
cluster-enabled yes
cluster-config-file nodes.conf
cluster-node-timeout 5000
appendonly yes

文件中的 cluster-enabled 選項用於開實例的集羣模式，而 cluster-conf-file 選項則設定了保存節點配置文件的路徑，默認值爲 nodes.conf 。

節點配置文件無須人爲修改，它由 Redis 集羣在啓動時創建，並在有需要時自動進行更新。

要讓集羣正常運作至少需要三個主節點，不過在剛開始試用集羣功能時，強烈建議使用六個節點：其中三個爲主節點，而其餘三個則是各個主節點的從節點。

首先，讓我們進入一個新目錄，並創建六個以端口號爲名字的子目錄，稍後我們在將每個目錄中運行一個 Redis 實例：

mkdir cluster-test
cd cluster-test
mkdir 7000 7001 7002 7003 7004 7005

在文件夾 7000 至 7005 中，各創建一個 redis.conf 文件，文件的內容可以使用上面的示例配置文件，但記得將配置中的端口號從 7000 改爲與文件夾名字相同的號碼。

現在，從 Redis Github 頁面的 unstable 分支中取出最新的 Redis 源碼，編譯出可執行文件 redis-server ，並將文件複製到 cluster-test 文件夾，然後使用類似以下命令，在每個標籤頁中打開一個實例：

cd 7000
../redis-server ./redis.conf

實例打印的日誌顯示，因爲 nodes.conf 文件不存在，所以每個節點都爲它自身指定了一個新的 ID ：

[82462] 26 Nov 11:56:55.329 * No cluster configuration found, I'm 97a3a64667477371c4479320d683e4c8db5858b1

實例會一直使用同一個 ID ，從而在集羣中保持一個獨一無二（unique）的名字。

每個節點都使用 ID 而不是 IP 或者端口號來記錄其他節點，因爲 IP 地址和端口號都可能會改變，而這個獨一無二的標識符（identifier）則會在節點的整個生命週期中一直保持不變。

我們將這個標識符稱爲節點 ID。

創建集羣

現在我們已經有了六個正在運行中的 Redis 實例，接下來我們需要使用這些實例來創建集羣，併爲每個節點編寫配置文件。

通過使用 Redis 集羣命令行工具 redis-trib ，編寫節點配置文件的工作可以非常容易地完成：redis-trib 位於 Redis 源碼的 src 文件夾中，它是一個 Ruby 程序，這個程序通過向實例發送特殊命令來完成創建新集羣，檢查集羣，或者對集羣進行重新分片（reshared）等工作。

我們需要執行以下命令來創建集羣：

./redis-trib.rb create --replicas 1 127.0.0.1:7000 127.0.0.1:7001 \
127.0.0.1:7002 127.0.0.1:7003 127.0.0.1:7004 127.0.0.1:7005

命令的意義如下：

給定 redis-trib.rb 程序的命令是 create ，這表示我們希望創建一個新的集羣。
選項 --replicas 1 表示我們希望爲集羣中的每個主節點創建一個從節點。
之後跟着的其他參數則是實例的地址列表，我們希望程序使用這些地址所指示的實例來創建新集羣。

簡單來說，以上命令的意思就是讓 redis-trib 程序創建一個包含三個主節點和三個從節點的集羣。

接着，redis-trib 會打印出一份預想中的配置給你看，如果你覺得沒問題的話，就可以輸入 yes ，redis-trib 就會將這份配置應用到集羣當中：

>>> Creating clusterConnecting to node 127.0.0.1:7000: OKConnecting to node 127.0.0.1:7001: OKConnecting to node 127.0.0.1:7002: OKConnecting to node 127.0.0.1:7003: OKConnecting to node 127.0.0.1:7004: OKConnecting to node 127.0.0.1:7005: OK>>> Performing hash slots allocation on 6 nodes...Using 3 masters:127.0.0.1:7000127.0.0.1:7001127.0.0.1:7002127.0.0.1:7000 replica #1 is 127.0.0.1:7003127.0.0.1:7001 replica #1 is 127.0.0.1:7004127.0.0.1:7002 replica #1 is 127.0.0.1:7005M: 9991306f0e50640a5684f1958fd754b38fa034c9 127.0.0.1:7000slots:0-5460 (5461 slots) masterM: e68e52cee0550f558b03b342f2f0354d2b8a083b 127.0.0.1:7001slots:5461-10921 (5461 slots) masterM: 393c6df5eb4b4cec323f0e4ca961c8b256e3460a 127.0.0.1:7002slots:10922-16383 (5462 slots) masterS: 48b728dbcedff6bf056231eb44990b7d1c35c3e0 127.0.0.1:7003S: 345ede084ac784a5c030a0387f8aaa9edfc59af3 127.0.0.1:7004S: 3375be2ccc321932e8853234ffa87ee9fde973ff 127.0.0.1:7005Can I set the above configuration? (type 'yes' to accept): yes

輸入 yes 並按下回車確認之後，集羣就會將配置應用到各個節點，並連接起（join）各個節點 —— 也即是，讓各個節點開始互相通訊：

>>> Nodes configuration updated>>> Sending CLUSTER MEET messages to join the clusterWaiting for the cluster to join...>>> Performing Cluster Check (using node 127.0.0.1:7000)M: 9991306f0e50640a5684f1958fd754b38fa034c9 127.0.0.1:7000slots:0-5460 (5461 slots) masterM: e68e52cee0550f558b03b342f2f0354d2b8a083b 127.0.0.1:7001slots:5461-10921 (5461 slots) masterM: 393c6df5eb4b4cec323f0e4ca961c8b256e3460a 127.0.0.1:7002slots:10922-16383 (5462 slots) masterM: 48b728dbcedff6bf056231eb44990b7d1c35c3e0 127.0.0.1:7003slots: (0 slots) masterM: 345ede084ac784a5c030a0387f8aaa9edfc59af3 127.0.0.1:7004slots: (0 slots) masterM: 3375be2ccc321932e8853234ffa87ee9fde973ff 127.0.0.1:7005slots: (0 slots) master[OK] All nodes agree about slots configuration.

如果一切正常的話，redis-trib 將輸出以下信息：

>>> Check for open slots...>>> Check slots coverage...[OK] All 16384 slots covered.

這表示集羣中的 16384 個槽都有至少一個主節點在處理，集羣運作正常。

集羣的客戶端

Redis 集羣現階段的一個問題是客戶端實現很少。以下是一些我知道的實現：

redis-rb-cluster 是我（@antirez）編寫的 Ruby 實現，用於作爲其他實現的參考。該實現是對 redis-rb 的一個簡單包裝，高效地實現了與集羣進行通訊所需的最少語義（semantic）。
redis-py-cluster 看上去是 redis-rb-cluster 的一個 Python 版本，這個項目有一段時間沒有更新了（最後一次提交是在六個月之前），不過可以將這個項目用作學習集羣的起點。
流行的 Predis 曾經對早期的 Redis 集羣有過一定的支持，但我不確定它對集羣的支持是否完整，也不清楚它是否和最新版本的 Redis 集羣兼容（因爲新版的 Redis 集羣將槽的數量從 4k 改爲 16k 了）。
Redis unstable 分支中的 redis-cli 程序實現了非常基本的集羣支持，可以使用命令 redis-cli -c 來啓動。

測試 Redis 集羣比較簡單的辦法就是使用 redis-rb-cluster 或者 redis-cli ，接下來我們將使用 redis-cli 爲例來進行演示：

$ redis-cli -c -p 7000
redis 127.0.0.1:7000> set foo bar
-> Redirected to slot [12182] located at 127.0.0.1:7002
OK

redis 127.0.0.1:7002> set hello world
-> Redirected to slot [866] located at 127.0.0.1:7000
OK

redis 127.0.0.1:7000> get foo
-> Redirected to slot [12182] located at 127.0.0.1:7002
"bar"

redis 127.0.0.1:7000> get hello
-> Redirected to slot [866] located at 127.0.0.1:7000
"world"

redis-cli 對集羣的支持是非常基本的，所以它總是依靠 Redis 集羣節點來將它轉向（redirect）至正確的節點。

一個真正的（serious）集羣客戶端應該做得比這更好：它應該用緩存記錄起哈希槽與節點地址之間的映射（map），從而直接將命令發送到正確的節點上面。

這種映射只會在集羣的配置出現某些修改時變化，比如說，在一次故障轉移（failover）之後，或者系統管理員通過添加節點或移除節點來修改了集羣的佈局（layout）之後，諸如此類。

使用 `redis-rb-cluster` 編寫一個示例應用

在展示如何使用集羣進行故障轉移、重新分片等操作之前，我們需要創建一個示例應用，瞭解一些與 Redis 集羣客戶端進行交互的基本方法。

在運行示例應用的過程中，我們會嘗試讓節點進入失效狀態，又或者開始一次重新分片，以此來觀察 Redis 集羣在真實世界運行時的表現，並且爲了讓這個示例儘可能地有用，我們會讓這個應用向集羣進行寫操作。

本節將通過兩個示例應用來展示 redis-rb-cluster 的基本用法，以下是本節的第一個示例應用，它是一個名爲 example.rb 的文件，包含在redis-rb-cluster 項目裏面：

 1  require './cluster'
 2
 3  startup_nodes = [
 4      {:host => "127.0.0.1", :port => 7000},
 5      {:host => "127.0.0.1", :port => 7001}
 6  ]
 7  rc = RedisCluster.new(startup_nodes,32,:timeout => 0.1)
 8
 9  last = false
10
11  while not last
12      begin
13          last = rc.get("__last__")
14          last = 0 if !last
15      rescue => e
16          puts "error #{e.to_s}"
17          sleep 1
18      end
19  end
20
21  ((last.to_i+1)..1000000000).each{|x|
22      begin
23          rc.set("foo#{x}",x)
24          puts rc.get("foo#{x}")
25          rc.set("__last__",x)
26      rescue => e
27          puts "error #{e.to_s}"
28      end
29      sleep 0.1
30  }

這個應用所做的工作非常簡單：它不斷地以 foo<number> 爲鍵，number 爲值，使用 SET 命令向數據庫設置鍵值對。

如果我們執行這個應用的話，應用將按順序執行以下命令：

SET foo0 0
SET foo1 1
SET foo2 2
諸如此類。。。

代碼中的每個集羣操作都使用一個 begin 和 rescue 代碼塊（block）包裹着，因爲我們希望在代碼出錯時，將錯誤打印到終端上面，而不希望應用因爲異常（exception）而退出。

代碼的第七行是代碼中第一個有趣的地方，它創建了一個 Redis 集羣對象，其中創建對象所使用的參數及其意義如下：

第一個參數是記錄了啓動節點的 startup_nodes 列表，列表中包含了兩個集羣節點的地址。
第二個參數指定了對於集羣中的各個不同的節點， Redis 集羣對象可以獲得（take）的最大連接數（maximum number of connections this object is allowed to take）。
第三個參數 timeout 指定了一個命令在執行多久之後，纔會被看作是執行失敗。

記住，啓動列表中並不需要包含所有集羣節點的地址，但這些地址中至少要有一個是有效的（reachable）：一旦 redis-rb-cluster 成功連接上集羣中的某個節點時，集羣節點列表就會被自動更新，任何真正的（serious）的集羣客戶端都應該這樣做。

現在，程序創建的 Redis 集羣對象實例被保存到 rc 變量裏面，我們可以將這個對象當作普通 Redis 對象實例來使用。

在十一至十九行，我們先嚐試閱讀計數器中的值，如果計數器不存在的話，我們纔將計數器初始化爲 0 ：通過將計數值保存到 Redis 的計數器裏面，我們可以在示例重啓之後，仍然繼續之前的執行過程，而不必每次重啓之後都從 foo0 開始重新設置鍵值對。

爲了讓程序在集羣下線的情況下，仍然不斷地嘗試讀取計數器的值，我們將讀取操作包含在了一個 while 循環裏面，一般的應用程序並不需要如此小心。

二十一至三十行是程序的主循環，這個循環負責設置鍵值對，並在設置出錯時打印錯誤信息。

程序在主循環的末尾添加了一個 sleep 調用，讓寫操作的執行速度變慢，幫助執行示例的人更容易看清程序的輸出。

執行 example.rb 程序將產生以下輸出：

ruby ./example.rb
1
2
3
4
5
6
7
8
9
...

這個程序並不是十分有趣，稍後我們就會看到一個更有趣的集羣應用示例，不過在此之前，讓我們先使用這個示例來演示集羣的重新分片操作。

對集羣進行重新分片

現在，讓我們來試試對集羣進行重新分片操作。

在執行重新分片的過程中，請讓你的 example.rb 程序處於運行狀態，這樣你就會看到，重新分片並不會對正在運行的集羣程序產生任何影響，你也可以考慮將 example.rb 中的 sleep 調用刪掉，從而讓重新分片操作在近乎真實的寫負載下執行。

重新分片操作基本上就是將某些節點上的哈希槽移動到另外一些節點上面，和創建集羣一樣，重新分片也可以使用 redis-trib 程序來執行。

執行以下命令可以開始一次重新分片操作：

$ ./redis-trib.rb reshard 127.0.0.1:7000

你只需要指定集羣中其中一個節點的地址，redis-trib 就會自動找到集羣中的其他節點。

目前 redis-trib 只能在管理員的協助下完成重新分片的工作，要讓 redis-trib 自動將哈希槽從一個節點移動到另一個節點，目前來說還做不到（不過實現這個功能並不難）。

執行 redis-trib 的第一步就是設定你打算移動的哈希槽的數量：

$ ./redis-trib.rb reshard 127.0.0.1:7000
Connecting to node 127.0.0.1:7000: OK
Connecting to node 127.0.0.1:7002: OK
Connecting to node 127.0.0.1:7005: OK
Connecting to node 127.0.0.1:7001: OK
Connecting to node 127.0.0.1:7003: OK
Connecting to node 127.0.0.1:7004: OK
>>> Performing Cluster Check (using node 127.0.0.1:7000)
M: 9991306f0e50640a5684f1958fd754b38fa034c9 127.0.0.1:7000
slots:0-5460 (5461 slots) master
M: 393c6df5eb4b4cec323f0e4ca961c8b256e3460a 127.0.0.1:7002
slots:10922-16383 (5462 slots) master
S: 3375be2ccc321932e8853234ffa87ee9fde973ff 127.0.0.1:7005
slots: (0 slots) slave
M: e68e52cee0550f558b03b342f2f0354d2b8a083b 127.0.0.1:7001
slots:5461-10921 (5461 slots) master
S: 48b728dbcedff6bf056231eb44990b7d1c35c3e0 127.0.0.1:7003
slots: (0 slots) slave
S: 345ede084ac784a5c030a0387f8aaa9edfc59af3 127.0.0.1:7004
slots: (0 slots) slave
[OK] All nodes agree about slots configuration.
>>> Check for open slots...
>>> Check slots coverage...
[OK] All 16384 slots covered.
How many slots do you want to move (from 1 to 16384)? 1000

我們將打算移動的槽數量設置爲 1000 個，如果 example.rb 程序一直運行着的話，現在 1000 個槽裏面應該有不少鍵了。

除了移動的哈希槽數量之外，redis-trib 還需要知道重新分片的目標（target node），也即是，負責接收這 1000 個哈希槽的節點。

指定目標需要使用節點的 ID ，而不是 IP 地址和端口。比如說，我們打算使用集羣的第一個主節點來作爲目標，它的 IP 地址和端口是 127.0.0.1:7000 ，而節點 ID 則是 9991306f0e50640a5684f1958fd754b38fa034c9 ，那麼我們應該向 redis-trib 提供節點的 ID ：

$ ./redis-trib.rb reshard 127.0.0.1:7000
...
What is the receiving node ID? 9991306f0e50640a5684f1958fd754b38fa034c9

redis-trib 會打印出集羣中所有節點的 ID ，並且我們也可以通過執行以下命令來獲得節點的運行 ID ：

$ ./redis-cli -p 7000 cluster nodes | grep myself
9991306f0e50640a5684f1958fd754b38fa034c9 :0 myself,master - 0 0 0 connected 0-5460

接着，redis-trib 會向你詢問重新分片的源節點（source node），也即是，要從哪個節點中取出 1000 個哈希槽，並將這些槽移動到目標節點上面。

如果我們不打算從特定的節點上取出指定數量的哈希槽，那麼可以向 redis-trib 輸入 all ，這樣的話，集羣中的所有主節點都會成爲源節點，redis-trib 將從各個源節點中各取出一部分哈希槽，湊夠 1000 個，然後移動到目標節點上面：

$ ./redis-trib.rb reshard 127.0.0.1:7000
...
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.
Source node #1:all

輸入 all 並按下回車之後，redis-trib 將打印出哈希槽的移動計劃，如果你覺得沒問題的話，就可以輸入 yes 並再次按下回車：

$ ./redis-trib.rb reshard 127.0.0.1:7000
...
Moving slot 11421 from 393c6df5eb4b4cec323f0e4ca961c8b256e3460a
Moving slot 11422 from 393c6df5eb4b4cec323f0e4ca961c8b256e3460a
Moving slot 5461 from e68e52cee0550f558b03b342f2f0354d2b8a083b
Moving slot 5469 from e68e52cee0550f558b03b342f2f0354d2b8a083b
...
Moving slot 5959 from e68e52cee0550f558b03b342f2f0354d2b8a083b
Do you want to proceed with the proposed reshard plan (yes/no)? yes

輸入 yes 並使用按下回車之後，redis-trib 就會正式開始執行重新分片操作，將指定的哈希槽從源節點一個個地移動到目標節點上面：

$ ./redis-trib.rb reshard 127.0.0.1:7000
...
Moving slot 5934 from 127.0.0.1:7001 to 127.0.0.1:7000:
Moving slot 5935 from 127.0.0.1:7001 to 127.0.0.1:7000:
Moving slot 5936 from 127.0.0.1:7001 to 127.0.0.1:7000:
Moving slot 5937 from 127.0.0.1:7001 to 127.0.0.1:7000:
...
Moving slot 5959 from 127.0.0.1:7001 to 127.0.0.1:7000:

在重新分片的過程中，example.rb 應該可以繼續正常運行，不會出現任何問題。

在重新分片操作執行完畢之後，可以使用以下命令來檢查集羣是否正常：

$ ./redis-trib.rb check 127.0.0.1:7000
Connecting to node 127.0.0.1:7000: OK
Connecting to node 127.0.0.1:7002: OK
Connecting to node 127.0.0.1:7005: OK
Connecting to node 127.0.0.1:7001: OK
Connecting to node 127.0.0.1:7003: OK
Connecting to node 127.0.0.1:7004: OK
>>> Performing Cluster Check (using node 127.0.0.1:7000)
M: 9991306f0e50640a5684f1958fd754b38fa034c9 127.0.0.1:7000
slots:0-5959,10922-11422 (6461 slots) master
M: 393c6df5eb4b4cec323f0e4ca961c8b256e3460a 127.0.0.1:7002
slots:11423-16383 (4961 slots) master
S: 3375be2ccc321932e8853234ffa87ee9fde973ff 127.0.0.1:7005
slots: (0 slots) slave
M: e68e52cee0550f558b03b342f2f0354d2b8a083b 127.0.0.1:7001
slots:5960-10921 (4962 slots) master
S: 48b728dbcedff6bf056231eb44990b7d1c35c3e0 127.0.0.1:7003
slots: (0 slots) slave
S: 345ede084ac784a5c030a0387f8aaa9edfc59af3 127.0.0.1:7004
slots: (0 slots) slave
[OK] All nodes agree about slots configuration.
>>> Check for open slots...
>>> Check slots coverage...
[OK] All 16384 slots covered.

根據檢查結果顯示，集羣運作正常。

需要注意的就是，在三個主節點中，節點 127.0.0.1:7000 包含了 6461 個哈希槽，而節點 127.0.0.1:7001 和節點 127.0.0.1:7002 都只包含了 4961 個哈希槽，因爲後兩者都將自己的 500 個哈希槽移動到了節點 127.0.0.1:7000 。

一個更有趣的示例應用

我們在前面使用的示例程序 example.rb 並不是十分有趣，因爲它只是不斷地對集羣進行寫入，但並不檢查寫入結果是否正確。比如說，集羣可能會錯誤地將 example.rb 發送的所有 SET 命令都改成了 SET foo 42 ，但因爲 example.rb 並不檢查寫入後的值，所以它不會意識到集羣實際上寫入的值是錯誤的。

因爲這個原因，redis-rb-cluster 項目包含了一個名爲 consistency-test.rb 的示例應用，這個應用比起 example.rb 有趣得多：它創建了多個計數器（默認爲 1000 個），並通過發送 INCR 命令來增加這些計數器的值。

在增加計數器值的同時，consistency-test.rb 還執行以下操作：

每次使用 INCR 命令更新一個計數器時，應用會記錄下計數器執行 INCR 命令之後應該有的值。舉個例子，如果計數器的起始值爲 0 ，而這次是程序第 50 次向它發送 INCR 命令，那麼計數器的值應該是 50 。
在每次發送 INCR 命令之前，程序會隨機從集羣中讀取一個計數器的值，並將它與自己記錄的值進行對比，看兩個值是否相同。

換句話說，這個程序是一個一致性檢查器（consistency checker）：如果集羣在執行 INCR 命令的過程中，丟失了某條 INCR 命令，又或者多執行了某條客戶端沒有確認到的 INCR 命令，那麼檢查器將察覺到這一點 —— 在前一種情況中，consistency-test.rb 記錄的計數器值將比集羣記錄的計數器值要大；而在後一種情況中，consistency-test.rb 記錄的計數器值將比集羣記錄的計數器值要小。

運行 consistency-test 程序將產生類似以下的輸出：

$ ruby consistency-test.rb
925 R (0 err) | 925 W (0 err) |
5030 R (0 err) | 5030 W (0 err) |
9261 R (0 err) | 9261 W (0 err) |
13517 R (0 err) | 13517 W (0 err) |
17780 R (0 err) | 17780 W (0 err) |
22025 R (0 err) | 22025 W (0 err) |
25818 R (0 err) | 25818 W (0 err) |

每行輸出都打印了程序執行的讀取次數和寫入次數，以及執行操作的過程中因爲集羣不可用而產生的錯誤數。

如果程序察覺了不一致的情況出現，它將在輸出行的末尾顯式不一致的詳細情況。

比如說，如果我們在 consistency-test.rb 運行的過程中，手動修改某個計數器的值：

$ redis 127.0.0.1:7000> set key_217 0
OK

那麼 consistency-test.rb 將向我們報告不一致情況：

(in the other tab I see...)

94774 R (0 err) | 94774 W (0 err) |
98821 R (0 err) | 98821 W (0 err) |
102886 R (0 err) | 102886 W (0 err) | 114 lost |
107046 R (0 err) | 107046 W (0 err) | 114 lost |

在我們修改計數器值的時候，計數器的正確值是 114 （執行了 114 次 INCR 命令），因爲我們將計數器的值設成了 0 ，所以 consistency-test.rb 會向我們報告說丟失了 114 個 INCR 命令。

因爲這個示例程序具有一致性檢查功能，所以我們用它來測試 Redis 集羣的故障轉移操作。

故障轉移測試

在執行本節操作的過程中，請一直運行 consistency-test 程序。

要觸發一次故障轉移，最簡單的辦法就是令集羣中的某個主節點進入下線狀態。

首先用以下命令列出集羣中的所有主節點：

$ redis-cli -p 7000 cluster nodes | grep master
3e3a6cb0d9a9a87168e266b0a0b24026c0aae3f0 127.0.0.1:7001 master - 0 1385482984082 0 connected 5960-10921
2938205e12de373867bf38f1ca29d31d0ddb3e46 127.0.0.1:7002 master - 0 1385482983582 0 connected 11423-16383
97a3a64667477371c4479320d683e4c8db5858b1 :0 myself,master - 0 0 0 connected 0-5959 10922-11422

通過命令輸出，我們知道端口號爲 7000 、 7001 和 7002 的節點都是主節點，然後我們可以通過向端口號爲 7002 的主節點發送 DEBUG SEGFAULT 命令，讓這個主節點崩潰：

$ redis-cli -p 7002 debug segfault
Error: Server closed the connection

現在，切換到運行着 consistency-test 的標籤頁，可以看到，consistency-test 在 7002 下線之後的一段時間裏將產生大量的錯誤警告信息：

18849 R (0 err) | 18849 W (0 err) |
23151 R (0 err) | 23151 W (0 err) |
27302 R (0 err) | 27302 W (0 err) |

... many error warnings here ...

29659 R (578 err) | 29660 W (577 err) |
33749 R (578 err) | 33750 W (577 err) |
37918 R (578 err) | 37919 W (577 err) |
42077 R (578 err) | 42078 W (577 err) |

從 consistency-test 的這段輸出可以看到，集羣在執行故障轉移期間，總共丟失了 578 個讀命令和 577 個寫命令，但是並沒有產生任何數據不一致。

這聽上去可能有點奇怪，因爲在教程的開頭我們提到過， Redis 使用的是異步複製，在執行故障轉移期間，集羣可能會丟失寫命令。

但是在實際上，丟失命令的情況並不常見，因爲 Redis 幾乎是同時執行將命令回覆發送給客戶端，以及將命令複製給從節點這兩個操作，所以實際上造成命令丟失的時間窗口是非常小的。

不過，儘管出現的機率不高，但丟失命令的情況還是有可能會出現的，所以我們對 Redis 集羣不能提供強一致性的這一描述仍然是正確的。

現在，讓我們使用 cluster nodes 命令，查看集羣在執行故障轉移操作之後，主從節點的佈局情況：

$ redis-cli -p 7000 cluster nodes
3fc783611028b1707fd65345e763befb36454d73 127.0.0.1:7004 slave 3e3a6cb0d9a9a87168e266b0a0b24026c0aae3f0 0 1385503418521 0 connected
a211e242fc6b22a9427fed61285e85892fa04e08 127.0.0.1:7003 slave 97a3a64667477371c4479320d683e4c8db5858b1 0 1385503419023 0 connected
97a3a64667477371c4479320d683e4c8db5858b1 :0 myself,master - 0 0 0 connected 0-5959 10922-11422
3c3a0c74aae0b56170ccb03a76b60cfe7dc1912e 127.0.0.1:7005 master - 0 1385503419023 3 connected 11423-16383
3e3a6cb0d9a9a87168e266b0a0b24026c0aae3f0 127.0.0.1:7001 master - 0 1385503417005 0 connected 5960-10921
2938205e12de373867bf38f1ca29d31d0ddb3e46 127.0.0.1:7002 slave 3c3a0c74aae0b56170ccb03a76b60cfe7dc1912e 0 1385503418016 3 connected

我重啓了之前下線的 127.0.0.1:7002 節點，該節點已經從原來的主節點變成了從節點，而現在集羣中的三個主節點分別是 127.0.0.1:7000 、 127.0.0.1:7001 和 127.0.0.1:7005 ，其中 127.0.0.1:7005 就是因爲 127.0.0.1:7002 下線而變成主節點的。

cluster nodes 命令的輸出有點兒複雜，它的每一行都是由以下信息組成的：

節點 ID ：例如 3fc783611028b1707fd65345e763befb36454d73 。
ip:port ：節點的 IP 地址和端口號，例如 127.0.0.1:7000 ，其中 :0 表示的是客戶端當前連接的 IP 地址和端口號。
flags ：節點的角色（例如 master 、 slave 、 myself ）以及狀態（例如 fail ，等等）。
如果節點是一個從節點的話，那麼跟在 flags 之後的將是主節點的節點 ID ：例如 127.0.0.1:7002 的主節點的節點 ID 就是 3c3a0c74aae0b56170ccb03a76b60cfe7dc1912e 。
集羣最近一次向節點發送 PING 命令之後，過去了多長時間還沒接到回覆。
節點最近一次返回 PONG 回覆的時間。
節點的配置紀元（configuration epoch）：詳細信息請參考 Redis 集羣規範。
本節點的網絡連接情況：例如 connected 。
節點目前包含的槽：例如 127.0.0.1:7001 目前包含號碼爲 5960 至 10921 的哈希槽。

添加新節點到集羣

根據新添加節點的種類，我們需要用兩種方法來將新節點添加到集羣裏面：

如果要添加的新節點是一個主節點，那麼我們需要創建一個空節點（empty node），然後將某些哈希桶移動到這個空節點裏面。
另一方面，如果要添加的新節點是一個從節點，那麼我們需要將這個新節點設置爲集羣中某個節點的複製品（replica）。

本節將對以上兩種情況進行介紹，首先介紹主節點的添加方法，然後再介紹從節點的添加方法。

無論添加的是那種節點，第一步要做的總是添加一個空節點。

我們可以繼續使用之前啓動 127.0.0.1:7000 、 127.0.0.1:7001 等節點的方法，創建一個端口號爲 7006 的新節點，使用的配置文件也和之前一樣，只是記得要將配置中的端口號改爲 7000 。

以下是啓動端口號爲 7006 的新節點的詳細步驟：

在終端裏創建一個新的標籤頁。
進入 cluster-test 文件夾。
創建並進入 7006 文件夾。
將 redis.conf 文件複製到 7006 文件夾裏面，然後將配置中的端口號選項改爲 7006 。
使用命令 ../../redis-server redis.conf 啓動節點。

如果一切正常，那麼節點應該會正確地啓動。

接下來，執行以下命令，將這個新節點添加到集羣裏面：

./redis-trib.rb add-node 127.0.0.1:7006 127.0.0.1:7000

命令中的 add-node 表示我們要讓 redis-trib 將一個節點添加到集羣裏面，add-node 之後跟着的是新節點的 IP 地址和端口號，再之後跟着的是集羣中任意一個已存在節點的 IP 地址和端口號，這裏我們使用的是 127.0.0.1:7000 。

通過 cluster nodes 命令，我們可以確認新節點 127.0.0.1:7006 已經被添加到集羣裏面了：

redis 127.0.0.1:7006> cluster nodes
3e3a6cb0d9a9a87168e266b0a0b24026c0aae3f0 127.0.0.1:7001 master - 0 1385543178575 0 connected 5960-10921
3fc783611028b1707fd65345e763befb36454d73 127.0.0.1:7004 slave 3e3a6cb0d9a9a87168e266b0a0b24026c0aae3f0 0 1385543179583 0 connected
f093c80dde814da99c5cf72a7dd01590792b783b :0 myself,master - 0 0 0 connected
2938205e12de373867bf38f1ca29d31d0ddb3e46 127.0.0.1:7002 slave 3c3a0c74aae0b56170ccb03a76b60cfe7dc1912e 0 1385543178072 3 connected
a211e242fc6b22a9427fed61285e85892fa04e08 127.0.0.1:7003 slave 97a3a64667477371c4479320d683e4c8db5858b1 0 1385543178575 0 connected
97a3a64667477371c4479320d683e4c8db5858b1 127.0.0.1:7000 master - 0 1385543179080 0 connected 0-5959 10922-11422
3c3a0c74aae0b56170ccb03a76b60cfe7dc1912e 127.0.0.1:7005 master - 0 1385543177568 3 connected 11423-16383

新節點現在已經連接上了集羣，成爲集羣的一份子，並且可以對客戶端的命令請求進行轉向了，但是和其他主節點相比，新節點還有兩點區別：

新節點沒有包含任何數據，因爲它沒有包含任何哈希桶。
儘管新節點沒有包含任何哈希桶，但它仍然是一個主節點，所以在集羣需要將某個從節點升級爲新的主節點時，這個新節點不會被選中。

接下來，只要使用 redis-trib 程序，將集羣中的某些哈希桶移動到新節點裏面，新節點就會成爲真正的主節點了。

因爲使用 redis-trib 移動哈希桶的方法在前面已經介紹過，所以這裏就不再重複介紹了。

現在，讓我們來看看，將一個新節點轉變爲某個主節點的複製品（也即是從節點）的方法。

舉個例子，如果我們打算讓新節點成爲 127.0.0.1:7005 的從節點，那麼我們只要用客戶端連接上新節點，然後執行以下命令就可以了：

redis 127.0.0.1:7006> cluster replicate 3c3a0c74aae0b56170ccb03a76b60cfe7dc1912e

其中命令提供的 3c3a0c74aae0b56170ccb03a76b60cfe7dc1912e 就是主節點 127.0.0.1:7005 的節點 ID 。

執行 cluster replicate 命令之後，我們可以使用以下命令來確認 127.0.0.1:7006 已經成爲了 ID 爲 3c3a0c74aae0b56170ccb03a76b60cfe7dc1912e 的節點的從節點：

$ redis-cli -p 7000 cluster nodes | grep slave | grep 3c3a0c74aae0b56170ccb03a76b60cfe7dc1912e
f093c80dde814da99c5cf72a7dd01590792b783b 127.0.0.1:7006 slave 3c3a0c74aae0b56170ccb03a76b60cfe7dc1912e 0 1385543617702 3 connected
2938205e12de373867bf38f1ca29d31d0ddb3e46 127.0.0.1:7002 slave 3c3a0c74aae0b56170ccb03a76b60cfe7dc1912e 0 1385543617198 3 connected

3c3a0c... 現在有兩個從節點，一個從節點的端口號爲 7002 ，而另一個從節點的端口號爲 7006 。

redis集羣詳細配置

集羣簡介

Redis 集羣數據共享

Redis 集羣中的主從複製

Redis 集羣的一致性保證（guarantee）

創建並使用 Redis 集羣

創建集羣

集羣的客戶端

使用 `redis-rb-cluster` 編寫一個示例應用

對集羣進行重新分片

一個更有趣的示例應用

故障轉移測試

添加新節點到集羣

[oracle]解決centos 7下oracle的中文亂碼問題

centos7 KVM的安裝與部署

ERROR 1044 (42000): Access denied for user ''@'localhost' to database 'mysql'

Centos7 安裝編譯nbd模塊步驟

Tomcat7 catalina.out 日誌分割

Mac下配置sublime實現LaTeX

https://yachay.unat.edu.pe/blog/index.php?comment_area=format_blog&comment_component=blog&comment_co

linux以太網驅動總結

redis集羣詳細配置

集羣簡介

Redis 集羣數據共享

Redis 集羣中的主從複製

Redis 集羣的一致性保證（guarantee）

創建並使用 Redis 集羣

創建集羣

集羣的客戶端

使用 redis-rb-cluster 編寫一個示例應用

對集羣進行重新分片

一個更有趣的示例應用

故障轉移測試

添加新節點到集羣

使用 `redis-rb-cluster` 編寫一個示例應用