---
title: "Redis Clusterの構築手順：16384ハッシュスロットの仕組みとMOVED・ASK、redis-pyでの接続と再シャーディング【Redis 8.10系】"
url: "https://www.issoh.co.jp/tech/details/19853/"
published: 2026-11-16
updated: 2026-11-16
categories: ["データベース"]
publisher: "株式会社一創"
---

# Redis Clusterの構築手順：16384ハッシュスロットの仕組みとMOVED・ASK、redis-pyでの接続と再シャーディング【Redis 8.10系】

Redis Clusterは、データを16384個のハッシュスロットに分けて複数のノードへ配り、マスターが落ちればレプリカを自動で昇格させるRedis標準の分散構成です。この記事では、Redis公式のチュートリアルと仕様書をもとに、マスター3台・レプリカ3台の設定例と`redis-cli --cluster create`での構築、MOVEDとASKのリダイレクトの違い、redis-pyでの接続を示します。後半では、CROSSSLOTエラーとハッシュタグによるキー設計、再シャーディングとRedis 8.4で入ったアトミックなスロット移行、書き込みが消える条件とClusterを採用しない判断までを扱います。

## まとめ：Redis Clusterは1台のメモリに収まらない時だけ選び、キー設計から始める

Redis Clusterを選ぶ理由は、1台のメモリや書き込み性能に収まらないデータを複数ノードに分けることです。可用性だけが目的なら、レプリカとSentinelの構成で足ります。

構築そのものは難しくありません。各ノードで`cluster-enabled yes`を有効にし、データ用ポートと10000を足したクラスタバスのポートを開け、`redis-cli --cluster create`を1回流せば16384スロットが割り当てられます。

手間がかかるのはアプリ側です。クライアントをクラスタ対応に替え、一緒に使うキーにはハッシュタグを付けて同じスロットへ寄せます。後回しにすると、移行した日にCROSSSLOTエラーが並びます。

## Redis Clusterの仕組みをハッシュスロット・2つのポート・他構成との違いで整理

Redisの基本的な仕組みやデータ型は[Redisとは：仕組みとデータ型・Redis 8.10系の新機能とライセンス、Dockerで動かす手順](https://www.issoh.co.jp/tech/details/18876/)で解説しています。ここでは、Clusterがキーをどのノードに置くか、ノード同士がどう通信するかに絞ります。

### CRC16を16384で割るハッシュスロットとCLUSTER KEYSLOTでの確かめ方

[Redis公式の「Scale with Redis Cluster」](https://redis.io/docs/latest/operate/oss%5Fand%5Fstack/management/scaling/)によると、Redis Clusterは一貫性ハッシュを使いません。キー名のCRC16を16384で割った余りでハッシュスロットを決め、各マスターがスロットの範囲を受け持ちます。マスター3台なら、0〜5460、5461〜10922、10923〜16383のように分かれます。

```
redis-cli -c -p 7000 CLUSTER KEYSLOT somekey
(integer) 11058
redis-cli -c -p 7000 CLUSTER KEYSLOT foo{hash_tag}
(integer) 2515
redis-cli -c -p 7000 CLUSTER KEYSLOT bar{hash_tag}
(integer) 2515
```

上の値は[CLUSTER KEYSLOTのドキュメント](https://redis.io/docs/latest/commands/cluster-keyslot/)に載っている例です。キーとノードの対応は固定ではなく、スロットを丸ごと別のノードへ移すことでノードの追加や削除を無停止で行えます。データを分ける考え方そのものは[シャーディングとは？水平分割の仕組みとシャードキー設計を実装者目線で解説](https://www.issoh.co.jp/tech/details/16274/)で一般論として整理しています。

### 6379と16379の2ポートを開けるクラスタバスとファイアウォール設定

各ノードは2つのTCPポートを使います。クライアント用のデータポート（例：6379）と、ノード間の通信に使う「クラスタバス」のポートです。クラスタバスは既定でデータポートに10000を足した番号（6379なら16379）になり、`cluster-port`で変更できます。

クラスタバスでは、障害検知、構成の更新、フェイルオーバーの承認がバイナリのプロトコルで交わされます。クライアントがここに接続することはありません。公式は両方のポートを開けないとクラスタは期待どおり動かないと明記しています。データポートは、全クライアントに加えて、キーの移行に使うため他のノードからも届く必要があります。

### Sentinel構成・ElastiCacheクラスターモードとの違いを規模で比べた表

複数台の構成は、データを分けるかどうかで2つに分かれます。

| 構成               | データの分散    | 自動昇格         | 複数キー操作   | 運用で持つもの    |
| ---------------- | --------- | ------------ | -------- | ---------- |
| レプリカ＋Sentinel    | なし        | Sentinelが行う  | 制約なし     | Sentinel3台 |
| Redis Cluster    | 16384スロット | Cluster自身が行う | 同じスロットのみ | スロット配置と再配置 |
| ElastiCache有効モード | 1〜500シャード | AWSが行う       | 同じスロットのみ | シャード数と費用   |

Clusterに切り替えると、複数キー操作の制約がアプリ側に乗ります。データが1台に収まるなら、[Redisの冗長化：レプリケーションとSentinelで自動フェイルオーバーを組む設定例とElastiCache Multi-AZとの比較](https://www.issoh.co.jp/tech/details/19851/)で扱った構成のほうが単純です。

## マスター3台・レプリカ3台の6ノードでRedis Clusterを構築する設定手順

公式チュートリアルは、正しく動く最小構成をマスター3台とし、本番ではマスター3台・レプリカ3台の6ノードを強く推奨しています。ここでは1台のマシン上でポート7000〜7005を使って6ノードを立て、2026年11月時点の最新安定版[Redis 8.10.3](https://github.com/redis/redis/releases/tag/8.10.3)（10月26日公開）を想定します。

### 6ノード分のredis.confにcluster-enabledを書く設定例

```
# 7000〜7005 のディレクトリを作り、それぞれに redis.conf を置く
mkdir cluster-test && cd cluster-test
for port in 7000 7001 7002 7003 7004 7005; do
  mkdir -p "$port"
  cat > "$port/redis.conf" <<EOF
port $port
cluster-enabled yes
cluster-config-file nodes.conf
cluster-node-timeout 5000
appendonly yes
EOF
done

# 各ノードを起動する（ディレクトリごとに nodes.conf が作られる）
for port in 7000 7001 7002 7003 7004 7005; do
  (cd "$port" && redis-server ./redis.conf --daemonize yes)
done
```

`cluster-config-file`は名前に反して人が編集するファイルではなく、ノードが他のノードの一覧や状態を書き残す場所です。起動ログに出るNode IDが、クラスタ内でノードを識別する名前になります。`cluster-node-timeout`は[8.10.3同梱のredis.conf](https://raw.githubusercontent.com/redis/redis/8.10.3/redis.conf)では既定15000ミリ秒で、公式の例は5000ミリ秒にしています。

### redis-cli –cluster createで16384スロットを割り当てる

```
redis-cli --cluster create 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 \
  --cluster-replicas 1

# 提案された構成を確認して yes と入力する。成功すると最後に次の行が出る
[OK] All 16384 slots covered
```

`--cluster-replicas 1`は、マスター1台につきレプリカを1台付ける指定です。かつて使われた`redis-trib.rb`は不要で、構築は`redis-cli`だけで完結します。パスワードを設定したノードなら`-a`で渡せますが、履歴に残さない渡し方は[redis-cliの使い方：接続・認証・TLSの指定とSCANで安全にキーを探すコマンド一覧](https://www.issoh.co.jp/tech/details/19850/)にまとめました。手早く試すだけなら、ソースの`utils/create-cluster`にある`create-cluster start`と`create-cluster create`でも6ノードが立ち、こちらはポート30001から始まります。

### CLUSTER INFOとSHARDSでスロット割当と各ノードの役割を確かめる

```
redis-cli -p 7000 CLUSTER INFO      # cluster_state:ok と cluster_slots_assigned:16384 を見る
redis-cli -p 7000 CLUSTER SHARDS    # シャードごとのスロット範囲とマスター・レプリカ
redis-cli --cluster check 127.0.0.1:7000

# -c を付けるとリダイレクトを追いかける
redis-cli -c -p 7000
127.0.0.1:7000> set foo bar
-> Redirected to slot [12182] located at 127.0.0.1:7002
OK
```

最後の出力は公式チュートリアルの例です。スロットの割当を一覧するコマンドは、Redis 7.0で入った[CLUSTER SHARDS](https://redis.io/docs/latest/commands/cluster-shards/)を使います。以前からある`CLUSTER SLOTS`は7系で非推奨になりました。`redis-cli -c`のクラスタ対応は最低限で、毎回リダイレクトを受けてから飛び直します。アプリには、後述するスロット表を持つクライアントを使います。

### Dockerのポートマッピングで壊れる理由とhostネットワークでの回避

Redis ClusterはNATの内側や、IPアドレス・ポートが付け替えられる環境に対応していません。Dockerの`-p 7000:6379`のようなポートマッピングでは、ノードはコンテナ内のポートを他のノードとクライアントに知らせるため、外からはその番号に届きません。

```
# 公式が示す回避策：ホストのネットワークをそのまま使う
docker run -d --name redis-7000 --net=host \
  -v "$PWD/7000:/data" redis:8.10 redis-server /data/redis.conf
```

ポートを付け替えずにコンテナごとに別ポートを割り振り、`--net=host`で動かします。Kubernetesなどでノードのアドレスを固定できない場合は、`cluster-announce-ip`で他のノードへ知らせるアドレスを明示します。

## MOVEDとASKのリダイレクトとクラスタ対応クライアントの実装方法

Redis Clusterにはプロキシがありません。クライアントがスロットを計算して担当ノードへ直接送り、外れればノードがリダイレクトで正しい送り先を返します。

### MOVEDは恒久的な移動、ASKは移行中の一時転送という扱いの違い

[Redis Clusterの仕様書](https://redis.io/docs/latest/operate/oss%5Fand%5Fstack/reference/cluster-spec/)によると、担当外のスロットのキーを受けたノードは`-MOVED 3999 127.0.0.1:6381`のように、スロット番号と担当ノードのアドレスを返します。クライアントがそのノードへ送り直す際には、スロット表の更新も必要です。昇格が起きると旧マスターの全スロットが一度に動くため、1スロットずつ直すより、表をまるごと取り直すほうが簡単だと仕様書は書いています。

ASKは、スロットを別ノードへ移している最中にだけ返る一時的な転送です。移行先にまだ無いキーは移行元、移った分は移行先にあるためです。クライアントはその1件だけを`ASKING`コマンドに続けて移行先へ送り、スロット表は更新しません。次の要求は再び移行元へ送ります。移行が終わると移行元はMOVEDを返すようになり、そこで初めて表を書き換えます。

### redis-pyのRedisClusterで接続しスロット表を自動で更新する実装例

[redis-pyのClusteringのドキュメント](https://redis.readthedocs.io/en/stable/clustering.html)によると、`RedisCluster`は起動時に指定ノードのどれか1台へ接続し、16384スロットとノードの対応表、全ノードの一覧、コマンドの一覧をキャッシュします。リダイレクトを受ければ表を更新して送り直すため、アプリ側でMOVEDやASKを処理する必要はありません。

```
from redis.cluster import RedisCluster, ClusterNode

startup_nodes = [ClusterNode("10.0.1.10", 7000), ClusterNode("10.0.1.11", 7001)]
rc = RedisCluster(
    startup_nodes=startup_nodes,
    password="Redisのパスワード",
    read_from_replicas=False,  # True にするとREADONLYでレプリカにも読み取りを振る
)

rc.set("user:{1000}:name", "Angela")             # スロットは自動で計算される
rc.mset({"{cart:42}:items": "3", "{cart:42}:total": "4800"})  # 同じスロットなので通る
print(rc.mget_nonatomic("user:{1000}:name", "{cart:42}:total"))  # スロットごとに分けて送る

# キーを持たないコマンドは送り先を指定する
print(rc.dbsize(target_nodes=RedisCluster.PRIMARIES))
```

起動ノードは1台でも動きますが、その1台が落ちていると初期化に失敗するため、複数を渡します。`read_from_replicas=True`にすると`READONLY`モードになり、読み取りの振り分け先は、マスターとレプリカを順番に回る形です。仕様書はREADONLYを「古いデータを読んでも構わない」という宣言と定義しているので、書いた直後に読み直す処理はマスターから読みます。

## マルチキー操作の制約とハッシュタグでキーを同じスロットへ寄せる設計

単体のRedisからClusterへ移すとき、書き換えがもっとも多いのがここです。

### CROSSSLOTやTRYAGAINが出るMSET・トランザクション・Luaの条件

Redis Clusterが複数キーの操作を受け付けるのは、1回のコマンド、トランザクション全体、Luaスクリプト1回で扱うすべてのキーが同じスロットに属する場合だけです。`MSET a 1 b 2`のように別スロットのキーを並べるとCROSSSLOTエラーで拒否され、redis-pyでは`RedisClusterException`になります。

再シャーディング中に操作が成立する条件は、通常時よりも一段厳しいものです。仕様書によると、移行中のスロットで、存在しないキーや移行元と移行先に分かれたキーを含む複数キー操作は`-TRYAGAIN`エラーを返します。少し待って再実行すれば通るので、クライアントの再試行回数を0にしていないかを確認します。

### {user:1000}のハッシュタグ規則と1スロットへの偏りを避けるキー設計

キー名に`{`と`}`で囲んだ部分があると、そこだけがハッシュの対象になります。`{user1000}.following`と`{user1000}.followers`は同じスロットに入るため、同じトランザクションでまとめて扱うことが可能です。規則は「最初の`{`と、その後で最初に現れる`}`の間」で、仕様書には紛らわしい例も載っています。

- `foo{}{bar}`：最初の括弧の中身が空なので、キー全体がハッシュされる
- `foo{{bar}}zap`：`{bar`がハッシュされる
- `foo{bar}{zap}`：`bar`だけがハッシュされる

ハッシュタグは付けすぎると逆効果です。全キーに`{app}`のような共通のタグを付けると、すべてが1スロット、つまり1台のマスターに集まり、Clusterにした意味がなくなります。タグにはユーザーIDや注文IDのように値が十分に散らばり、かつ一緒に操作するキーの単位を選びます。

## ノード追加と再シャーディング、手動フェイルオーバーの運用手順

スロットはノード間で動かせるため、Clusterは止めずに台数を増減できます。

### add-nodeとreshardでスロットを新しいマスターへ移す無停止の拡張手順

```
# 空のノード 7006 を、既存ノード 7000 を窓口にしてマスターとして追加
redis-cli --cluster add-node 127.0.0.1:7006 127.0.0.1:7000

# 7006 をレプリカとして足す場合は、どのマスターに付けるかを指定する
redis-cli --cluster add-node 127.0.0.1:7007 127.0.0.1:7000 \
  --cluster-slave --cluster-master-id <マスターのNode ID>

# 1000スロットを指定ノードから 7006 へ移す（対話なし）
redis-cli --cluster reshard 127.0.0.1:7000 --cluster-from <移行元のNode ID> \
  --cluster-to <7006のNode ID> --cluster-slots 1000 --cluster-yes

redis-cli --cluster check 127.0.0.1:7000
```

追加したばかりのマスターはスロットを1つも持たず、データも受け取りません。`reshard`でスロットを移して初めて負荷が分かれます。キーの量の偏りまで均したい場合に使うコマンドは、`redis-cli --cluster rebalance`です。外すときは逆の順で、マスターなら先にスロットを他へ移して空にしてから`redis-cli --cluster del-node`を実行します。

### Redis 8.4のCLUSTER MIGRATIONによるアトミックなスロット移行

従来の`reshard`はキーを1件ずつ移すため、その間はASKとTRYAGAINが発生します。[CLUSTER MIGRATION](https://redis.io/docs/latest/commands/cluster-migration/)は、Redis Open Source 8.4.0から使えるアトミックなスロット移行のコマンドで、移行先のマスターで実行します。

```
# 移行先のマスターで、スロット 0〜1000 と 2000〜3000 を取り込む（タスクIDが返る）
CLUSTER MIGRATION IMPORT 0 1000 2000 3000

# 進み具合を見る。state が completed なら完了、last_error が空ならエラーなし
CLUSTER MIGRATION STATUS ALL

# 取り消す。移行元で取り消しても移行先は再試行を続けるので両方で実行する
CLUSTER MIGRATION CANCEL ALL
```

スロットの受け渡しの瞬間、移行元は書き込みを一時停止します。停止の上限は`cluster-slot-migration-write-pause-timeout`で、既定は10秒です。移行中は`DBSIZE`や`CLUSTER COUNTKEYSINSLOT`が取り込み途中のキーを数えないことがあるため、件数で完了を判定せず`STATUS`の結果で判断します。8.4より前の版やマネージドサービスでは使えないので、手元の版を`INFO server`で確かめてから手順に組み込みます。

### CLUSTER FAILOVERで計画メンテナンス前にマスターを切り替える方法

マスターのサーバーを再起動する前には、そのレプリカで`CLUSTER FAILOVER`を実行し、役割を先に入れ替えます。[CLUSTER FAILOVERのドキュメント](https://redis.io/docs/latest/commands/cluster-failover/)によると、既定の動作ではレプリカがマスターと協調し、複製が追いついたことを確かめてから昇格するため、障害時の自動昇格と違って書き込みを失いません。

マスターに届かない時の`FORCE`は、マスターとのやり取りを省いて昇格します。`TAKEOVER`はさらにクラスタの承認も省くため、データセンターごと切り替えるような非常時に限ります。普段の保守で使うのは、オプションなしの形だけです。

## 書き込みが消える条件とnode timeoutで決めるClusterの採用条件

Redis Clusterは強い一貫性を保証せず、成功を返した書き込みでも条件次第で失われると公式は明記しています。

### 非同期複製とネットワーク分断で確認済みの書き込みが消える2つの条件

1つ目は非同期複製です。マスターはレプリカへの反映を待たずにOKを返すため、返した直後にマスターが落ち、その書き込みを受け取っていないレプリカが昇格すると、書き込みは消えます。`WAIT`で同期に近づけられますが、仕様上は強い一貫性にはなりません。

2つ目はネットワーク分断です。マスター1台と一部のクライアントだけが少数派側に孤立すると、そのマスターは書き込みを受け続けます。多数派側でレプリカが昇格した場合に捨てられるのは、孤立中に受け付けた書き込みです。失う範囲の上限を決めるのが`cluster-node-timeout`で、この時間を過ぎると多数派側はマスターを障害とみなし、少数派側のマスターは書き込みを止めます。短くすれば欠損の窓は縮みますが、一時的な遅延でも昇格が走りやすくなります。

### 障害時に書き込みと読み取りを止めるかを決める3つのcluster設定

8.10.3同梱のredis.confの既定値と、既定のときの動きは次のとおりです。

- `cluster-require-full-coverage yes`：担当のないスロットが1つでもあると書き込みを止める
- `cluster-allow-reads-when-down no`：クラスタが障害状態になると読み取りも止める
- `cluster-migration-barrier 1`：レプリカを1台残せるマスターだけが、レプリカのいないマスターへ余りを譲る

キャッシュ用途なら、full-coverageを`no`にして落ちたシャード以外のキーを使い続ける判断もあります。セッションのように欠けると不整合になるデータでは、既定の設定を維持する判断です。allow-reads-when-downの`yes`は、シャード1〜2台で自動昇格できない構成の選択肢として公式が挙げています。

### Redis Clusterを採用する条件と、Sentinelやマネージドで済ませる場面

自前でRedis Clusterを組むのは、データ量か書き込み量が1台のマスターを超え、オンプレミスやAWS以外の環境で動かす場合です。その場合も、6ノード以上を独立して故障するマシンに分けられること、再シャーディングと`CLUSTER FAILOVER`の手順を本番前に試せることが前提になります。

次の場面ではClusterを選びません。

- データが1台のメモリに収まる：Sentinel構成で足り、複数キー操作の制約も負わない
- アプリがLuaやトランザクションで任意のキーを組み合わせている：キー名の設計をやり直す工数が先に立つ
- AWS上で動いている：ElastiCacheのクラスターモード有効なら1〜500シャードを扱え、オンライン再シャーディングもAPIで済む

上限の数字は[ElastiCacheのクラスターモードの比較](https://docs.aws.amazon.com/AmazonElastiCache/latest/dg/Replication.Redis-RedisCluster.html)にあり、AWSでの選択肢は[AWSでRedisを使う方法：ElastiCache・MemoryDB・EC2の選び分けと接続手順](https://www.issoh.co.jp/tech/details/18078/)で比べています。単体のRedisから稼働中のまま自動で移す手段は公式にも無く、キー名の書き換えとクライアントの差し替えを含めた移行計画が必要です。[データベース設計・移行支援](https://www.issoh.co.jp/service/system/database/)では、Redisを含むデータ層のスケール設計やマネージドへの移行の相談を受けています。

## よくある質問

Redis Clusterについて、構築や移行の段階でよく調べられる質問に答えます。

### Redis Clusterは最低何台のノードが必要ですか？

正しく動く最小構成はマスター3台です。ただし、マスターだけではどれか1台が落ちた時点でそのスロットが使えなくなるため、公式は本番向けにマスター3台・レプリカ3台の6ノードを強く推奨しています。1台のマシン上の6プロセスでも試せますが、本番では各マスターとそのレプリカを別々のマシンやアベイラビリティゾーンに分け、同時に落ちないようにします。

### Redis ClusterでSELECTを使ってデータベースを分けられますか？

使えません。仕様書は、Redis Clusterが扱うのはデータベース0だけで、`SELECT`コマンドは許可しないと定めています。単体のRedisで用途ごとにデータベース番号を分けていた場合は、`session:`や`cache:`のようにキーの接頭辞で分けるか、用途ごとに別のクラスタを用意する方法が選択肢です。接続文字列の末尾に`/1`などを付けている設定も見直します。

### Redis ClusterとSentinelは一緒に使いますか？

一緒には使いません。Redis Clusterでは、マスターの障害検知とレプリカの昇格をノード同士がクラスタバス上で行うため、Sentinelの出番がありません。Sentinelは、データを分散しない「マスター1台＋レプリカ」の構成に自動フェイルオーバーを足す仕組みです。どちらにするかは、データが1台に収まるかどうかで決めます。

### Redis ClusterでPub/Subは使えますか？

使えます。通常の`PUBLISH`はクラスタ全体へ配られますが、Redis 7.0以降はシャーデッドPub/Subがあり、`SSUBSCRIBE`や`SPUBLISH`ではチャンネル名がキーと同じ規則でスロットに割り当てられ、担当シャードの中だけでやり取りされます。ノードが増えても配信の負荷が全体に広がりにくい方式です。redis-pyのドキュメントは、パターン購読はスロットが決まらないため現状では推奨しないとしています。

### Redis Clusterのノード数に上限はありますか？

仕様書は設計目標を「最大1000ノードまでの線形なスケール」としています。各ノードが毎秒pingを送る相手は数台に限られ、台数が増えても1ノードの送信数はほぼ一定です。ただ、台数が増えるほど再シャーディングや障害対応の手間は増えるため、まず1ノードのメモリを大きくする案と比べます。ElastiCacheのクラスターモード有効では、1〜500シャード、各シャード0〜5台のレプリカが上限です。

## 関連記事

- [Redisとは：仕組みとデータ型・Redis 8.10系の新機能とライセンス、Dockerで動かす手順](https://www.issoh.co.jp/tech/details/18876/)：Redis本体の仕組みと3つの可用性構成の概要
- [Redisの冗長化：レプリケーションとSentinelで自動フェイルオーバーを組む設定例とElastiCache Multi-AZとの比較](https://www.issoh.co.jp/tech/details/19851/)：データを分けない構成での冗長化
- [redis-cliの使い方：接続・認証・TLSの指定とSCANで安全にキーを探すコマンド一覧](https://www.issoh.co.jp/tech/details/19850/)：Cluster構築にも使うCLIの基本
- [Amazon ElastiCacheとは？対応エンジン・Serverlessとノードベースの違いと料金・採用判断を実装者目線で解説](https://www.issoh.co.jp/tech/details/15455/)：マネージドでClusterを使う場合の全体像
- [シャーディングとは？水平分割の仕組みとシャードキー設計を実装者目線で解説](https://www.issoh.co.jp/tech/details/16274/)：スロットとキー設計の一般論

---

出典: [Redis Clusterの構築手順：16384ハッシュスロットの仕組みとMOVED・ASK、redis-pyでの接続と再シャーディング【Redis 8.10系】](<https://www.issoh.co.jp/tech/details/19853/>)（株式会社一創）
