Augmentation du nombre de réplicas dans une partition - Amazon ElastiCache
À l'aide du AWS Management ConsoleÀ l'aide du AWS CLIÀ l'aide du ElastiCache API

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Augmentation du nombre de réplicas dans une partition

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

À l'aide du AWS Management Console

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

Pour augmenter le nombre de répliques dans les partitions

  1. Connectez-vous à la ElastiCache console AWS Management Console et ouvrez-la à l'adresse https://console.aws.amazon.com/elasticache/.

  2. Dans le volet de navigation, choisissez Valkey ou Redis OSS, puis choisissez le nom du groupe de réplication auquel vous souhaitez ajouter des répliques.

  3. Cochez la case correspondant à chaque partition à laquelle vous souhaitez ajouter des réplicas.

  4. Choisissez Add replicas (Ajouter des réplicas).

  5. 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.

  6. Choisissez Add (Ajouter) pour ajouter les réplicas ou Cancel (Annuler) pour annuler l'opération.

À l'aide du AWS CLI

Pour augmenter le nombre de répliques dans une partition Valkey ou RedisOSS, 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 Valkey ou Redis OSS (mode cluster désactivé) où il n'existe qu'un seul groupe de nœuds ou pour les groupes Valkey ou 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 Valkey ou 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 Valkey ou Redis OSS (mode cluster désactivé), l'ID de partition est toujours. 0001 Pour trouver l'ID d'un groupe de nœuds OSS (partition) Valkey ou Redis (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 (RedisOSS) 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 Valkey ou Redis OSS (mode cluster désactivé) avec un seul groupe de nœuds ou d'un groupe Valkey ou 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 Valkey ou 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 duCLI, consultez le increase-replica-countmanuel Amazon ElastiCache Command Line Reference.

À l'aide du ElastiCache API

Pour augmenter le nombre de répliques dans une partition Valkey ou RedisOSS, 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 Valkey ou Redis OSS (mode cluster désactivé) où il n'existe qu'un seul groupe de nœuds, ou pour les groupes Valkey ou 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 Valkey ou 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 Valkey ou 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 OSS (partition) Valkey ou Redis (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 (RedisOSS) 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.

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 Valkey ou Redis OSS (mode cluster désactivé) avec un seul groupe de nœuds, ou d'un groupe Valkey ou Redis OSS (mode cluster activé) avec plusieurs groupes de nœuds.

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>

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 Valkey ou 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.

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 duAPI, consultez IncreaseReplicaCountla ElastiCache APIréférence Amazon.