Incremento del numero di repliche in uno shard

È possibile aumentare il numero di repliche in uno shard Redis OSS (modalità cluster abilitata) o in un gruppo di replica Redis OSS (modalità cluster disabilitata) fino a un massimo di cinque. È possibile farlo utilizzando, the o l' AWS Management Console AWS CLI API. ElastiCache

Usando il AWS Management Console

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

Per aumentare il numero di repliche negli shard Redis OSS

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

2. Nel riquadro di navigazione, scegli Redis OSS, quindi scegli il nome del gruppo di replica a cui desideri aggiungere le repliche.

3. Scegliere la casella per ogni shard cui si desidera aggiungere repliche.

4. Scegliere Add replicas (Aggiungi repliche).

5. Completare la pagina Add Replicas to Shards (Aggiungi repliche agli shard):

   • Per New number of replicas/shard (Nuovo numero di repliche/shard), immettere il numero di repliche che devono avere tutti gli shard selezionati. Questo valore deve essere maggiore o uguale di Current Number of Replicas per shard (Numero attuale di repliche per shard) e minore o uguale a cinque. Si consiglia come minimo due repliche.

   • Per Zone di disponibilità, scegli Nessuna preferenza per aver ElastiCache scelto una zona di disponibilità per ogni nuova replica oppure Specificare zone di disponibilità per scegliere una zona di disponibilità per ogni nuova replica.

     Se si sceglie Specify Availability Zones (Specifica zone di disponibilità), per ogni nuova replica specificare una zona di disponibilità utilizzando l'elenco.

6. Scegliere Add (Aggiungi) per aggiungere le repliche o Cancel (Annulla) per annullare l'operazione.

Utilizzando il AWS CLI

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

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

• --apply-immediately o --no-apply-immediately - Obbligatorio. Specifica se aumentare 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 desiderati, fino a un massimo di cinque. Utilizzate questo parametro per i gruppi di replica Redis OSS (modalità cluster disabilitata) in cui è presente un solo gruppo di nodi o un gruppo Redis OSS (modalità cluster abilitata) o dove desiderate che tutti i gruppi di nodi abbiano lo stesso numero di repliche. Se questo valore non è maggiore del numero corrente di repliche nel gruppo di nodi, la chiamata non riesce con un'eccezione.

• --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 - Il numero di repliche desiderato in questo gruppo di nodi al termine di questa operazione. Il valore deve essere maggiore del numero corrente di repliche, fino a un massimo di cinque. Se questo valore non è maggiore 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 devono trovare 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

Nella chiamata è necessario includere il parametro --new-replica-count o --replica-configuration, ma non entrambi.

Nell'esempio seguente il numero di repliche nel gruppo di replica sample-repl-group viene incrementato a tre. Al termine dell'esempio, ogni gruppo di nodi contiene tre repliche. 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 increase-replica-count \
    --replication-group-id sample-repl-group \
    --new-replica-count 3 \
    --apply-immediately

Per Windows:

aws elasticache increase-replica-count ^
    --replication-group-id sample-repl-group ^
    --new-replica-count 3 ^
    --apply-immediately

Nell'esempio seguente il numero di repliche nel gruppo di replica sample-repl-group viene incrementato 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 increase-replica-count \
    --replication-group-id sample-repl-group \
    --replica-configuration \
        NodeGroupId=0001,NewReplicaCount=2,PreferredAvailabilityZones=us-east-1a,us-east-1c,us-east-1b \
        NodeGroupId=0003,NewReplicaCount=3,PreferredAvailabilityZones=us-east-1a,us-east-1b,us-east-1c,us-east-1c \
    --apply-immediately

Per Windows:

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

Per ulteriori informazioni sull'aumento del numero di repliche utilizzando la CLI, increase-replica-countconsulta ElastiCache Amazon Command Line Reference.

Utilizzo dell'API ElastiCache

Per aumentare il numero di repliche in uno shard Redis OSS, utilizzate l'IncreaseReplicaCountazione con i seguenti parametri:

• ReplicationGroupId - Obbligatorio Identifica il gruppo di replica in cui incrementare il numero di repliche.

• ApplyImmediately – Obbligatorio Specifica se aumentare 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 desiderati, fino a un massimo di cinque. Utilizzate questo parametro per i gruppi di replica Redis OSS (modalità cluster disabilitata) in cui è presente un solo gruppo di nodi o per i gruppi Redis OSS (modalità cluster abilitata) in cui desiderate che tutti i gruppi di nodi abbiano lo stesso numero di repliche. Se questo valore non è maggiore del numero corrente di repliche nel gruppo di nodi, la chiamata non riesce con un'eccezione.

• ReplicaConfiguration - 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.

  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 (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 - Il numero di repliche desiderato in questo gruppo di nodi al termine di questa operazione. Il valore deve essere maggiore del numero corrente di repliche e non superiore a cinque. Se questo valore non è maggiore 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 devono trovare 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

Nella chiamata è necessario includere il parametro NewReplicaCount o ReplicaConfiguration, ma non entrambi.

Nell'esempio seguente il numero di repliche nel gruppo di replica sample-repl-group viene incrementato a tre. Al termine dell'esempio, ogni gruppo di nodi contiene tre repliche. 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=IncreaseReplicaCount
      &ApplyImmediately=True
      &NewReplicaCount=3
      &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 incrementato 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=IncreaseReplicaCount
      &ApplyImmediately=True
      &ReplicaConfiguration.ConfigureShard.1.NodeGroupId=0001
      &ReplicaConfiguration.ConfigureShard.1.NewReplicaCount=2
      &ReplicaConfiguration.ConfigureShard.1.PreferredAvailabilityZones.PreferredAvailabilityZone.1=us-east-1a
      &ReplicaConfiguration.ConfigureShard.1.PreferredAvailabilityZones.PreferredAvailabilityZone.2=us-east-1c
      &ReplicaConfiguration.ConfigureShard.1.PreferredAvailabilityZones.PreferredAvailabilityZone.3=us-east-1b
      &ReplicaConfiguration.ConfigureShard.2.NodeGroupId=0003
      &ReplicaConfiguration.ConfigureShard.2.NewReplicaCount=3
      &ReplicaConfiguration.ConfigureShard.2.PreferredAvailabilityZones.PreferredAvailabilityZone.1=us-east-1a
      &ReplicaConfiguration.ConfigureShard.2.PreferredAvailabilityZones.PreferredAvailabilityZone.2=us-east-1b
      &ReplicaConfiguration.ConfigureShard.2.PreferredAvailabilityZones.PreferredAvailabilityZone.3=us-east-1c
      &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 sull'aumento del numero di repliche utilizzando l'API, consulta IncreaseReplicaCountAmazon ElastiCache API Reference.