Modification du mode cluster - Amazon ElastiCache

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Modification du mode cluster

Valkey et Redis OSS sont des bases de données en mémoire distribuées qui prennent en charge le sharding et la réplication. ElastiCache Les clusters Valkey et Redis OSS sont l'implémentation distribuée qui permet de partitionner les données sur plusieurs nœuds. Un cluster ElastiCache pour Redis OSS possède deux modes de fonctionnement, le mode cluster activé (CME) et le mode cluster désactivé (CMD). Dans CME, un moteur Valkey et Redis OSS fonctionne comme une base de données distribuée avec plusieurs partitions et nœuds, tandis que dans CMD, Valkey et Redis OSS fonctionnent comme un seul nœud.

Avant d'effectuer une migration de CMD à CME, les conditions suivantes doivent être remplies :

Important

La configuration du mode cluster ne peut être modifiée que du mode cluster désactivé vers le mode cluster activé. Il n'est pas possible d'inverser cette configuration.

  • Le cluster ne peut avoir que des clés dans la base de données 0 uniquement.

  • Les applications doivent utiliser un client Valkey ou Redis OSS capable d'utiliser le protocole Cluster et d'utiliser un point de terminaison de configuration.

  • Le basculement automatique doit être activé sur le cluster avec au moins 1 réplica.

  • La version minimale du moteur requise pour la migration est Valkey 7.2 et versions ultérieures, ou Redis OSS 7.0 et versions ultérieures.

Afin de migrer de CMD vers CME, la configuration du mode cluster doit être modifiée du mode cluster désactivé vers le mode cluster activé. Il s'agit d'une procédure en deux étapes qui garantit la disponibilité du cluster pendant le processus de migration.

Note

Vous devez fournir un groupe de paramètres avec une configuration de cluster activé, c'est-à-dire que le paramètre de cluster activé est défini sur yes. Si vous utilisez un groupe de paramètres par défaut, ElastiCache pour Redis, OSS choisira automatiquement le groupe de paramètres par défaut correspondant avec une configuration compatible avec les clusters. La valeur du paramètre de cluster activé est définie sur no pour un cluster CMD. Lorsque le cluster passe en mode compatible, la valeur du paramètre de cluster activé est mise à jour vers yes dans le cadre de l'action de modification.

Pour plus d’informations, consultez Configuration des paramètres du moteur à l'aide de groupes de ElastiCache paramètres.

  1. Préparation : créez un cluster CME de test et assurez-vous que votre stack est prêt à fonctionner avec celui-ci. ElastiCache pour Redis OSS n'a aucun moyen de vérifier que vous êtes prêt. Pour de plus amples informations, veuillez consulter Création d'un cluster pour Valkey ou Redis OSS.

  2. Modifier la configuration existante du cluster CMD pour qu'elle soit compatible avec le mode cluster — Dans ce mode, une seule partition sera déployée et, ElastiCache pour Redis OSS, elle fonctionnera comme un nœud unique mais également comme un cluster de partitions unique. Le mode compatible signifie que l'application cliente peut utiliser l'un ou l'autre des protocoles pour communiquer avec le cluster. Dans ce mode, les applications doivent être reconfigurées pour commencer à utiliser le protocole Valkey ou Redis OSS Cluster et le point de terminaison de configuration. Pour passer du mode cluster Valkey ou Redis OSS au mode cluster compatible, suivez les étapes ci-dessous :

    Note

    En mode compatible, les autres opérations de modification telles que la mise à l'échelle et la version du moteur ne sont pas autorisées pour le cluster. De plus, les paramètres (à l'exceptioncacheParameterGroupName) ne peuvent pas être modifiés lors de la définition d'un paramètre en mode cluster dans la demande. ModifyReplicationGroup

    1. Utilisation du mode cluster AWS Management Console, consultez Modification d'un groupe de réplication et réglez le mode cluster sur Compatible

    2. À l'aide de l'API, consultez ModifyReplicationGroupet mettez à jour le ClusterMode paramètre surcompatible.

    3. À l'aide de AWS CLI, consultez modify-replication-groupet mettez à jour le cluster-mode paramètre surcompatible.

    Après avoir changé le mode de cluster Valkey ou Redis OSS en mode cluster compatible, l'DescribeReplicationGroupsAPI renverra le point de terminaison de configuration du ElastiCache cluster Redis OSS. Le point de terminaison de configuration du cluster est un point de terminaison unique qui peut être utilisé par les applications pour se connecter au cluster. Pour de plus amples informations, veuillez consulter Recherche de points de terminaison de connexion dans ElastiCache.

  3. Modifier la configuration du cluster en mode cluster activé : une fois que le mode cluster est défini comme compatible avec le mode cluster, la deuxième étape consiste à modifier la configuration du cluster en mode cluster activé. Dans ce mode, une seule partition est en cours d'exécution et les clients peuvent désormais mettre à l'échelle leurs clusters ou modifier d'autres configurations de cluster.

    Pour activer le mode cluster, procédez comme suit :

    Avant de commencer, assurez-vous que vos clients Valkey ou Redis OSS ont migré vers le protocole de cluster et que le point de terminaison de configuration du cluster n'est pas utilisé.

    1. À l'aide de AWS Management Console, consultez Modification d'un groupe de réplication et réglez le mode cluster sur Activé.

    2. À l'aide de l'API, consultez ModifyReplicationGroupet mettez à jour le ClusterMode paramètre surenabled.

    3. À l'aide de AWS CLI, consultez modify-replication-groupet mettez à jour le cluster-mode paramètre surenabled.

    Après avoir changé le mode cluster en mode activé, les points de terminaison seront configurés conformément à la spécification du cluster Valkey ou Redis OSS. L'DescribeReplicationGroupsAPI renverra le paramètre du mode cluster sous forme enabled de points de terminaison du cluster qui sont désormais disponibles pour être utilisés par les applications pour se connecter au cluster.

    Notez que les points de terminaison du cluster changent une fois que le mode cluster devient activé. Veillez à mettre à jour vos applications à l'aide des nouveaux points de terminaison.

Vous pouvez également choisir de revenir au mode cluster désactivé (CMD) à partir du mode cluster compatible et de conserver les configurations d'origine.

Modifier la configuration du cluster du mode cluster activé au mode cluster désactivé

  1. Utilisation du mode cluster AWS Management Console, consultez Modification d'un groupe de réplication et réglez le mode cluster sur Disabled

  2. À l'aide de l'API, consultez ModifyReplicationGroupet mettez à jour le ClusterMode paramètre surdisabled.

  3. À l'aide de AWS CLI, consultez modify-replication-groupet mettez à jour le cluster-mode paramètre surdisabled.

Une fois le mode cluster désactivé, l'DescribeReplicationGroupsAPI renvoie le paramètre du mode cluster sous la formedisabled.