Início da migração - Amazon ElastiCache

Início da migração

Depois que todos os pré-requisitos forem preenchidos, será possível iniciar a migração de dados usando o Console de gerenciamento da AWS, a API do ElastiCache ou a AWS CLI. No modo de cluster habilitado, se a migração de slots for diferente, uma refragmentação será realizada antes da migração ao vivo. O exemplo a seguir mostra como usar a CLI.

nota

Recomendamos usar a API TestMigration para validar a configuração da migração. Mas isso é estritamente opcional.

Inicie a migração chamando o comando start-migration com os seguintes parâmetros:

  • --replication-group-id: identificador do grupo de replicação de destino do ElastiCache.

  • --customer-node-endpoint-list: uma lista de endpoints com endereços IP ou DNS e a porta em que o cluster de origem do Valkey ou Redis OSS está sendo executado. A lista só pode ter um elemento para o modo de cluster desabilitado e o modo de cluster habilitado. Se você habilitou a replicação encadeada, o endpoint pode apontar para uma réplica em vez de um nó primário no cluster do Valkey ou Redis OSS.

Veja a seguir um exemplo de como usar a CLI.

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

Ao executar esse comando, o nó primário do ElastiCache (em cada fragmento) se configura para se tornar uma réplica da instância do Valkey ou Redis OSS (no fragmento correspondente que tem os mesmos slots no redis habilitado para cluster). O status do cluster do ElastiCache é alterado para migrando e os dados começam a ser migrados da instância do Valkey ou Redis OSS para o nó primário do ElastiCache. Dependendo do tamanho dos dados e da carga na instância do Valkey ou Redis OSS, a migração pode levar um tempo até ser concluída. É possível conferir o andamento da migração executando o comando valkey-cli INFO na instância do Valkey e no nó primário do ElastiCache.

Após a replicação bem-sucedida, todas as gravações nas instâncias do Valkey ou Redis OSS são propagadas para o cluster do ElastiCache. É possível usar os nós do ElastiCache para leituras. No entanto, não é possível gravar no cluster do ElastiCache. Se um nó primário do ElastiCache tiver outros nós de replica conectados a ele, esse nó de réplica continuará a replicar do nó primário do ElastiCache. Dessa maneira, todos os dados do cluster do Valkey ou Redis OSS serão replicados para todos os nós no cluster do ElastiCache.

Se um nó primário do ElastiCache não puder se tornar uma réplica da instância do Valkey ou Redis OSS, ele fará várias novas tentativas antes de finalmente se promover novamente a primário. O status do cluster do ElastiCache é, então, alterado para available (disponível) e é enviado um evento do grupo de replicação sobre a falha ao iniciar a migração. Para solucionar problemas como uma falha, verifique o seguinte:

  • Observe o evento do grupo de replicação. Use qualquer informação específica do evento para corrigir a falha na migração.

  • Se o evento não fornecer informações específicas, verifique se as diretrizes em foram seguidas Preparação da origem e destino para migração.

  • Assegure que a configuração de roteamento para a VPC e as sub-redes permitam tráfego entre os nós do ElastiCache e as instâncias do Valkey ou Redis OSS.

  • Garanta que o grupo de segurança anexado às instâncias do Valkey ou Redis OSS permita tráfego de entrada de nós do ElastiCache.

  • Verifique os logs do Valkey ou do Redis OSS para suas instâncias para obter mais informações sobre falhas específicas de replicação.