Augmentation du nombre de réplicas dans une partition - Amazon ElastiCache for Redis

Augmentation du nombre de réplicas dans une partition

Vous pouvez augmenter le nombre de réplicas dans un groupe de réplication Redis (mode cluster activé) ou Redis (mode cluster désactivé) jusqu'à un maximum de cinq réplicas. Vous pouvez effectuer cette opération à l'aide de la AWS Management Console, de la AWS CLI ou de l'API ElastiCache.

Utilisation de la AWS Management Console

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

Pour augmenter le nombre de réplicas dans des partitions Redis

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

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

  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 Availability Zones (Zones de disponibilité), choisissez soit No preference (Aucune préférence) pour que ElastiCache choisisse une zone de disponibilité pour chaque nouveau réplica, soit Specify Availability Zones (Spécifier les zones de disponibilité) pour choisir une zone de disponibilité pour chaque nouveau réplica.

      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.

Utilisation de AWS CLI

Pour augmenter le nombre de réplicas dans une partition Redis, utilisez la commande increase-replica-count 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 qui ne comprennent qu'un groupe de nœuds ou groupe Redis (mode cluster activé), ou dans lesquels vous souhaitez que tous les groupes de nœuds aient le même nombre de réplicas. 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 (mode cluster activé) dans lesquels vous voulez 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 (mode cluster activé), l'ID de partition est toujours 0001. Pour trouver l'ID d'un groupe de nœuds (partitions) Redis (mode cluster activé), veuillez consulter 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 n'est pas indiqué, ElastiCache choisit la zone de disponibilité pour chacun des nouveaux réplicas.

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 nombre s'applique s'il s'agit d'un groupe Redis (mode cluster désactivé) avec un seul groupe de nœuds ou d'un groupe Redis (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 y a plusieurs groupes de nœuds, il s'agit d'un groupe de réplication Redis (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éplicas à l'aide de la CLI, veuillez consulter increase-replica-count dans la Référence de la ligne de commande Amazon ElastiCache.

Utilisation de l'API ElastiCache

Pour augmenter le nombre de réplicas dans une partition Redis, utilisez l'action IncreaseReplicaCount 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 (mode cluster désactivé) qui ne comprennent qu'un groupe de nœuds ou pour les groupes Redis (mode cluster activé) dans lesquels vous souhaitez que tous les groupes de nœuds aient le même nombre de réplicas. 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 (mode cluster activé) dans lesquels vous voulez 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 (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 (partitions) Redis (mode cluster activé), veuillez consulter 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 n'est pas indiqué, ElastiCache choisit la zone de disponibilité pour chacun des nouveaux réplicas.

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 nombre s'applique s'il s'agit d'un groupe Redis (mode cluster désactivé) avec un seul groupe de nœuds ou d'un groupe Redis (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 y a plusieurs groupes de nœuds, il s'agit d'un groupe de réplication Redis (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éplicas à l'aide de l'interface de ligne de commande, veuillez consulter IncreaseReplicaCount dans la Référence de l'API Amazon ElastiCache.