Valkey : Sentinel の設定2024/12/05

Valkey Sentinel による Valkey クラスターの監視設定です。

例として、プライマリーノード 1 台とレプリカノード 2 台で構成した環境へ Sentinel サーバーを 1 台追加して、プライマリーノードの障害発生時に、マスターロールがレプリカノードに自動フェイルオーバーするように設定します。

                                  |
+----------------------+          |          +----------------------+
|  [ valkey Sentinel ] |10.0.0.25 | 10.0.0.30|  [ valkey Primary ]  |
|    ctrl.srv.world    +----------+----------+    dlp.srv.world     |
|                      |          |          |                      |
+----------------------+          |          +----------------------+
                                  |
+----------------------+          |          +----------------------+
| [ valkey Replica#1 ] |10.0.0.51 | 10.0.0.52| [ valkey Replica#2 ] |
|   node01.srv.world   +----------+----------+    node02.srv.world  |
|                      |                     |                      |
+----------------------+                     +----------------------+

[1]

こちらを参考にプライマリー/レプリカ全ノードでレプリケーション構成を設定しておきます。
注意点として Sentinel により自動フェイルオーバーした際は、レプリカがプライマリーに、プライマリーがレプリカに切り替わるため、接続/認証パスワードの設定は全ノードで合わせておく必要があります。

[2]

Sentinel サーバーをセットアップします。

root@ctrl:~#

apt -y install valkey-sentinel

root@ctrl:~#

vi /etc/valkey/sentinel.conf

# 15行目 : 変更 (サービスとして起動)

daemonize

yes

# 92行目 : 変更
# [sentinel monitor (任意の名称) (プライマリーノードの IP) (プライマリーノードのポート) (Quorum)]
# Quorum ⇒ 指定した数の Sentinel サーバーがプライマリーノードがダウンしたと判断した場合にフェイルオーバーする

sentinel monitor mymaster 10.0.0.30 6379 1

# 112行目 : プライマリーノードの認証パスワードを追記

sentinel auth-pass mymaster password

# 125行目 : プライマリーノードがダウンしたと判断する時間 (デフォルトは 30秒)
# 変更する場合はコメント解除して値を設定

# sentinel down-after-milliseconds <master-name> <milliseconds>

# 203行目 : フェイルオーバー中に設定変更するレプリカの数を設定

sentinel parallel-syncs mymaster 1

root@ctrl:~#

systemctl restart valkey-sentinel

[3]	以上で設定完了です。Sentinel サーバーで状態の確認をします。また、プライマリーノードの valkey を手動で停止させる等して、正常にフェイルオーバーするか等々も確認しておくよいでしょう。

root@ctrl:~#

valkey-cli -p 26379

# [mymaster] のプライマリーノード確認
127.0.0.1:26379> sentinel get-master-addr-by-name mymaster 
1) "10.0.0.30"
2) "6379"

# [mymaster] のプライマリーノードの詳細
127.0.0.1:26379> sentinel master mymaster 
 1) "name"
 2) "mymaster"
 3) "ip"
 4) "10.0.0.30"
 5) "port"
 6) "6379"
 7) "runid"
 8) "be361a637ddad897a8c7d4d42a7d3f8f55357310"
 9) "flags"
10) "master"
.....
.....

# [mymaster] のレプリカ確認
127.0.0.1:26379> sentinel replicas mymaster 
1)  1) "name"
    2) "10.0.0.51:6379"
    3) "ip"
    4) "10.0.0.51"
    5) "port"
    6) "6379"
    7) "runid"
    8) "02d90be9eecd74dbc22904f50daf2960f4a8a369"
    9) "flags"
   10) "slave"
.....
.....
2)  1) "name"
    2) "10.0.0.52:6379"
    3) "ip"
    4) "10.0.0.52"
    5) "port"
    6) "6379"
    7) "runid"
    8) "f1ff64d02d46e2c31a557dec150486c3419b747a"
    9) "flags"
   10) "slave"
.....
.....