Modificar o modo de cluster - Amazon ElastiCache

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. Os clusters do ElastiCache 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 do ElastiCache para Redis OSS tem dois modos de operação: o modo de cluster ativado (CME) e o 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.

  • O failover automático deve ser ativado no cluster com no mínimo uma 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, o ElastiCache para Redis 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 . Configuração de parâmetros do mecanismo usando grupos de parâmetros do ElastiCache

  1. Preparar-se: crie um cluster CME de teste e certifique-se de que sua pilha esteja pronta para trabalhar com ele. O ElastiCache para Redis OSS não tem como verificar sua prontidão. Para obter mais informações, consulte Criação de um cluster do Valkey ou Redis OSS.

  2. Modificar a configuração existente do cluster CMD para compatível com o modo cluster: nesse modo, haverá um único fragmento implantado e o ElastiCache para Redis 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 (exceto cacheParameterGroupName) 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, consulte Modificação de um grupo de replicação e defina o modo de cluster como Compatível

    2. Usando a API, consulte ModifyReplicationGroup e atualize o parâmetro ClusterMode para compatible.

    3. Usando a AWS CLI, consulte ModifyReplicationGroup e atualize o parâmetro cluster-mode para compatible.

    Depois de alterar o modo cluster do Valkey ou Redis OSS para o modo cluster compatível, a API DescribeReplicationGroups retornará o endpoint de configuração do cluster ElastiCache para 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 Encontrar endpoints de conexão no 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 Habilitado.

    2. Usando a API, consulte ModifyReplicationGroup e atualize o parâmetro ClusterMode para enabled.

    3. Usando a AWS CLI, consulte ModifyReplicationGroup e atualize o parâmetro cluster-mode para 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 API DescribeReplicationGroups retornará o parâmetro do modo de cluster como 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 Desabilitado.

  2. Usando a API, consulte ModifyReplicationGroup e atualize o parâmetro ClusterMode para disabled.

  3. Usando a AWS CLI, consulte ModifyReplicationGroup e atualize o parâmetro cluster-mode para disabled.

Depois de alterar o modo de cluster para desativado, a API DescribeReplicationGroups retornará o parâmetro do modo de cluster como disabled.