Comment modifier le mode de cluster de mon cluster ElastiCache pour Valkey ou ElastiCache for Redis OSS ?

Brève description

Remarque : Vous pouvez modifier la configuration du mode cluster uniquement en passant du mode cluster désactivé au mode cluster activé. Une fois que vous avez modifié le mode cluster, vous ne pouvez plus rétablir votre configuration.

Prérequis :

• Le cluster doit uniquement compter des clés dans la base de données 0.
• Les applications doivent utiliser un client Valkey ou Redis OSS capable d’utiliser le protocole de cluster et un point de terminaison de configuration.
• Pour le cluster, vous devez activer le basculement automatique et disposer d'au moins 1 réplica.
• Pour la migration, votre cluster doit disposer d'une version de moteur de Valkey 7.2 et versions ultérieures, ou de Redis OSS 7.0 et versions ultérieures. Pour plus d'informations, consultez la section Modification du mode cluster.

Pour mettre à jour votre mode cluster du mode cluster désactivé au mode cluster activé, effectuez les tâches suivantes :

1. Mettez à jour le mode cluster en passant du mode cluster désactivé à Compatible.
2. Mettez à jour le mode cluster de Compatible au mode cluster activé.

Remarque : Pendant ce processus de migration, le cluster reste disponible.

Résolution

Avant de passer en mode Compatible, vous devez définir le paramètre en cluster sur Oui. Si vous utilisez un groupe de paramètres par défaut, ElastiCache pour Valkey et ElastiCache for Redis OSS choisissent le groupe de paramètres par défaut. La configuration en cluster de ce groupe de paramètres par défaut est définie sur Oui, et vous n'avez aucune action à effectuer.

Remarque : Si vous utilisez un groupe de paramètres personnalisé, choisissez-en un nouveau lorsque vous modifiez le cluster. Vous pouvez également créer un nouveau groupe de paramètres pour la même famille de moteurs avec le paramètre en cluster défini sur oui.

Mettre à jour le mode cluster en passant du mode cluster désactivé à Compatible

Remarque : Si des erreurs surviennent lorsque vous exécutez des commandes de l'interface de la ligne de commande AWS (AWS CLI), consultez la section Résoudre des erreurs liées à l’AWS CLI. Vérifiez également que vous utilisez bien la version la plus récente de l'interface.

En mode Compatible, ElastiCache déploie une seule partition pour fonctionner avec le nœud. Avec cette configuration, l'application client peut utiliser l'un ou l'autre des protocoles pour communiquer avec le cluster.

Procédez comme suit :

1. Ouvrez la console ElastiCache.
2. Dans le volet de navigation, choisissez votre type de ressource, puis sélectionnez votre cluster.
3. Sélectionnez Modifier.
4. Dans Mode cluster, choisissez Compatible.
5. (Facultatif) Choisissez un groupe de paramètres personnalisé avec le paramètre En cluster défini sur oui.
   Remarque : Si vous utilisez un groupe de paramètres par défaut, aucune action n'est nécessaire.
6. Choisissez Prévisualiser les modifications, puis cliquez sur Enregistrer les modifications.

Pour utiliser l'AWS CLI afin de modifier le cluster, exécutez la commande modify-replication-group et mettez à jour le paramètre mode cluster sur compatible.

Exemple :

aws elasticache modify-replication-group \
    --replication-group-id test-cluster \
    --cluster-mode compatible  \
    --apply-immediately

Remarque : Dans l'exemple précédent, remplacez test-cluster par le nom de votre cluster. Pour plus d'informations, consultez la section Modification d'un groupe de réplication.

Une fois que le mode cluster est passé à Compatible, vous pouvez utiliser le point de terminaison de configuration récemment créé pour tester la connectivité activée par le mode cluster depuis l'application. Vous pouvez également utiliser les points de terminaison principal et de lecteur pour gérer la connectivité désactivée en mode cluster existante pour le cluster.

À partir du mode Compatible, vous pouvez également revenir au mode cluster désactivé et conserver les configurations d'origine.

Mettre à jour le mode cluster de Compatible à mode cluster activé

Une fois que vous avez migré tous les clients Valkey ou Redis OSS vers le mode cluster activé, l'application client prend en compte les clusters. À partir de cet état, vous pouvez définir le paramètre du mode cluster sur activé.

Procédez comme suit :

1. Ouvrez la console ElastiCache.
2. Dans le volet de navigation, choisissez votre type de ressource, puis sélectionnez votre cluster.
3. Sélectionnez Modifier.
4. Sous Mode cluster, choisissez ** Activé**.
5. Choisissez Prévisualiser les modifications, puis cliquez sur Enregistrer les modifications.

Pour utiliser l'AWS CLI afin de modifier le cluster, exécutez la commande modify-replication-group et mettez à jour le paramètre mode cluster sur activé.

Exemple :

aws elasticache modify-replication-group \
    --replication-group-id test-cluster \
    --cluster-mode enabled  \
    --apply-immediately

Remarque : Dans l'exemple précédent, remplacez test-cluster par le nom de votre cluster.

Une fois les modifications de mode de cluster terminées, les points de terminaison du cluster changent également. Étant donné qu’il n'existe plus de point de terminaison principal ou de lecteur, assurez-vous de mettre à jour vos applications avec le nouveau point de terminaison de configuration.

Remarque : Il est recommandé de consulter la documentation de votre client afin de le configurer de manière qu'il prenne en charge l'interaction avec un cluster (mode cluster activé). Pour plus d'informations, consultez la page Spécification du cluster sur le site Web de Valkey.

Informations connexes

Réplication : Modes Désactivé et Activé pour le cluster Valkey et Redis OSS

Bonnes pratiques Clients Redis et Amazon ElastiCache for Redis.