

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
<a name="modify-cluster-mode"></a>

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](ParameterGroups.md)

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](Clusters.Create.md).

1. **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](https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_ModifyReplicationGroup.html). 

   1. Usando o Console de gerenciamento da AWS, consulte [Modificação de um grupo de replicação](Replication.Modify.md) e defina o modo de cluster como **Compatível**

   1. Usando a API, consulte [ModifyReplicationGroup](https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_ModifyReplicationGroup.html) e atualize o parâmetro `ClusterMode` para `compatible`.

   1. Usando a AWS CLI, consulte [ModifyReplicationGroup](https://docs.aws.amazon.com/cli/latest/reference/elasticache/modify-replication-group.html) 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](https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_DescribeReplicationGroups.html) 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](Endpoints.md).

1. **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](Replication.Modify.md) e defina o modo de cluster como **Habilitado**.

   1. Usando a API, consulte [ModifyReplicationGroup](https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_ModifyReplicationGroup.html) e atualize o parâmetro `ClusterMode` para `enabled`.

   1. Usando a AWS CLI, consulte [ModifyReplicationGroup](https://docs.aws.amazon.com/cli/latest/reference/elasticache/modify-replication-group.html) 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](https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_DescribeReplicationGroups.html) 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](Replication.Modify.md) e defina o modo de cluster como **Desabilitado**.

1. Usando a API, consulte [ModifyReplicationGroup](https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_ModifyReplicationGroup.html) e atualize o parâmetro `ClusterMode` para `disabled`. 

1. Usando a AWS CLI, consulte [ModifyReplicationGroup](https://docs.aws.amazon.com/cli/latest/reference/elasticache/modify-replication-group.html) e atualize o parâmetro `cluster-mode` para `disabled`.

Depois de alterar o modo de cluster para desativado, a API [DescribeReplicationGroups](https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_DescribeReplicationGroups.html) retornará o parâmetro do modo de cluster como `disabled`.