Come posso modificare la modalità cluster per il mio cluster ElastiCache per Valkey o ElastiCache per Redis OSS?

Breve descrizione

Nota: puoi modificare la configurazione della modalità cluster solo da modalità cluster disabilitata a modalità cluster abilitata. Dopo aver apportato questa modifica, non puoi ripristinare la configurazione precedente della modalità cluster.

Prerequisiti:

• Il cluster deve avere chiavi solo nel database 0.
• Le applicazioni devono utilizzare un client Valkey o Redis OSS in grado di utilizzare il protocollo cluster e un endpoint di configurazione.
• Per il cluster, devi attivare il failover automatico e avere almeno 1 replica.
• Per la migrazione, il cluster deve avere una versione del motore Valkey 7.2 e successive o Redis OSS 7.0 e successive. Per ulteriori informazioni, consulta Modifica della modalità cluster.

Per aggiornare la modalità cluster da modalità cluster disabilitata a modalità cluster abilitata, completa le seguenti attività:

1. Aggiorna la modalità cluster da modalità cluster disabilitata a Compatibilità.
2. Aggiorna la modalità cluster da Compatibilità a modalità cluster abilitata.

Nota: durante questo processo di migrazione, il cluster rimane disponibile.

Risoluzione

Prima di passare alla modalità Compatibilità, devi impostare il parametro cluster-enabled su sì. Se utilizzi un gruppo di parametri predefinito, ElastiCache per Valkey ed ElastiCache per Redis OSS scelgono il gruppo di parametri predefinito. Il gruppo di parametri predefinito ha la configurazione cluster-enabled impostata su sì e non è necessario intraprendere alcuna azione.

Nota: se utilizzi un gruppo di parametri personalizzato, scegli un nuovo gruppo di parametri quando modifichi il cluster. Oppure crea un nuovo gruppo di parametri per la stessa famiglia di motori con il parametro cluster-enabled impostato su sì.

Aggiorna la modalità cluster da modalità cluster disabilitata a Compatibilità

Nota: se ricevi errori quando esegui i comandi dell'Interfaccia della linea di comando AWS (AWS CLI), consulta Risoluzione degli errori per AWS CLI. Inoltre, assicurati di utilizzare la versione più recente di AWS CLI.

In modalità Compatibilità, ElastiCache distribuisce un singolo shard per lavorare con il nodo. Con questa configurazione, l'applicazione client può utilizzare entrambi i protocolli per comunicare con il cluster.

Completa i seguenti passaggi:

1. Apri la console ElastiCache.
2. Nel pannello di navigazione, scegli il tipo di risorsa, quindi seleziona il cluster.
3. Scegli Modifica.
4. In Modalità cluster, scegli Compatibilità.
5. (Facoltativo) Scegli un gruppo di parametri personalizzato con il parametro cluster-enabled impostato su sì.
   Nota: se utilizzi un gruppo di parametri predefinito, non è necessaria alcuna azione.
6. Scegli Visualizza l'anteprima delle modifiche, quindi scegli Salva le modifiche.

Per modificare il cluster utilizzando AWS CLI, esegui il comando modify-replication-group e aggiorna il parametro cluster-mode su compatibilità.

Esempio:

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

Nota: nell'esempio precedente, sostituisci test-cluster con il nome del tuo cluster. Per ulteriori informazioni, consulta Modifica di un gruppo di replica.

Dopo che la modalità cluster è passata a Compatibilità, puoi utilizzare l'endpoint di configurazione appena creato per testare la connettività in modalità cluster abilitata dall'applicazione. Puoi anche utilizzare gli endpoint primario e di lettura per gestire la connettività in modalità cluster disabilitata esistente per il cluster.

Dalla modalità Compatibilità, puoi anche ripristinare la modalità cluster disabilitata e mantenere le configurazioni originali.

Aggiorna la modalità cluster da Compatibilità a modalità cluster abilitata

Dopo aver migrato tutti i client Valkey o Redis OSS alla modalità cluster abilitata, l'applicazione client diventa consapevole del cluster. Da questo stato, puoi impostare il parametro modalità cluster su abilitata.

Completa i seguenti passaggi:

1. Apri la console ElastiCache.
2. Nel pannello di navigazione, scegli il tipo di risorsa, quindi seleziona il cluster.
3. Scegli Modifica.
4. In Modalità cluster, scegli Abilitata.
5. Scegli Visualizza l'anteprima delle modifiche, quindi scegli Salva le modifiche.

Per modificare il cluster utilizzando AWS CLI, esegui il comando modify-replication-group e aggiorna il parametro cluster-mode su abilitata.

Esempio:

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

Nota: nell'esempio precedente, sostituisci test-cluster con il nome del tuo cluster.

Una volta completate le modifiche alla modalità cluster, cambiano anche gli endpoint del cluster. Poiché non esiste più un endpoint primario o di lettura, assicurati di aggiornare le applicazioni con il nuovo endpoint di configurazione.

Nota: è consigliabile consultare la documentazione del client per configurarlo in modo da supportare l'interazione con un cluster (con modalità cluster abilitata). Per ulteriori informazioni, consulta Cluster specification (Specifica del cluster) sul sito web di Valkey.

Informazioni correlate

Replica: modalità cluster Valkey e Redis OSS disabilitata o abilitata

Best practices: Redis clients and Amazon ElastiCache for Redis (Best practice: client Redis e Amazon ElastiCache per Redis)