Démarrage d’une migration

Une fois toutes les conditions préalables remplies, vous pouvez commencer la migration des données à l'aide de la AWS Management Console, l’API ElastiCache ou la AWS CLI. Si le mode cluster est activé et que la migration des emplacements diffère, un repartitionnement est effectué avant la migration en direct. L'exemple suivant montre comment utiliser la CLI.

Note

Nous avons recommandé d'utiliser l'API TestMigration pour valider la configuration de la migration. Mais cela est strictement facultatif.

Commencez la migration en appelant la commande start-migration avec les paramètres suivants :

• --replication-group-id – identificateur du groupe de réplication ElastiCache cible

• --customer-node-endpoint-list – Liste des points de terminaison avec les adresses DNS ou IP ainsi que le port sur lequel votre cluster Redis source s'exécute. La liste ne peut accepter qu'un seul élément à la fois pour le mode cluster désactivé et pour le mode cluster activé. Si vous avez activé la réplication en chaîne, le point de terminaison peut pointer vers un replica au lieu du nœud principal dans votre cluster Redis.

Voici un exemple avec utilisation de la CLI.

aws elasticache start-migration --replication-group-id test-cluster --customer-node-endpoint-list "Address='10.0.0.241',Port=6379"

Lorsque vous exécutez cette commande, le nœud primaire ElastiCache (dans chaque partition) se configure lui-même pour devenir un réplica de votre instance Redis (dans la partition correspondante propriétaire des mêmes emplacements dans l'instance Redis avec mode cluster activé). L'état du cluster ElastiCache passe à migrating (en cours de migration) et les données commencent à migrer de votre instance Redis vers le nœud primaire ElastiCache. En fonction de la taille des données et de la charge de votre instance Redis, la migration peut prendre un certain temps. Vous pouvez vérifier la progression de la migration en exécutant la commande redis-cli INFO sur votre instance Redis et sur le nœud primaire ElastiCache.

Après une réplication réussie, toutes les écritures effectuées sur vos instances Redis se propagent au cluster ElastiCache. Vous pouvez utiliser les nœuds ElastiCache pour la lecture. Cependant, vous ne pouvez pas écrire sur le cluster ElastiCache. Si d’autres nœuds de replica sont connectés à un nœud primaire ElastiCache, ces nœuds de replica continuent de se répliquer à partir du nœud primaire ElastiCache. Ainsi, toutes les données de votre cluster Redis sont répliquées sur tous les nœuds du cluster ElastiCache.

Si un nœud primaire ElastiCache ne peut pas devenir un réplica de votre instance Redis, il réessaye plusieurs fois avant de s’auto-promouvoir de nouveau en nœud primaire. L'état du cluster Elasticache devient alors available (disponible), et un événement de groupe de réplication concernant l'échec du lancement de la migration est envoyé. Pour résoudre un tel problème, vérifiez ce qui suit :

• Observez l'événement de groupe de réplication. Utilisez toute information spécifique de l'événement pour corriger l'échec de la migration.

• Si l'événement ne fournit pas d'informations spécifiques, assurez-vous d'avoir suivi les instructions dans Préparer les nœuds Redis source et cible pour la migration.

• Vérifiez que la configuration du routage de votre VPC et vos sous-réseaux autorise le trafic entre les nœuds ElastiCache et vos instances Redis.

• Vérifiez que le groupe de sécurité attaché à vos instances Redis autorise le trafic entrant en provenance des nœuds ElastiCache.

• Consultez les journaux Redis de vos instances Redis pour en savoir plus sur les échecs liés spécifiquement à la réplication.