Sur cette page
Redis Cluster est la solution intégrée de sharding de Redis : il divise le keyspace en 16 384 hash slots, attribue ces slots à plusieurs nœuds primaires, dote chaque primaire de ses propres réplicas et gère lui-même le basculement, sans Sentinel. Il n'y a pas de proxy. Les clients se connectent directement aux nœuds, conservent une table indiquant quel nœud détient quel slot, et suivent les redirections MOVED et ASK lorsque cette table n'est plus à jour.
Cette page explique le fonctionnement de Cluster et ce qui coince en production. Pour le choix entre Sentinel et Cluster et le déroulé détaillé du basculement, notre guide sur la haute disponibilité (HA) de Redis traite les deux en profondeur.
Comment Redis attribue les clés aux hash slots
Chaque clé appartient à un seul slot, calculé par CRC16(key) mod 16384. Chaque primaire détient un sous-ensemble des slots et, dans un cluster stable, chaque slot est servi par un seul primaire. 16 384 est aussi le plafond théorique de primaires, mais la spécification de Redis Cluster recommande de rester autour de 1 000 nœuds et fixe comme objectif de conception une scalabilité linéaire jusqu'à cette taille.
N'importe quel nœud vous indique où tombe une clé :
CLUSTER KEYSLOT user:1000
CLUSTER KEYSLOT {user:1000}:cartLes hash tags modifient ce calcul. Si une clé contient un { suivi plus loin d'un }, avec au moins un caractère entre les deux, seul le texte compris entre le premier { et le } suivant est haché. Ainsi, {user1000}.following et {user1000}.followers partagent un slot. Les cas limites piègent souvent : foo{}{bar} est haché en entier car les premières accolades sont vides, et foo{bar}{zap} ne hache que bar.
Les hash tags regroupent les clés liées, mais c'est aussi par eux que les équipes créent des points chauds. Marquer chaque clé d'un gros tenant avec {tenant42} place tout ce tenant dans un seul slot, sur un seul primaire. Taguez selon la plus petite unité nécessitant un accès multi-clés atomique : généralement un utilisateur, une commande ou une session.
Limites du sharding Redis : ce qui change pour l'application
Passer d'une instance unique à Cluster est quasi transparent pour les commandes mono-clé. Ce n'est pas le cas pour tout ce qui touche plusieurs clés :
- Commandes multi-clés :
MSET,SINTERouRENAMEne s'exécutent que si toutes les clés sont dans le même slot ; sinon, le nœud renvoie une erreurCROSSSLOT. Les clés utilisées ensemble dans des transactionsMULTI/EXECet des scripts Lua suivent la même règle. - Une seule base. Redis Cluster ne prend en charge que la base 0 et rejette
SELECT: les applications qui séparent leurs données par numéro de base doivent passer à des préfixes de clés. Valkey 9.0 a ajouté les bases numérotées en mode cluster, l'un des points où les deux forks divergent désormais. - Les commandes portant sur toute la base agissent par nœud. Tout ce qui parcourt, compte ou vide le keyspace ne voit que la part du nœud connecté : l'outillage doit donc interroger chaque primaire.
- Pub/Sub. Les messages Pub/Sub classiques sont propagés à tous les nœuds via le bus du cluster. Redis 7.0 a introduit le Pub/Sub shardé (
SPUBLISHetSSUBSCRIBE), qui associe les canaux à des slots comme les clés et maintient le trafic dans un seul shard. - Les grosses clés restent grosses. Une clé réside dans un seul slot : un sorted set de plusieurs gigaoctets occupe un seul primaire et ses réplicas. Cluster répartit les clés, pas les valeurs.
Redirections MOVED et ASK
Un nœud qui reçoit une commande pour un slot qu'il ne détient pas ne la relaie pas. Il répond par une redirection, et le client doit faire une nouvelle tentative ailleurs :
GET x
-MOVED 3999 127.0.0.1:6381MOVED signifie que le slot appartient à un autre nœud. Un client compatible cluster met à jour sa table des slots et envoie directement les requêtes suivantes pour ce slot au nouveau détenteur. ASK n'apparaît que pendant la migration d'un slot, lorsqu'une clé a peut-être déjà été déplacée. Le client envoie ASKING puis la commande au nœud cible pour cette seule requête, et continue d'utiliser l'ancien nœud pour tout le reste jusqu'à la fin de la migration.
La bibliothèque cliente compte : elle doit gérer les deux redirections, rafraîchir sa table des slots et router chaque commande selon son slot. redis-cli -c suit les redirections ; redis-cli seul se contente de les afficher. Le resharding a aussi un coût. Pendant la migration clé par clé, les requêtes visant le slot en cours de déplacement nécessitent des allers-retours supplémentaires, et les opérations multi-clés sur ce slot peuvent échouer jusqu'à la fin. Valkey 9.0 a introduit la migration atomique des slots, qui déplace un slot entier avant d'en transférer la propriété et évite ces redirections en cours de migration.
Bus du cluster, détection des pannes et basculement
Chaque nœud ouvre un second port TCP pour le trafic entre nœuds : le bus du cluster. Par défaut, il s'agit du port client plus 10000, soit 16379 pour un nœud sur 6379, sauf si cluster-port le définit. Chaque nœud se connecte à tous les autres et utilise un protocole gossip sur ce bus pour partager l'état, détecter les pannes et coordonner les basculements. Les deux ports doivent être ouverts entre tous les nœuds ; ouvrir 6379 sans 16379 donne des nœuds qui ne forment jamais de cluster.
Lorsqu'un primaire reste injoignable au-delà de cluster-node-timeout, l'un de ses réplicas est promu après un vote des primaires. Notre présentation détaillée du basculement décrit cette séquence. Quatre paramètres déterminent ce que voient les clients pendant ce temps :
cluster-node-timeout: délai avant qu'un nœud soit considéré en panne. Trop bas, une pause de VM ou un fork lent déclenche des basculements inutiles.cluster-require-full-coverage:yespar défaut, ce qui bloque les écritures sur tout le cluster si un slot n'est servi par aucun nœud. Passez-le ànouniquement si servir une partie du keyspace vaut mieux que rien.cluster-allow-reads-when-down:nopar défaut, les nœuds cessent donc de servir tout trafic dès que le cluster est marqué en échec.cluster-migration-barrier: contrôle la migration des réplicas, par laquelle un réplica excédentaire rejoint un primaire qui a perdu le sien. Un seul réplica supplémentaire peut ainsi protéger plusieurs shards.
La réplication est asynchrone, et la spécification indique clairement que Redis Cluster peut perdre des écritures déjà acquittées, avec une fenêtre plus large pour les clients situés du côté minoritaire d'une partition réseau. Considérez-le comme un stockage rapide et hautement disponible, pas comme un stockage fortement cohérent.
Redis Sentinel ou Cluster, en bref
Sentinel ajoute le basculement automatique à un jeu de données sur un seul primaire ; Cluster ajoute le sharding lorsque les données ou le débit d'écriture ne tiennent plus sur un nœud. Si un seul nœud avec une marge de capacité suffisante contient tout, Sentinel conserve toute la sémantique multi-clés et des clients plus simples. Le tableau comparatif et les règles de choix se trouvent dans Haute disponibilité Redis : Sentinel ou Cluster.
Dimensionner un Redis Cluster
La documentation Redis impose au minimum trois primaires et recommande, pour un déploiement, un cluster de six nœuds : trois primaires et trois réplicas. Ensuite :
- Déduisez le nombre de shards de la mémoire et du débit d'écriture. Divisez le jeu de données, croissance comprise, par ce qu'un primaire peut contenir en gardant de la place pour le fork de persistance et les buffers de réplication ; notre guide sur la mémoire Redis explique pourquoi la mémoire résidente peut largement dépasser le jeu de données pendant un snapshot. Vérifiez ensuite le débit d'écriture que chaque primaire supportera.
- Équilibrez les shards.
redis-cli --cluster rebalanceéquilibre le nombre de slots, et le tutoriel Redis précise qu'il ne tient pas compte de la répartition des clés. Les tags chauds et les grosses clés se corrigent dans la conception des clés, pas en déplaçant des slots. - Séparez les domaines de défaillance. Ne placez jamais un primaire et son propre réplica sur le même hôte, le même hyperviseur ou la même zone de disponibilité (AZ).
- Anticipez la croissance. Ajouter un shard implique
redis-cli --cluster add-node, puis un resharding des slots vers le nouveau nœud. Faites-le avec de la marge de capacité, pas pendant un incident.
Un nouveau cluster avec un réplica par primaire se crée avec --cluster-replicas 1 :
redis-cli --cluster create 10.0.0.1:6379 10.0.0.2:6379 10.0.0.3:6379 \
10.0.0.4:6379 10.0.0.5:6379 10.0.0.6:6379 --cluster-replicas 1Les pièges d'exploitation les plus fréquents
- Conteneurs avec mappage de ports. Redis Cluster ne prend pas en charge le NAT ni les ports remappés, car les nœuds annoncent des adresses que les autres ne peuvent pas joindre. La documentation Redis oriente les utilisateurs de Docker vers le mode réseau host.
- Clients avec une table des slots obsolète. Après un basculement ou un resharding, un client qui rafraîchit trop rarement sa table continue de viser le mauvais nœud et double chaque requête.
- Erreurs
CROSSSLOTaprès migration. Du code qui fonctionnait sur une instance unique échoue dès qu'une transaction touche deux clés sans rapport. Détectez-les par des tests d'intégration sur un vrai cluster avant la bascule. - Pannes liées à la couverture complète. Perdre un primaire et son unique réplica bloque les écritures sur tout le cluster avec les paramètres par défaut. Le nombre de réplicas, les domaines de défaillance et la migration des réplicas l'évitent.
Pour des symptômes comme des erreurs CLUSTERDOWN après un resharding, consultez Dépannage Redis.
Quand faire appel à nous
Cluster récompense une conception des clés et une topologie bien pensées dès le départ, et pénalise les corrections faites sous charge. Si vous passez d'une instance unique ou de Sentinel à Cluster, si vous devez resharder un cluster devenu déséquilibré ou si le vôtre bascule plus souvent qu'il ne le devrait, les ingénieurs du support Redis d'AceMQ travaillent chaque jour avec Redis Cluster open source, et le support Valkey couvre la même topologie sur le fork de la Linux Foundation. Si vous préférez ne pas l'exploiter vous-même, nos services managés Redis prennent en charge l'exploitation de bout en bout.
Références
- Redis : spécification de Redis Cluster
- Redis : passer à l'échelle avec Redis Cluster (tutoriel et paramètres de configuration)
- Redis : opérations multi-clés
- Redis : CLUSTER KEYSLOT
- Redis : Pub/Sub (Pub/Sub shardé)
- Valkey : présentation de Valkey 9.0
- Valkey : migration atomique des slots
- Valkey : bases numérotées en mode cluster
Questions fréquentes
Qu'est-ce que Redis Cluster ?
Redis Cluster est le mode de sharding intégré à Redis. Il divise le keyspace en 16 384 hash slots, les répartit entre plusieurs nœuds primaires dotés chacun de leurs réplicas, et promeut automatiquement un réplica lorsqu'un primaire tombe en panne, sans couche Sentinel distincte.
Qu'est-ce qu'un hash slot dans Redis ?
L'un des 16 384 compartiments entre lesquels le keyspace de Redis Cluster est divisé. Chaque clé est associée à un slot via CRC16(key) mod 16384, et chaque slot est servi par un seul primaire à la fois. CLUSTER KEYSLOT renvoie le slot d'une clé donnée.
Que sont les hash tags Redis ?
Une partie du nom de clé entre accolades, par exemple {user1000}.following. Lorsqu'une clé contient une section {...} non vide, seul le texte de la première paire d'accolades est haché : les clés liées tombent ainsi dans le même slot et peuvent être utilisées ensemble dans des commandes multi-clés, des transactions et des scripts Lua.
Quelle différence entre MOVED et ASK dans Redis Cluster ?
MOVED signifie que le slot appartient désormais durablement à un autre nœud : le client doit mettre à jour sa table des slots. ASK n'apparaît que pendant la migration d'un slot : le client envoie ASKING puis la commande au nœud cible pour cette seule requête, et continue d'utiliser le nœud d'origine pour tout le reste.
Redis Cluster prend-il en charge plusieurs bases de données ?
Non. Redis Cluster ne prend en charge que la base 0 et rejette la commande SELECT. Valkey a ajouté les bases numérotées en mode cluster avec Valkey 9.0.
Qu'est-ce que le sharding Redis ?
La répartition des données entre plusieurs primaires Redis, afin que le jeu de données et la charge d'écriture ne soient plus limités à un seul nœud. Redis Cluster le fait côté serveur avec les hash slots ; l'alternative est un hachage côté client sur des instances indépendantes, sans basculement automatique entre elles.
Redis Sentinel ou Redis Cluster : lequel choisir ?
Choisissez Sentinel lorsque le jeu de données et le débit d'écriture tiennent largement sur un seul primaire : vous conservez toute la sémantique multi-clés et des clients plus simples. Choisissez Cluster dans le cas contraire. Cluster n'est pas plus disponible en soi, car son basculement repose sur la même promotion de réplica.
Parler à un ingénieur
Besoin d’un coup de main sur Redis ?
Des ingénieurs seniors qui l’exploitent en production. Demandez un devis ou une consultation gratuite, sans argumentaire commercial.
Guides, comparatifs et études

