Riduzione del numero di repliche in uno shard

È possibile ridurre il numero di repliche in uno shard per Redis OSS (modalità cluster abilitata) o in un gruppo di replica per Redis OSS (modalità cluster disabilitata):

• Per Redis OSS (modalità cluster disabilitata), è possibile ridurre il numero di repliche a una se Multi-AZ è abilitato e a zero se non è abilitato.

• Per Redis OSS (modalità cluster abilitata), è possibile ridurre il numero di repliche a zero. Tuttavia, non puoi eseguire il failover in una replica se il nodo primario non riesce.

È possibile utilizzare AWS Management Console, the AWS CLI o l' ElastiCache API per ridurre il numero di repliche in un gruppo di nodi (shard) o in un gruppo di replica.

Utilizzando il AWS Management Console

La procedura seguente utilizza la console per ridurre il numero di repliche in un gruppo di replica Redis OSS (modalità cluster abilitata).

Per ridurre il numero di repliche in uno shard Redis OSS

1. Accedere AWS Management Console e aprire la ElastiCache console all'indirizzo https://console.aws.amazon.com/elasticache/.

2. Nel pannello di navigazione, scegli Redis OSS, quindi scegli il nome del gruppo di replica da cui desideri eliminare le repliche.

3. Scegliere la casella per ogni shard da cui si desidera rimuovere un nodo di replica.

4. Scegliere Delete replicas (Elimina repliche).

5. Completare la pagina Delete Replicas from Shards (Elimina repliche dagli shard):

   1. Per New number of replicas/shard (Nuovo numero di repliche/shard), immettere il numero di repliche specificato per gli shard selezionati. Questo numero deve essere maggiore o uguale a 1. Si consiglia almeno due repliche per shard.

   2. Scegliere Delete (Elimina) per eliminare le repliche o Cancel (Annulla) per annullare l'operazione.

Importante

• Se non specificate i nodi di replica da eliminare, ElastiCache (Redis OSS) seleziona automaticamente i nodi di replica da eliminare. Nel farlo, ElastiCache (Redis OSS) tenta di mantenere l'architettura Multi-AZ per il gruppo di replica, seguita da conservare le repliche con un ritardo di replica minimo con il primario.

• Non è possibile eliminare il primario o nodi primari in un gruppo di replica. Se si specifica un nodo primario per l'eliminazione, l'operazione non riesce e viene restituito un errore che indica che il nodo primario è stato selezionato per l'eliminazione.

Utilizzando il AWS CLI

Per ridurre il numero di repliche in uno shard Redis OSS, utilizzate il decrease-replica-count comando con i seguenti parametri:

• --replication-group-id : Obbligatorio Identifica il gruppo di replica in cui ridurre il numero di repliche.

• --apply-immediately o --no-apply-immediately : Obbligatorio. Specifica se ridurre il conteggio di repliche immediatamente (--apply-immediately) o alla successiva finestra di manutenzione (--no-apply-immediately). Attualmente, --no-apply-immediately non è supportato.

• --new-replica-count - Opzionale. Specifica il numero di nodi di replica desiderato. Il valore di --new-replica-count deve essere un valore valido minore del numero corrente di repliche nei gruppi di nodi. Per valori consentiti minimi, consulta Riduzione del numero di repliche in uno shard. Se il valore di --new-replica-count non soddisfa questo requisiti, la chiamata non riesce.

• --replicas-to-remove - Opzionale. Contiene un elenco di ID nodo che specificano i nodi di replica da rimuovere.

• --replica-configuration - Opzionale. Consente di impostare il numero di repliche e zone di disponibilità per ogni gruppo di nodi in maniera indipendente. Utilizzate questo parametro per i gruppi Redis OSS (modalità cluster abilitata) in cui desiderate configurare ogni gruppo di nodi in modo indipendente.

  --replica-configuration dispone di tre membri opzionali:

  • NodeGroupId - L'ID di quattro cifre del gruppo di nodi che stai configurando. Per i gruppi di replica Redis OSS (modalità cluster disabilitata), l'ID dello shard è sempre. 0001 Per trovare l'ID di un gruppo di nodi (shard) di un gruppo di nodi Redis OSS (modalità cluster abilitata), vedi. Ricerca dell'ID di uno shard

  • NewReplicaCount - Un parametro facoltativo che specifica il numero di nodi di replica desiderati. Il valore di NewReplicaCount deve essere un valore valido minore del numero corrente di repliche nei gruppi di nodi. Per valori consentiti minimi, consulta Riduzione del numero di repliche in uno shard. Se il valore di NewReplicaCount non soddisfa questo requisiti, la chiamata non riesce.

  • PreferredAvailabilityZones - Un elenco di stringhe PreferredAvailabilityZone che specifica in quali zone di disponibilità si trovano i nodi del gruppo di replica. Il numero di valori PreferredAvailabilityZone deve essere uguale al valore di NewReplicaCount più 1 per tenere conto del nodo primario. Se questo membro di --replica-configuration viene omesso, ElastiCache (Redis OSS) sceglie la zona di disponibilità per ciascuna delle nuove repliche.

Importante

Devi includere solo uno dei parametri --new-replica-count, --replicas-to-remove o --replica-configuration.

L'esempio seguente utilizza --new-replica-count per ridurre a uno il numero di repliche nel gruppo di replica sample-repl-group. Al termine dell'esempio, ogni gruppo di nodi contiene una sola replica. Questo numero si applica sia che si tratti di un gruppo Redis OSS (modalità cluster disabilitata) con un gruppo di nodi singolo o di un gruppo Redis OSS (modalità cluster abilitata) con più gruppi di nodi.

Per Linux, macOS o Unix:

aws elasticache decrease-replica-count
    --replication-group-id sample-repl-group \
    --new-replica-count 1 \
    --apply-immediately

Per Windows:

aws elasticache decrease-replica-count ^
    --replication-group-id sample-repl-group ^
    --new-replica-count 1 ^
    --apply-immediately

Nell'esempio seguente il numero di repliche nel gruppo di replica sample-repl-group viene ridotto rimuovendo due repliche specificate (0001 e 0003) dal gruppo di nodi.

Per Linux, macOS o Unix:

aws elasticache decrease-replica-count \
    --replication-group-id sample-repl-group \
    --replicas-to-remove 0001,0003 \
    --apply-immediately

Per Windows:

aws elasticache decrease-replica-count ^
    --replication-group-id sample-repl-group ^
    --replicas-to-remove 0001,0003 \
    --apply-immediately

L'esempio seguente utilizza --replica-configuration per ridurre il numero di repliche nel gruppo di replica sample-repl-group al valore specificato per i due gruppi di nodi specificati. Dato che esistono più gruppi di nodi, si tratta di un gruppo di replica Redis OSS (modalità cluster abilitata). Durante la specifica del PreferredAvailabilityZones opzionale, il numero di zone di disponibilità elencate deve essere uguale al valore di NewReplicaCount più uno. Questo approccio consente di tenere conto del nodo primario per il gruppo identificato da NodeGroupId.

Per Linux, macOS o Unix:

aws elasticache decrease-replica-count \
    --replication-group-id sample-repl-group \
    --replica-configuration \
        NodeGroupId=0001,NewReplicaCount=1,PreferredAvailabilityZones=us-east-1a,us-east-1c \
        NodeGroupId=0003,NewReplicaCount=2,PreferredAvailabilityZones=us-east-1a,us-east-1b,us-east-1c \
    --apply-immediately

Per Windows:

aws elasticache decrease-replica-count ^
    --replication-group-id sample-repl-group ^
    --replica-configuration ^
        NodeGroupId=0001,NewReplicaCount=2,PreferredAvailabilityZones=us-east-1a,us-east-1c ^
        NodeGroupId=0003,NewReplicaCount=3,PreferredAvailabilityZones=us-east-1a,us-east-1b,us-east-1c \
    --apply-immediately

Per ulteriori informazioni sulla riduzione del numero di repliche utilizzando la CLI, consulta Amazon ElastiCache Command Line decrease-replica-countReference.

Utilizzo dell'API ElastiCache

Per ridurre il numero di repliche in uno shard Redis OSS, utilizza l'DecreaseReplicaCountazione con i seguenti parametri:

• ReplicationGroupId : Obbligatorio Identifica il gruppo di replica in cui ridurre il numero di repliche.

• ApplyImmediately - Obbligatorio Specifica se ridurre il conteggio di repliche immediatamente (ApplyImmediately=True) o alla successiva finestra di manutenzione (ApplyImmediately=False). Attualmente, ApplyImmediately=False non è supportato.

• NewReplicaCount - Opzionale. Specifica il numero di nodi di replica desiderato. Il valore di NewReplicaCount deve essere un valore valido minore del numero corrente di repliche nei gruppi di nodi. Per valori consentiti minimi, consulta Riduzione del numero di repliche in uno shard. Se il valore di --new-replica-count non soddisfa questo requisiti, la chiamata non riesce.

• ReplicasToRemove - Opzionale. Contiene un elenco di ID nodo che specificano i nodi di replica da rimuovere.

• ReplicaConfiguration - Opzionale. Contiene un elenco di gruppi di nodi che consentono di impostare il numero di repliche e zone di disponibilità per ogni gruppo di nodi in maniera indipendente. Utilizzate questo parametro per i gruppi Redis OSS (modalità cluster abilitata) in cui desiderate configurare ogni gruppo di nodi in modo indipendente.

  ReplicaConfiguraion dispone di tre membri opzionali:

  • NodeGroupId - L'ID di quattro cifre del gruppo di nodi che si sta configurando. Per i gruppi di replica Redis OSS (modalità cluster disabilitata), l'ID del gruppo di nodi è sempre. 0001 Per trovare l'ID di un gruppo di nodi (shard) di un gruppo di nodi Redis OSS (modalità cluster abilitata), vedi. Ricerca dell'ID di uno shard

  • NewReplicaCount - Il numero di repliche desiderato in questo gruppo di nodi al termine di questa operazione. Il valore deve essere inferiore al numero di repliche correnti fino a un minimo di 1 se la funzione Multi-AZ è abilitata o 0 se non è abilitata failover automatico. Se questo valore non è minore del numero corrente di repliche nel gruppo di nodi, la chiamata non riesce con un'eccezione.

  • PreferredAvailabilityZones - Un elenco di stringhe PreferredAvailabilityZone che specifica in quali zone di disponibilità si trovano i nodi del gruppo di replica. Il numero di valori PreferredAvailabilityZone deve essere uguale al valore di NewReplicaCount più 1 per tenere conto del nodo primario. Se questo membro di ReplicaConfiguration viene omesso, ElastiCache (Redis OSS) sceglie la zona di disponibilità per ciascuna delle nuove repliche.

Importante

Devi includere solo uno dei parametri NewReplicaCount, ReplicasToRemove o ReplicaConfiguration.

L'esempio seguente utilizza NewReplicaCount per ridurre a uno il numero di repliche nel gruppo di replica sample-repl-group. Al termine dell'esempio, ogni gruppo di nodi contiene una sola replica. Questo numero si applica sia che si tratti di un gruppo Redis OSS (modalità cluster disabilitata) con un gruppo di nodi singolo o di un gruppo Redis OSS (modalità cluster abilitata) con più gruppi di nodi.

https://elasticache.us-west-2.amazonaws.com/
      ?Action=DecreaseReplicaCount
      &ApplyImmediately=True
      &NewReplicaCount=1
      &ReplicationGroupId=sample-repl-group
      &Version=2015-02-02
      &SignatureVersion=4
      &SignatureMethod=HmacSHA256
      &Timestamp=20150202T192317Z
      &X-Amz-Credential=<credential>

Nell'esempio seguente il numero di repliche nel gruppo di replica sample-repl-group viene ridotto rimuovendo due repliche specificate (0001 e 0003) dal gruppo di nodi.

https://elasticache.us-west-2.amazonaws.com/
      ?Action=DecreaseReplicaCount
      &ApplyImmediately=True
      &ReplicasToRemove.ReplicaToRemove.1=0001
      &ReplicasToRemove.ReplicaToRemove.2=0003
      &ReplicationGroupId=sample-repl-group
      &Version=2015-02-02
      &SignatureVersion=4
      &SignatureMethod=HmacSHA256
      &Timestamp=20150202T192317Z
      &X-Amz-Credential=<credential>

L'esempio seguente utilizza ReplicaConfiguration per ridurre il numero di repliche nel gruppo di replica sample-repl-group al valore specificato per i due gruppi di nodi specificati. Dato che esistono più gruppi di nodi, si tratta di un gruppo di replica Redis OSS (modalità cluster abilitata). Durante la specifica del PreferredAvailabilityZones opzionale, il numero di zone di disponibilità elencate deve essere uguale al valore di NewReplicaCount più uno. Questo approccio consente di tenere conto del nodo primario per il gruppo identificato da NodeGroupId.

https://elasticache.us-west-2.amazonaws.com/
      ?Action=DecreaseReplicaCount
      &ApplyImmediately=True
      &ReplicaConfiguration.ConfigureShard.1.NodeGroupId=0001
      &ReplicaConfiguration.ConfigureShard.1.NewReplicaCount=1
      &ReplicaConfiguration.ConfigureShard.1.PreferredAvailabilityZones.PreferredAvailabilityZone.1=us-east-1a
      &ReplicaConfiguration.ConfigureShard.1.PreferredAvailabilityZones.PreferredAvailabilityZone.2=us-east-1c
      &ReplicaConfiguration.ConfigureShard.2.NodeGroupId=0003
      &ReplicaConfiguration.ConfigureShard.2.NewReplicaCount=2
      &ReplicaConfiguration.ConfigureShard.2.PreferredAvailabilityZones.PreferredAvailabilityZone.1=us-east-1a
      &ReplicaConfiguration.ConfigureShard.2.PreferredAvailabilityZones.PreferredAvailabilityZone.2=us-east-1b
      &ReplicaConfiguration.ConfigureShard.2.PreferredAvailabilityZones.PreferredAvailabilityZone.4=us-east-1c
      &ReplicationGroupId=sample-repl-group
      &Version=2015-02-02
      &SignatureVersion=4
      &SignatureMethod=HmacSHA256
      &Timestamp=20150202T192317Z
      &X-Amz-Credential=<credential>

Per ulteriori informazioni sulla riduzione del numero di repliche utilizzando l'API, consulta DecreaseReplicaCountAmazon ElastiCache API Reference.