En utilisant le AWS Management Console En utilisant le AWS CLI Utilisation de l' ElastiCache API

Augmentation du nombre de réplicas dans une partition

Vous pouvez augmenter le nombre de répliques dans une partition Redis OSS (mode cluster activé) ou un groupe de réplication Redis OSS (mode cluster désactivé) jusqu'à un maximum de cinq. Vous pouvez le faire à l'aide de AWS Management Console, de AWS CLI, ou de l' ElastiCache API.

En utilisant le AWS Management Console

La procédure suivante utilise la console pour augmenter le nombre de répliques dans un groupe de réplication Redis OSS (mode cluster activé).

Pour augmenter le nombre de répliques dans les partitions Redis OSS

Connectez-vous à la ElastiCache console AWS Management Console et ouvrez-la à l'adresse https://console.aws.amazon.com/elasticache/.
Dans le volet de navigation, choisissez Redis OSS, puis le nom du groupe de réplication auquel vous souhaitez ajouter des répliques.
Cochez la case correspondant à chaque partition à laquelle vous souhaitez ajouter des réplicas.
Choisissez Add replicas (Ajouter des réplicas).
Renseignez la page Add Replicas to Shards (Ajouter des réplicas à des partitions) :
- Dans New number of replicas/shard (Nouveau nombre de réplicas par partition), saisissez le nombre de réplicas que doivent avoir chacune des partitions sélectionnées. Cette valeur doit être supérieure ou égale à la valeur de Current Number of Replicas per shard (Nombre actuel de réplicas par partition), et inférieure ou égale à cinq. Nous vous recommandons d'utiliser au moins deux réplicas.
- Pour les zones de disponibilité, sélectionnez Aucune préférence pour avoir ElastiCache choisi une zone de disponibilité pour chaque nouvelle réplique, ou Spécifier les zones de disponibilité pour choisir une zone de disponibilité pour chaque nouvelle réplique.
  
  Si vous choisissez Specify Availability Zones (Spécifier les zones de disponibilité), spécifiez une zone de disponibilité à l'aide de la liste pour chaque nouveau réplica.
Choisissez Add (Ajouter) pour ajouter les réplicas ou Cancel (Annuler) pour annuler l'opération.

En utilisant le AWS CLI

Pour augmenter le nombre de répliques dans une partition Redis OSS, utilisez la increase-replica-count commande avec les paramètres suivants :

--replication-group-id – Obligatoire. Identifie le groupe de réplication dans lequel vous souhaitez augmenter le nombre de réplicas.
--apply-immediately ou --no-apply-immediately – Obligatoire. Spécifie si le nombre de réplicas doit être augmenté immédiatement (--apply-immediately) ou lors du prochain créneau de maintenance (--no-apply-immediately). Actuellement, --no-apply-immediately n'est pas pris en charge.
--new-replica-count – Facultatif. Spécifie le nombre de nœuds de réplica que vous souhaitez avoir une fois l'opération terminée, dans la limite de 5 maximum. Utilisez ce paramètre pour les groupes de réplication Redis OSS (mode cluster désactivé) où il n'existe qu'un seul groupe de nœuds ou un seul groupe Redis OSS (mode cluster activé), ou pour lesquels vous souhaitez que tous les groupes de nœuds aient le même nombre de répliques. Si cette valeur n'est pas supérieure au nombre de réplicas actuel du groupe de nœuds, l'appel échoue avec une exception.
--replica-configuration – Facultatif. Vous permet de définir le nombre de réplicas et de zones de disponibilité pour chaque groupe de nœuds indépendamment. Utilisez ce paramètre pour les groupes Redis OSS (mode cluster activé) dans lesquels vous souhaitez configurer chaque groupe de nœuds indépendamment.

--replica-configuration comporte trois chiffre facultatifs :
- NodeGroupId : ID de quatre chiffres pour le groupe de nœud que vous configurez. Pour les groupes de réplication Redis OSS (mode cluster désactivé), l'ID de partition est toujours. 0001 Pour trouver l'ID d'un groupe de nœuds (partition) Redis OSS (mode cluster activé), consultez. Recherche de l'ID d'une partition
- NewReplicaCount – Nombre de réplicas que vous souhaitez dans ce groupe de nœuds à la fin de cette opération. La valeur doit être supérieure au nombre actuel de réplicas, dans la limite de cinq maximum. Si cette valeur n'est pas supérieure au nombre de réplicas actuel du groupe de nœuds, l'appel échoue avec une exception.
- PreferredAvailabilityZones – Liste de chaînes PreferredAvailabilityZone qui spécifie dans quelles zones de disponibilité les nœuds des groupes de réplication doivent se trouver. Le nombre de valeurs PreferredAvailabilityZone doit être égal à la valeur de NewReplicaCount plus 1 afin de prendre en compte le nœud principal. Si ce membre de --replica-configuration est omis, ElastiCache (Redis OSS) choisit la zone de disponibilité pour chacune des nouvelles répliques.

Important

Vous devez inclure le paramètre --new-replica-count ou le paramètre --replica-configuration, mais pas les deux, dans votre appel.

L'exemple suivant fait passer à 3 le nombre de réplicas du groupe de réplication sample-repl-group. À la fin de cet exemple, il y a trois réplicas dans chaque groupe de nœuds. Ce numéro s'applique qu'il s'agisse d'un groupe Redis OSS (mode cluster désactivé) avec un seul groupe de nœuds ou d'un groupe Redis OSS (mode cluster activé) avec plusieurs groupes de nœuds.

Pour Linux, macOS ou Unix :


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

Pour Windows :


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

L'exemple suivant fait passer le nombre de réplicas du groupe de réplication sample-repl-group à la valeur spécifiée pour les deux groupes de nœuds spécifiés. Étant donné qu'il existe plusieurs groupes de nœuds, il s'agit d'un groupe de réplication Redis OSS (mode cluster activé). Lorsque vous spécifiez le paramètre PreferredAvailabilityZones facultatif, le nombre de zones de disponibilité indiqué doit correspondre à la valeur de NewReplicaCount plus 1. Cette approche prend en compte le nœud principal pour le groupe identifié par NodeGroupId.

Pour Linux, macOS ou 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

Pour 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

Pour plus d'informations sur l'augmentation du nombre de répliques à l'aide de la CLI, consultez le increase-replica-countmanuel Amazon ElastiCache Command Line Reference.

Utilisation de l' ElastiCache API

Pour augmenter le nombre de répliques dans une partition Redis OSS, utilisez l'IncreaseReplicaCountaction avec les paramètres suivants :

ReplicationGroupId – Obligatoire. Identifie le groupe de réplication dans lequel vous souhaitez augmenter le nombre de réplicas.
ApplyImmediately – Obligatoire. Spécifie si le nombre de réplicas doit être augmenté immédiatement (ApplyImmediately=True) ou lors du prochain créneau de maintenance (ApplyImmediately=False). Actuellement, ApplyImmediately=False n'est pas pris en charge.
NewReplicaCount – Facultatif. Spécifie le nombre de nœuds de réplica que vous souhaitez avoir une fois l'opération terminée, dans la limite de 5 maximum. Utilisez ce paramètre pour les groupes de réplication Redis OSS (mode cluster désactivé) où il n'existe qu'un seul groupe de nœuds, ou pour les groupes Redis OSS (mode cluster activé) où vous souhaitez que tous les groupes de nœuds aient le même nombre de répliques. Si cette valeur n'est pas supérieure au nombre de réplicas actuel du groupe de nœuds, l'appel échoue avec une exception.
ReplicaConfiguration – Facultatif. Vous permet de définir le nombre de réplicas et de zones de disponibilité pour chaque groupe de nœuds indépendamment. Utilisez ce paramètre pour les groupes Redis OSS (mode cluster activé) dans lesquels vous souhaitez configurer chaque groupe de nœuds indépendamment.

ReplicaConfiguraion comporte trois chiffre facultatifs :
- NodeGroupId : ID de quatre chiffres pour le groupe de nœud que vous configurez. Pour les groupes de réplication Redis OSS (mode cluster désactivé), l'ID du groupe de nœuds (partition) est toujours. 0001 Pour trouver l'ID d'un groupe de nœuds (partition) Redis OSS (mode cluster activé), consultez. Recherche de l'ID d'une partition
- NewReplicaCount – Nombre de réplicas que vous souhaitez dans ce groupe de nœuds à la fin de cette opération. La valeur doit être supérieure au nombre actuel de réplicas, dans la limite de cinq maximum. Si cette valeur n'est pas supérieure au nombre de réplicas actuel du groupe de nœuds, l'appel échoue avec une exception.
- PreferredAvailabilityZones – Liste de chaînes PreferredAvailabilityZone qui spécifie dans quelles zones de disponibilité les nœuds des groupes de réplication doivent se trouver. Le nombre de valeurs PreferredAvailabilityZone doit être égal à la valeur de NewReplicaCount plus 1 afin de prendre en compte le nœud principal. Si ce membre de ReplicaConfiguration est omis, ElastiCache (Redis OSS) choisit la zone de disponibilité pour chacune des nouvelles répliques.

Important

Vous devez inclure le paramètre NewReplicaCount ou le paramètre ReplicaConfiguration, mais pas les deux, dans votre appel.


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>


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>

Pour plus d'informations sur l'augmentation du nombre de répliques à l'aide de l'API, consultez IncreaseReplicaCountle Amazon ElastiCache API Reference.

Avertissement JavaScript est désactivé ou n'est pas disponible dans votre navigateur.

Pour que vous puissiez utiliser la documentation AWS, Javascript doit être activé. Vous trouverez des instructions sur les pages d'aide de votre navigateur.

Conventions de rédaction

Modification du nombre de réplicas

Diminution du nombre de réplicas