

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

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

1. **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 (excluindo`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, veja [Modificação de um grupo de replicação](Replication.Modify.md) e defina o modo de cluster como **Compatível**

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

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

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

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

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

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

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