View a markdown version of this page

Modificar o modo de cluster - Amazon ElastiCache

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Modificar o modo de cluster

O Valkey e o Redis OSS são bancos de dados em memória distribuídos que oferecem suporte à fragmentação e à replicação. ElastiCache Os clusters Valkey e Redis OSS são a implementação distribuída que permite que os dados sejam particionados em vários nós. Um cluster OSS ElastiCache para Redis tem dois modos de operação, modo de cluster ativado (CME) e modo de cluster desativado (CMD). No CME, um mecanismo Valkey e Redis OSS funciona como um banco de dados distribuído com vários fragmentos e nós, enquanto no CMD, o Valkey e o Redis OSS funcionam como um único nó.

Antes de migrar do CMD para o CME, as seguintes condições devem ser atendidas:

Importante

A configuração do modo de cluster só pode ser alterada do modo de cluster desativado para o modo cluster ativado. Não é possível reverter essa configuração.

  • O cluster só pode ter chaves no banco de dados 0.

  • As aplicações devem usar um cliente Valkey ou Redis OSS que seja capaz de usar o protocolo Cluster e um endpoint de configuração.

  • Auto-failover deve ser habilitado no cluster com no mínimo 1 réplica.

  • A versão mínima do mecanismo necessária para a migração é o Valkey 7.2 e posteriores ou o Redis OSS 7.0 e posteriores.

Para migrar do CMD para o CME, a configuração do modo de cluster deve ser alterada do modo de cluster desativado para o modo cluster ativado. Esse é um procedimento de duas etapas que garante a disponibilidade do cluster durante o processo de migração.

nota

Você precisa fornecer um grupo de parâmetros com configuração habilitada para cluster, ou seja, o parâmetro habilitado para cluster deve estar definido como yes. Se você estiver usando um grupo de parâmetros padrão, ElastiCache para Redis, o OSS escolherá automaticamente o grupo de parâmetros padrão correspondente com uma configuração habilitada para cluster. O valor do parâmetro habilitado para cluster é definido como no para um cluster CMD. Conforme o cluster passa para o modo compatível, o valor do parâmetro habilitado para cluster é atualizado para yes como parte da ação de modificação.

Para obter mais informações, consulte Configurando os parâmetros do motor usando grupos de ElastiCache parâmetros.

  1. Prepare-se — Crie um cluster CME de teste e certifique-se de que sua pilha esteja pronta para trabalhar com ele. ElastiCache para Redis, o OSS não tem como verificar se você está pronto. Para obter mais informações, consulte Criação de um cluster do Valkey ou Redis OSS.

  2. Modifique a configuração de cluster CMD existente para ser compatível com o modo de cluster — Nesse modo, haverá um único fragmento implantado e, ElastiCache para o Redis, o OSS funcionará como um único nó, mas também como um único cluster de fragmento. O modo compatível significa que o aplicativo cliente pode usar qualquer um dos protocolos para se comunicar com o cluster. Nesse modo, as aplicações devem ser reconfigurados para começar a usar o protocolo de cluster do Valkey ou do Redis OSS e o endpoint de configuração. Para alterar o modo cluster do Valkey ou do Redis OSS para o modo cluster compatível, siga as etapas abaixo:

    nota

    No modo compatível, outras operações de modificação, como ajuste de escala e versionamento do mecanismo, não são permitidas para o cluster. Além disso, os parâmetros (excluindocacheParameterGroupName) não podem ser modificados ao definir o parâmetro do modo de cluster na solicitação. ModifyReplicationGroup

    1. Usando o Console de gerenciamento da AWS, veja Modificação de um grupo de replicação e defina o modo de cluster como Compatível

    2. Usando a API, veja ModifyReplicationGroupe atualize o ClusterMode parâmetro paracompatible.

    3. Usando o AWS CLI, consulte modify-replication-group e atualize o parâmetro para. cluster-mode compatible

    Depois de alterar o modo de cluster Valkey ou Redis OSS para compatível com o modo de cluster, a DescribeReplicationGroupsAPI retornará o endpoint de configuração de cluster do ElastiCache Redis OSS. O endpoint de configuração do cluster é um endpoint único que pode ser usado pelos aplicativos para se conectar ao cluster. Para obter mais informações, consulte Encontrando pontos de extremidade de conexão em ElastiCache.

  3. Modificar a configuração do cluster para o modo cluster ativado: depois que o modo de cluster for definido como compatível com o modo de cluster, a segunda etapa é modificar a configuração do cluster para o modo cluster ativado. Nesse modo, um único fragmento está em execução, e os clientes agora podem ajustar a escala dos seus clusters ou modificar outras configurações de cluster.

    Para alterar o modo de cluster para ativado, siga estas etapas:

    Antes de começar, certifique-se de que seus clientes Valkey ou Redis OSS tenham migrado para o protocolo de cluster e que o endpoint de configuração do cluster não esteja em uso.

    1. Usando o Console de gerenciamento da AWS, consulte Modificação de um grupo de replicação e defina o modo de cluster como Ativado.

    2. Usando a API, veja ModifyReplicationGroupe atualize o ClusterMode parâmetro paraenabled.

    3. Usando o AWS CLI, consulte modify-replication-group e atualize o parâmetro para. cluster-mode enabled

    Depois de alterar o modo cluster para habilitado, os endpoints serão configurados de acordo com a especificação do cluster do Valkey ou Redis OSS. A DescribeReplicationGroupsAPI retornará o parâmetro do modo de cluster enabled e os endpoints do cluster que agora estão disponíveis para serem usados pelos aplicativos para se conectar ao cluster.

    Observe que os endpoints do cluster mudarão quando o modo de cluster for alterado para ativado. Certifique-se de atualizar seus aplicativos com os novos endpoints.

Você também pode optar por voltar ao modo de cluster desativado (CMD) usando o modo de cluster compatível e preservar as configurações originais.

Modificar a configuração do cluster para o modo de cluster desativado usando o modo de cluster compatível

  1. Usando o Console de gerenciamento da AWS, consulte Modificação de um grupo de replicação e defina o modo de cluster como Desativado

  2. Usando a API, veja ModifyReplicationGroupe atualize o ClusterMode parâmetro paradisabled.

  3. Usando o AWS CLI, consulte modify-replication-group e atualize o parâmetro para. cluster-mode disabled

Depois de alterar o modo de cluster para desativado, a DescribeReplicationGroupsAPI retornará o parâmetro do modo de cluster comodisabled.