Como altero o modo de cluster do meu cluster OSS do ElastiCache para Valkey ou do ElastiCache para Redis?

Breve descrição

Observação: é possível alterar a configuração do modo de cluster somente do modo de cluster desativado para o modo de cluster ativado. Depois de fazer essa alteração no modo de cluster, não será possível reverter sua configuração.

Pré-requisitos:

• O cluster deve ter chaves somente no banco de dados 0.
• As aplicações devem usar um cliente Valkey ou Redis OSS que possa usar o protocolo de cluster e um endpoint de configuração.
• Para o cluster, você deve ativar o failover automático e ter pelo menos uma réplica.
• Para a migração, seu cluster deve ter uma versão do mecanismo Valkey 7.2 ou posterior, ou Redis OSS 7.0 ou posterior. Para obter mais informações, consulte Modificando o modo de cluster.

Para atualizar seu modo de cluster do modo de cluster desativado para o modo de cluster ativado, conclua as seguintes tarefas:

1. Atualize o modo do cluster de desativado Compatível.
2. Atualize o modo de cluster de Compatível para o modo de cluster ativado.

Observação: durante esse processo de migração, o cluster permanece disponível.

Resolução

Antes de passar para o modo Compatível, você deve definir o parâmetro habilitado para cluster como sim. Se você usar um grupo de parâmetros padrão, o ElastiCache for Valkey e o ElastiCache for Redis OSS escolherão o grupo de parâmetros padrão. Esse grupo de parâmetros padrão tem a configuração habilitada para cluster definida como sim, e você não precisa realizar nenhuma ação.

Observação: se você usar um grupo de parâmetros personalizado, escolha um novo grupo de parâmetros ao modificar o cluster. Ou crie um novo grupo de parâmetros para a mesma família de mecanismos com o parâmetro habilitado para cluster definido como sim.

Atualize o modo do cluster de desativado para Compatível

Observação: Se você receber erros ao executar comandos da AWS Command Line Interface (AWS CLI), consulte Solução de problemas da AWS CLI. Além disso, verifique se você está usando a versão mais recente da AWS CLI.

No modo Compatível, o ElastiCache implanta um único fragmento para trabalhar com o nó. Com essa configuração, a aplicação cliente pode usar qualquer um dos protocolos para se comunicar com o cluster.

Conclua as etapas a seguir:

1. Abra o console do ElastiCache.
2. No painel de navegação, escolha seu tipo de recurso e selecione seu cluster.
3. Escolha Modificar.
4. Em Modo de cluster, escolha Compatível.
5. (Opcional) Escolha um grupo de parâmetros personalizado com o cluster de parâmetros ativado definido como sim.
   Observação: se você usar um grupo de parâmetros padrão, nenhuma ação será necessária.
6. Escolha Visualizar alterações e, em seguida, escolha Salvar alterações.

Para usar a AWS CLI para modificar o cluster, execute o comando modify-replication-group e atualize o parâmetro cluster-mode para compatível.

Exemplo:

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

Observação: no exemplo anterior, substitua test-cluster pelo nome do seu cluster. Para obter mais informações, consulte Modificando um grupo de replicação.

Depois que o modo de cluster mudar para Compatível, é possível usar o endpoint de configuração recém-criado para testar a conectividade ativada pelo modo de cluster a partir da aplicação. Também é possível usar os endpoints primário e de leitor para atender à conectividade desativada do modo de cluster existente para o cluster.

No modo Compatível, também é possível reverter para o modo de cluster desativado e preservar as configurações originais.

Atualize o modo de cluster de Compatível para o modo de cluster ativado

Depois de migrar todos os clientes Valkey ou Redis OSS para o modo de cluster ativado, a aplicação cliente se torna sensível ao cluster. A partir desse status, é possível definir o parâmetro do modo de cluster como ativado.

Conclua as etapas a seguir:

1. Abra o console do ElastiCache.
2. No painel de navegação, escolha seu tipo de recurso e selecione seu cluster.
3. Escolha Modificar.
4. Em Modo de cluster, escolha Ativado.
5. Escolha Visualizar alterações e, em seguida, escolha Salvar alterações.

Para usar a AWS CLI para modificar o cluster, execute o comando modify-replication-group e atualize o parâmetro cluster-mode para enabled.

Exemplo:

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

Observação: no exemplo anterior, substitua test-cluster pelo nome do seu cluster.

Depois que as alterações do modo de cluster forem concluídas, os endpoints do cluster também serão alterados. Como não há mais um endpoint primário ou de leitor, certifique-se de atualizar suas aplicações com o novo endpoint de configuração.

Observação: é uma prática recomendada revisar a documentação do seu cliente para configurá-lo para oferecer suporte à interação com um cluster (ativado no modo de cluster). Para obter mais informações, consulte a especificação do cluster no site da Valkey.

Informações relacionadas

Replicação: Valkey e Redis OSS com o Modo de Cluster Desativado vs. Ativado

Práticas recomendadas: Clientes Redis e Amazon ElastiCache para Redis