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.
# Haute disponibilité avec les groupes de réplication
Les clusters Amazon ElastiCache Valkey et Redis OSS à nœud unique sont des entités en mémoire dotées de services de protection des données (AOF) limités. Si votre cluster échoue pour une raison quelconque, vous perdez toutes les données du cluster. Toutefois, si vous utilisez un moteur Valkey ou Redis OSS, vous pouvez regrouper 2 à 6 nœuds dans un cluster avec des répliques où 1 à 5 nœuds en lecture seule contiennent les données de réplication du nœud principal unique du groupe. read/write Dans ce scénario, si un nœud échoue pour une raison quelconque, vous ne perdez pas toutes vos données puisque celles-ci sont répliquées sur un ou plusieurs nœuds. En raison de la latence de réplication, certaines données peuvent être perdues si c'est le read/write nœud principal qui tombe en panne.
Comme le montre le graphique suivant, la structure de réplication est contenue dans une partition (appelée *groupe de nœuds* dans l'API/CLI) contenue dans un cluster Valkey ou Redis OSS. Les clusters Valkey ou Redis OSS (mode cluster désactivé) ont toujours une partition. Les clusters Valkey ou Redis OSS (mode cluster activé) peuvent contenir jusqu'à 500 partitions, les données du cluster étant partitionnées entre les partitions. Vous pouvez créer un cluster contenant un nombre de partitions supérieur et un nombre de réplicas inférieur, qui conduisent à un nombre total de 90 nœuds par cluster. Cette configuration de cluster peut contenir de 90 partitions avec 0 réplica à 15 partitions avec 5 réplicas, ce qui correspond au nombre maximal de réplicas autorisé.
La limite de nœuds ou de partitions peut être augmentée jusqu'à un maximum de 500 par cluster avec ElastiCache Valkey, et avec la ElastiCache version 5.0.6 ou supérieure pour Redis OSS. Par exemple, vous pouvez choisir de configurer un cluster de 500 nœuds compris entre 83 (un principal et 5 réplicas par partition) et 500 partitions (un principal et aucun réplicas). Assurez-vous qu’il y ait suffisamment d’adresses IP disponibles pour faire face à l’augmentation. Les pièges courants incluent les sous-réseaux du groupe de sous-réseaux avec une plage CIDR trop petite ou les sous-réseaux partagés et fortement utilisés par d’autres clusters. Pour de plus amples informations, veuillez consulter [Création d'un groupe de sous-réseaux](SubnetGroups.Creating.md).
Pour les versions antérieures à 5.0.6, la limite est de 250 par cluster.
Pour demander une augmentation de cette limite, veuillez consulter [AWS Service Limits](https://docs.aws.amazon.com/general/latest/gr/aws_service_limits.html) et sélectionnez le type de limite **Nœuds par cluster par type d'instance**.
![\[Image : le cluster Valkey ou Redis OSS (mode cluster désactivé) possède une partition et 0 à 5 nœuds de réplication\]](http://docs.aws.amazon.com/fr_fr/AmazonElastiCache/latest/dg/images/ElastiCacheClusters-CSN-Redis-Replicas.png)
*Le cluster Valkey ou Redis OSS (mode cluster désactivé) possède une partition et 0 à 5 nœuds de réplication*
Si le mode Multi-AZ est activé pour le cluster avec réplicas et que le nœud principal échoue, le cluster bascule vers un réplica en lecture. Etant donné que les données sont mises à jour de façon asynchrone sur les nœuds de réplica, des données peuvent être perdues du fait de la latence des mises à jour des nœuds de réplication. Pour de plus amples informations, veuillez consulter [Atténuer les défaillances lors de l'exécution de Valkey ou Redis OSS](disaster-recovery-resiliency.md#FaultTolerance.Redis).
**Topics**
+ [Comprendre la réplication Valkey et Redis OSS](Replication.Redis.Groups.md)
+ [Réplication : mode cluster Valkey et Redis OSS désactivé ou activé](Replication.Redis-RedisCluster.md)
+ [Minimiser les temps d'arrêt en ElastiCache utilisant le multi-AZ avec Valkey et Redis OSS](AutoFailover.md)
+ [Implémentation de la sauvegarde et de la synchronisation](Replication.Redis.Versions.md)
+ [Création d'un groupe de réplication Valkey ou Redis OSS](Replication.CreatingRepGroup.md)
+ [Affichage des détails d'un groupe de réplication](Replication.ViewDetails.md)
+ [Recherche des points de terminaison du groupe de réplication](Replication.Endpoints.md)
+ [Modification d'un groupe de réplication](Replication.Modify.md)
+ [Suppression d'un groupe de réplication](Replication.DeletingRepGroup.md)
+ [Modification du nombre de réplicas](increase-decrease-replica-count.md)
+ [Promouvoir une réplique en lecture au statut principal, pour les groupes de réplication Valkey ou Redis OSS (mode cluster désactivé)](Replication.PromoteReplica.md)
# Comprendre la réplication Valkey et Redis OSS
Redis OSS implémente la réplication de deux manières :
+ Avec une seule partition contenant toutes les données du cluster dans chaque nœud : Valkey ou Redis OSS (mode cluster désactivé)
+ Avec des données partitionnées sur un maximum de 500 partitions : Valkey ou Redis OSS (mode cluster activé)
Chaque partition d'un groupe de réplication possède un seul nœud read/write principal et jusqu'à 5 nœuds de réplication en lecture seule. Vous pouvez créer un cluster contenant un nombre de partitions supérieur et un nombre de réplicas inférieur, qui conduisent à un nombre total de 90 nœuds par cluster. Cette configuration de cluster peut contenir de 90 partitions avec 0 réplica à 15 partitions avec 5 réplicas, ce qui correspond au nombre maximal de réplicas autorisé.
La limite de nœuds ou de partitions peut être augmentée jusqu'à un maximum de 500 par cluster si la version du moteur Redis OSS est 5.0.6 ou supérieure. Par exemple, vous pouvez choisir de configurer un cluster de 500 nœuds compris entre 83 (un principal et 5 réplicas par partition) et 500 partitions (un principal et aucun réplicas). Assurez-vous qu’il y ait suffisamment d’adresses IP disponibles pour faire face à l’augmentation. Les pièges courants incluent les sous-réseaux du groupe de sous-réseaux avec une plage CIDR trop petite ou les sous-réseaux partagés et fortement utilisés par d’autres clusters. Pour de plus amples informations, veuillez consulter [Création d'un groupe de sous-réseaux](SubnetGroups.Creating.md).
Pour les versions antérieures à 5.0.6, la limite est de 250 par cluster.
Pour demander une augmentation de cette limite, veuillez consulter [AWS Service Limits](https://docs.aws.amazon.com/general/latest/gr/aws_service_limits.html) et sélectionnez le type de limite **Nœuds par cluster par type d'instance**.
**Topics**
+ [Valkey ou Redis OSS (mode cluster désactivé)](#Replication.Redis.Groups.Classic)
+ [Valkey ou Redis OSS (mode cluster activé)](#Replication.Redis.Groups.Cluster)
## Valkey ou Redis OSS (mode cluster désactivé)
Un cluster Valkey ou Redis OSS (mode cluster désactivé) possède une seule partition, à l'intérieur de laquelle se trouve un ensemble de nœuds : un read/write nœud principal et jusqu'à cinq nœuds répliques secondaires en lecture seule. Chaque réplica en lecture conserve une copie des données du nœud principal du cluster. Des mécanismes de réplication asynchrones sont utilisés pour maintenir les réplicas en lecture synchronisés avec le nœud principal. Les applications peuvent lire à partir de n'importe quel nœud du cluster. Les applications ne peuvent écrire que sur le nœud principal. Les réplicas en lecture améliorent le débit de lecture et préviennent la perte de données en cas de défaillance d'un nœud.
![\[Image : cluster Valkey ou Redis OSS (mode cluster désactivé) avec une seule partition et des nœuds de réplication\]](http://docs.aws.amazon.com/fr_fr/AmazonElastiCache/latest/dg/images/ElastiCacheClusters-CSN-Redis-Replicas.png)
*Cluster Valkey ou Redis OSS (mode cluster désactivé) avec une seule partition et des nœuds de réplication*
Vous pouvez utiliser des clusters Valkey ou Redis OSS (mode cluster désactivé) avec des nœuds de réplication pour adapter votre solution ElastiCache afin de gérer les applications gourmandes en lecture ou de prendre en charge un grand nombre de clients lisant simultanément à partir du même cluster.
Tous les nœuds d'un cluster Valkey ou Redis OSS (mode cluster désactivé) doivent résider dans la même région.
Lorsque vous ajoutez un réplica en lecture à un cluster, toutes les données du nœud principal sont copiées dans le nouveau nœud. A partir de ce moment, chaque fois que des données sont écrites sur le nœud principal, les changements sont propagés en mode asynchrone sur tous les réplicas en lecture.
Pour améliorer la tolérance aux pannes et réduire les temps d'arrêt d'écriture, activez le mode multi-AZ avec basculement automatique pour votre cluster Valkey ou Redis OSS (mode cluster désactivé) avec des répliques. Pour de plus amples informations, veuillez consulter [Minimiser les temps d'arrêt en ElastiCache utilisant le multi-AZ avec Valkey et Redis OSS](AutoFailover.md).
Vous pouvez modifier les rôles des nœuds au sein du cluster Valkey ou Redis OSS (mode cluster désactivé), le principal et l'une des répliques échangeant des rôles. Vous pouvez décider de le faire pour améliorer des performances. Par exemple, avec une application Web qui a une activité d'écriture intensive, vous pouvez choisir le nœud avec la plus basse latence réseau. Pour de plus amples informations, veuillez consulter [Promouvoir une réplique en lecture au statut principal, pour les groupes de réplication Valkey ou Redis OSS (mode cluster désactivé)](Replication.PromoteReplica.md).
## Valkey ou Redis OSS (mode cluster activé)
Un cluster Valkey ou Redis OSS (mode cluster activé) est composé de 1 à 500 partitions (API/CLI : groupes de nœuds). Chaque partition dispose d'un nœud primaire et jusqu'à 5 nœuds de réplica en lecture seule. La configuration peut contenir de 90 partitions avec 0 réplica à 15 partitions avec 5 réplicas, ce qui correspond au nombre maximal de réplicas autorisé.
La limite de nœuds ou de partitions peut être augmentée jusqu'à un maximum de 500 par cluster si la version du moteur est Valkey 7.2 ou supérieure, ou Redis OSS 5.0.6 ou version ultérieure. Par exemple, vous pouvez choisir de configurer un cluster de 500 nœuds compris entre 83 (un principal et 5 réplicas par partition) et 500 partitions (un principal et aucun réplicas). Assurez-vous qu’il y ait suffisamment d’adresses IP disponibles pour faire face à l’augmentation. Les pièges courants incluent les sous-réseaux du groupe de sous-réseaux avec une plage CIDR trop petite ou les sous-réseaux partagés et fortement utilisés par d’autres clusters. Pour de plus amples informations, veuillez consulter [Création d'un groupe de sous-réseaux](SubnetGroups.Creating.md).
Pour les versions antérieures à 5.0.6, la limite est de 250 par cluster.
Pour demander une augmentation de cette limite, veuillez consulter [AWS Service Limits](https://docs.aws.amazon.com/general/latest/gr/aws_service_limits.html) et sélectionnez le type de limite **Nœuds par cluster par type d'instance**.
Chaque réplica en lecture d'une partition conserve une copie des données du nœud principal de la partition. Des mécanismes de réplication asynchrones sont utilisés pour maintenir les réplicas en lecture synchronisés avec le nœud principal. Les applications peuvent lire à partir de n'importe quel nœud du cluster. Les applications ne peuvent écrire que sur les nœuds principaux. Les réplicas en lecture améliorent l'évolutivité de la lecture et empêchent la perte de données. Les données sont partitionnées entre les partitions d'un cluster Valkey ou Redis OSS (mode cluster activé).
Les applications utilisent le point de *terminaison de configuration* du cluster Valkey ou Redis OSS (mode cluster activé) pour se connecter aux nœuds du cluster. Pour de plus amples informations, veuillez consulter [Recherche de points de terminaison de connexion dans ElastiCache](Endpoints.md).
![\[Image : cluster Valkey ou Redis OSS (mode cluster activé) avec plusieurs partitions et nœuds de réplication\]](http://docs.aws.amazon.com/fr_fr/AmazonElastiCache/latest/dg/images/ElastiCacheClusters-CSN-RedisClusters.png)
*Cluster Valkey ou Redis OSS (mode cluster activé) avec plusieurs partitions et nœuds de réplication*
Tous les nœuds d'un cluster Valkey ou Redis OSS (mode cluster activé) doivent résider dans la même région. Pour améliorer la tolérance aux pannes, vous pouvez mettre en service les réplicas principaux et en lecture dans plusieurs zones de disponibilité au sein de cette région.
Actuellement, les fonctionnalités de Valkey ou Redis OSS (mode cluster activé) présentent certaines limites.
+ Vous ne pouvez promouvoir manuellement aucun des nœuds de réplica en tant que nœud principal.
# Réplication : mode cluster Valkey et Redis OSS désactivé ou activé
À partir de Valkey 7.2 et de Redis OSS version 3.2, vous avez la possibilité de créer l'un des deux types distincts de clusters (API/CLI: replication groups). A Valkey or Redis OSS (cluster mode disabled) cluster always has a single shard (API/CLIgroupe de nœuds) avec jusqu'à 5 nœuds de réplication en lecture. Un cluster Valkey ou Redis OSS (mode cluster activé) comporte jusqu'à 500 partitions contenant chacune 1 à 5 nœuds de réplication en lecture.
![\[Image : clusters Valkey ou Redis OSS (mode cluster désactivé) et clusters Valkey ou Redis OSS (mode cluster activé)\]](http://docs.aws.amazon.com/fr_fr/AmazonElastiCache/latest/dg/images/ElastiCache-NodeGroups.png)
*Clusters Valkey ou Redis OSS (mode cluster désactivé) et clusters Valkey ou Redis OSS (mode cluster activé)*
Le tableau suivant résume les différences importantes entre les clusters Valkey ou Redis OSS (mode cluster désactivé) et les clusters Valkey ou Redis OSS (mode cluster activé).
**Comparaison de clusters Valkey ou Redis OSS (mode cluster désactivé) et Valkey ou Redis OSS (mode cluster activé)**
| Fonctionnalité | Valkey ou Redis OSS (mode cluster désactivé) | Valkey ou Redis OSS (mode cluster activé) |
| --- | --- | --- |
| Adaptabilité | Oui. Prend en charge l'ajout et la suppression des nœuds de réplica et la mise à l'échelle du type de nœud. | Limité. Pour plus d’informations, consultez [Gestion des versions pour ElastiCache](VersionManagement.md) et [Mise à l'échelle des clusters Valkey ou Redis OSS (mode cluster activé)](scaling-redis-cluster-mode-enabled.md). |
| Partitionnement de données | Non | Oui |
| Partitions | 1 | 1 à 500 |
| Réplicas en lecture | 0 à 5 Si vous n'avez aucun réplica et que le nœud échoue, vous risquez de perdre toutes les données. | 0 sur 5 par partition. Si vous n'avez aucun réplica et qu'un nœud échoue, vous risquez de perdre toutes les données de cette partition. |
| Multi-AZ | Oui, avec au moins 1 réplica. Facultatif. Activé par défaut. | OuiFacultatif. Activé par défaut. |
| Instantanés (Sauvegardes) | Oui, création d'un fichier .rdb unique. | Oui, création d'un fichier .rdb unique pour chaque partition. |
| Restaurer | Oui, en utilisant un seul fichier .rdb provenant d'un cluster Valkey ou Redis OSS (mode cluster désactivé). | Oui, en utilisant des fichiers .rdb provenant d'un Valkey ou Redis OSS (mode cluster désactivé) ou d'un cluster Valkey ou Redis OSS (mode cluster activé). |
| Pris en charge par | Toutes les versions de Valkey et Redis OSS | Toutes les versions de Valkey, ainsi que Redis OSS 3.2 et versions ultérieures |
| Moteur évolutif | Oui, avec certaines limites. Pour de plus amples informations, veuillez consulter [Gestion des versions pour ElastiCache](VersionManagement.md). | Oui, avec certaines limites. Pour de plus amples informations, veuillez consulter [Gestion des versions pour ElastiCache](VersionManagement.md). |
| Chiffrement | Versions 3.2.6 (dont la fin de vie est prévue, voir le [calendrier de fin de vie des versions Redis OSS) et 4.0.10](engine-versions.md#deprecated-engine-versions) et versions ultérieures. | Versions 3.2.6 (dont la fin de vie est prévue, voir le [calendrier de fin de vie des versions Redis OSS) et 4.0.10](engine-versions.md#deprecated-engine-versions) et versions ultérieures. |
| Éligible HIPAA | Versions 3.2.6 (dont la fin de vie est prévue, voir le [calendrier de fin de vie des versions Redis OSS) et 4.0.10](engine-versions.md#deprecated-engine-versions) et versions ultérieures. | Versions 3.2.6 (dont la fin de vie est prévue, voir le [calendrier de fin de vie des versions Redis OSS) et 4.0.10](engine-versions.md#deprecated-engine-versions) et versions ultérieures. |
| Conforme à PCI DSS | Versions 3.2.6 (dont la fin de vie est prévue, voir le [calendrier de fin de vie des versions Redis OSS) et 4.0.10](engine-versions.md#deprecated-engine-versions) et versions ultérieures. | Versions 3.2.6 (dont la fin de vie est prévue, voir le [calendrier de fin de vie des versions Redis OSS) et 4.0.10](engine-versions.md#deprecated-engine-versions) et versions ultérieures. |
| Repartitionnement en ligne | N/A | Version 3.2.10 (prévue pour EOL, voir le [calendrier de fin de vie des versions Redis OSS](engine-versions.md#deprecated-engine-versions)) et versions ultérieures. |
## Lequel choisir ?
Lorsque vous choisissez entre Valkey ou Redis OSS (mode cluster désactivé) ou Valkey ou Redis OSS (mode cluster activé), tenez compte des facteurs suivants :
+ **Mise à l'échelle ou partitionnement** – Les besoins métier évoluent. Vous devez soit allouer les ressources pour les fortes demandes ou mettre à l'échelle vos ressources en fonction des demandes. Valkey ou Redis OSS (mode cluster désactivé) prend en charge le dimensionnement. Vous pouvez mettre à l'échelle la capacité de lecture en ajoutant ou en supprimant des nœuds de réplica, ou vous pouvez mettre à l'échelle la capacité en optant pour un type de nœud de plus grande capacité. Ces deux opérations prennent du temps. Pour plus d'informations, consultez [Dimensionnement des nœuds de réplication pour Valkey ou Redis OSS (mode cluster désactivé)](Scaling.RedisReplGrps.md).
Valkey ou Redis OSS (mode cluster activé) prend en charge le partitionnement de vos données sur un maximum de 500 groupes de nœuds. Vous pouvez modifier dynamiquement le nombre de partitions au fur et à mesure que les besoins de votre entreprise évoluent. Le partitionnement présente notamment l'avantage de pouvoir répartir votre charge sur un plus grand nombre de points de terminaison, ce qui réduit les goulots d'étranglement lorsque la demande est la plus élevée. En outre, vous pouvez gérer un plus grand nombre de données dans la mesure où elles peuvent être réparties sur plusieurs serveurs. Pour plus d'informations sur la mise à l'échelle de vos partitions, consultez[Mise à l'échelle des clusters Valkey ou Redis OSS (mode cluster activé)](scaling-redis-cluster-mode-enabled.md).
+ **Taille du nœud par rapport au nombre de nœuds** : étant donné qu'un cluster Valkey ou Redis OSS (mode cluster désactivé) ne possède qu'une seule partition, le type de nœud doit être suffisamment grand pour accueillir toutes les données du cluster ainsi que la surcharge nécessaire. D'autre part, étant donné que vous pouvez partitionner vos données sur plusieurs partitions lorsque vous utilisez un cluster Valkey ou Redis OSS (mode cluster activé), les types de nœuds peuvent être plus petits, mais vous en avez besoin d'un plus grand nombre. Pour de plus amples informations, veuillez consulter [Choix de la taille de votre nœud](CacheNodes.SelectSize.md).
+ **Lectures et écritures** : si la charge principale de votre cluster est constituée d'applications lisant des données, vous pouvez redimensionner un cluster Valkey ou Redis OSS (mode cluster désactivé) en ajoutant et en supprimant des répliques de lecture. Néanmoins, notez qu'il y a un maximum de 5 réplicas en lecture. Si la charge de votre cluster est importante en écriture, vous pouvez bénéficier des points de terminaison d'écriture supplémentaires d'un cluster Valkey ou Redis OSS (mode cluster activé) avec plusieurs partitions.
Quel que soit le type de cluster que vous choisissez d'implémenter, assurez-vous de choisir un type de nœud qui convient à vos besoins actuels et futurs.
# Minimiser les temps d'arrêt en ElastiCache utilisant le multi-AZ avec Valkey et Redis OSS
Dans un certain nombre de cas ElastiCache , Valkey et Redis OSS peuvent avoir besoin de remplacer un nœud principal ; il s'agit notamment de certains types de maintenance planifiée et de l'éventualité peu probable d'une défaillance d'un nœud principal ou d'une zone de disponibilité.
Ce remplacement entraîne un certain temps d'arrêt pour le cluster, mais si Multi-AZ est activé, le temps d'arrêt est réduit. Le rôle du nœud primaire bascule automatiquement sur l'un des réplicas en lecture. Il n'est pas nécessaire de créer et de provisionner un nouveau nœud principal, car il ElastiCache gérera cela de manière transparente. Ce basculement et la promotion d'un réplica vous permettent de recommencer à écrire dans le nouveau nœud principal dès que la promotion est terminée.
ElastiCache propage également le nom DNS (Domain Name Service) de la réplique promue. De cette façon, si votre application écrit dans le point de terminaison principal, aucun changement du point de terminaison ne sera nécessaire dans le cadre de votre application. Si vous lisez à partir de points de terminaison individuels, veillez à modifier le point de terminaison de lecture du réplica promu en principal en point de terminaison du nouveau réplica.
Dans le cas de remplacements de nœuds planifiés, initiés en raison de mises à jour de maintenance ou de mises à jour en libre service, soyez conscient des points suivants :
+ Pour les clusters Valkey et Redis OSS, les remplacements de nœuds prévus sont terminés pendant que le cluster traite les demandes d'écriture entrantes.
+ Pour les clusters désactivés en mode cluster Valkey et Redis OSS avec le mode multi-AZ activé qui s'exécutent sur le moteur 5.0.6 ou version ultérieure, les remplacements de nœuds prévus sont terminés pendant que le cluster traite les demandes d'écriture entrantes.
+ Pour les clusters désactivés en mode cluster Valkey et Redis OSS avec le mode multi-AZ activé qui s'exécutent sur le moteur 4.0.10 ou une version antérieure, vous remarquerez peut-être une brève interruption d'écriture associée aux mises à jour DNS. Cette interruption peut prendre jusqu'à quelques secondes. Ce processus est nettement plus rapide que celui qui consiste à recréer et mettre en service un nouveau nœud primaire, processus appliqué si vous n'activez pas le mode Multi-AZ.
Vous pouvez activer le Multi-AZ à l'aide de la console de ElastiCache gestion AWS CLI, de ou de l' ElastiCache API.
L'activation de ElastiCache Multi-AZ sur votre cluster Valkey ou Redis OSS (dans l'API et la CLI, groupe de réplication) améliore votre tolérance aux pannes. Cela est particulièrement vrai dans les cas où le cluster read/write principal de votre cluster devient inaccessible ou tombe en panne pour une raison quelconque. Le multi-AZ n'est pris en charge que sur les clusters Valkey et Redis OSS comportant plus d'un nœud par partition.
**Topics**
+ [Activation du multi-AZ](#AutoFailover.Enable)
+ [Scénarios de défaillance avec réponses multi-AZ](#AutoFailover.Scenarios)
+ [Test du basculement automatique](#auto-failover-test)
+ [Limitations relatives à la technologie Multi-AZ](#AutoFailover.Limitations)
## Activation du multi-AZ
Vous pouvez activer le mode multi-AZ lorsque vous créez ou modifiez un cluster (API ou CLI, groupe de réplication) à l'aide de la ElastiCache console ou de l' ElastiCacheAPI. AWS CLI
Vous pouvez activer le mode multi-AZ uniquement sur les clusters Valkey ou Redis OSS (mode cluster désactivé) disposant d'au moins une réplique en lecture disponible. Les clusters sans réplica en lecture n'offrent pas une haute disponibilité ni la tolérance aux pannes. Pour plus d'informations sur la création d'un cluster avec réplication, consultez [Création d'un groupe de réplication Valkey ou Redis OSS](Replication.CreatingRepGroup.md). Pour plus d'informations sur l'ajout d'un réplica à un cluster avec réplication, consultez [Ajouter une réplique de lecture pour Valkey ou Redis OSS (mode cluster désactivé)](Replication.AddReadReplica.md).
**Topics**
+ [Activation du multi-AZ (console)](#AutoFailover.Enable.Console)
+ [Activation de Multi-AZ (AWS CLI)](#AutoFailover.Enable.CLI)
+ [Activation du Multi-AZ (ElastiCache API)](#AutoFailover.Enable.API)
### Activation du multi-AZ (console)
Vous pouvez activer le Multi-AZ à l'aide de la ElastiCache console lorsque vous créez un nouveau cluster Valkey ou Redis OSS ou en modifiant un cluster existant par réplication.
Le multi-AZ est activé par défaut sur les clusters Valkey ou Redis OSS (mode cluster activé).
**Important**
ElastiCache activera automatiquement le mode multi-AZ uniquement si le cluster contient au moins une réplique dans une zone de disponibilité différente de la principale dans toutes les partitions.
#### Activation du mode multi-AZ lors de la création d'un cluster à l'aide de la console ElastiCache
Pour plus d'informations sur ce processus, consultez [Création d'un cluster Valkey (mode cluster désactivé) (console)](SubnetGroups.designing-cluster-pre.valkey.md#Clusters.Create.CON.valkey-gs). Assurez-vous d'avoir un ou plusieurs réplicas et activez Multi-AZ.
#### Activation du multi-AZ sur un cluster existant (console)
Pour plus d'informations sur ce processus, consultez Modification d'un cluster [À l'aide du ElastiCache AWS Management Console](Clusters.Modify.md#Clusters.Modify.CON).
### Activation de Multi-AZ (AWS CLI)
L'exemple de code suivant utilise le AWS CLI pour activer le mode multi-AZ pour le groupe `redis12` de réplication.
**Important**
Le groupe de réplication `redis12` doit déjà exister et avoir au moins un réplica en lecture disponible.
Pour Linux, macOS ou Unix :
```
aws elasticache modify-replication-group \
--replication-group-id redis12 \
--automatic-failover-enabled \
--multi-az-enabled \
--apply-immediately
```
Pour Windows :
```
aws elasticache modify-replication-group ^
--replication-group-id redis12 ^
--automatic-failover-enabled ^
--multi-az-enabled ^
--apply-immediately
```
Le résultat JSON de cette commande devrait ressembler à cet exemple.
```
{
"ReplicationGroup": {
"Status": "modifying",
"Description": "One shard, two nodes",
"NodeGroups": [
{
"Status": "modifying",
"NodeGroupMembers": [
{
"CurrentRole": "primary",
"PreferredAvailabilityZone": "us-west-2b",
"CacheNodeId": "0001",
"ReadEndpoint": {
"Port": 6379,
"Address": "redis12-001.v5r9dc.0001.usw2.cache.amazonaws.com"
},
"CacheClusterId": "redis12-001"
},
{
"CurrentRole": "replica",
"PreferredAvailabilityZone": "us-west-2a",
"CacheNodeId": "0001",
"ReadEndpoint": {
"Port": 6379,
"Address": "redis12-002.v5r9dc.0001.usw2.cache.amazonaws.com"
},
"CacheClusterId": "redis12-002"
}
],
"NodeGroupId": "0001",
"PrimaryEndpoint": {
"Port": 6379,
"Address": "redis12.v5r9dc.ng.0001.usw2.cache.amazonaws.com"
}
}
],
"ReplicationGroupId": "redis12",
"SnapshotRetentionLimit": 1,
"AutomaticFailover": "enabling",
"MultiAZ": "enabled",
"SnapshotWindow": "07:00-08:00",
"SnapshottingClusterId": "redis12-002",
"MemberClusters": [
"redis12-001",
"redis12-002"
],
"PendingModifiedValues": {}
}
}
```
Pour plus d'informations, consultez ces rubriques dans la *Référence des commandes de l'AWS CLI * :
+ [create-cache-cluster](https://docs.aws.amazon.com/cli/latest/reference/elasticache/create-cache-cluster.html)
+ [create-replication-group](https://docs.aws.amazon.com/cli/latest/reference/elasticache/create-replication-group.html)
+ [modify-replication-group](https://docs.aws.amazon.com/cli/latest/reference/elasticache/modify-replication-group.html)dans la *référence de AWS CLI commande.*
### Activation du Multi-AZ (ElastiCache API)
L'exemple de code suivant utilise l' ElastiCache API pour activer le mode multi-AZ pour le groupe `redis12` de réplication.
**Note**
Pour que vous puissiez utiliser cet exemple, le groupe de réplication `redis12` doit déjà exister et avoir au moins un réplica en lecture disponible.
```
https://elasticache.us-west-2.amazonaws.com/
?Action=ModifyReplicationGroup
&ApplyImmediately=true
&AutoFailover=true
&MultiAZEnabled=true
&ReplicationGroupId=redis12
&Version=2015-02-02
&SignatureVersion=4
&SignatureMethod=HmacSHA256
&Timestamp=20140401T192317Z
&X-Amz-Credential=
```
Pour plus d'informations, consultez ces rubriques dans la *référence de l'API ElastiCache * :
+ [CreateCacheCluster](https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_CreateCacheCluster.html)
+ [CreateReplicationGroup](https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_CreateReplicationGroup.html)
+ [ModifyReplicationGroup](https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_ModifyReplicationGroup.html)
## Scénarios de défaillance avec réponses multi-AZ
Avant l'introduction du Multi-AZ, les nœuds défaillants d'un cluster étaient ElastiCache détectés et remplacés en recréant et en reprovisionnant le nœud défaillant. Si vous activez Multi-AZ, un cluster principal défaillant bascule vers le réplica ayant le moindre décalage de réplication. Le réplica sélectionné est automatiquement promu au rang de principal, ce qui est beaucoup plus rapide que de créer et de remettre en service un nouveau nœud principal. Ce processus dure généralement quelques secondes pendant lesquelles vous ne pouvez pas écrire sur le cluster.
Lorsque le mode Multi-AZ est activé, il surveille ElastiCache en permanence l'état du nœud principal. En cas de défaillance du nœud principal, l'une des actions suivantes est effectuée selon le type de la défaillance.
**Topics**
+ [Scénarios d'échec lorsque seul le nœud primaire échoue](#AutoFailover.Scenarios.PrimaryOnly)
+ [Scénarios de défaillance en cas de défaillance du nœud primaire et de certains réplicas en lecture](#AutoFailover.Scenarios.PrimaryAndReplicas)
+ [Scénarios d'échec lorsque l'ensemble du cluster tombe en panne](#AutoFailover.Scenarios.AllFail)
### Scénarios d'échec lorsque seul le nœud primaire échoue
Si seul le nœud principal échoue, le réplica en lecture ayant le moindre décalage de réplication est promu au rang de principal. Un réplica en lecture de remplacement est ensuite créé et provisionné dans la même zone de disponibilité que le principal défaillant.
Lorsque seul le nœud principal tombe en panne, ElastiCache Multi-AZ effectue les opérations suivantes :
1. Le nœud principal défaillant est mis hors ligne.
1. Le réplica en lecture ayant le moindre décalage de réplication est promu au rang de principal.
Les écritures peuvent reprendre dès que le processus de promotion est terminé, généralement au bout de quelques secondes. Si votre application écrit sur le point de terminaison principal, il n'est pas nécessaire de changer le point de terminaison pour les écritures et les lectures dans la mesure où ElastiCache diffuse le nom DNS du réplica promu.
1. Un réplica en lecture de remplacement est lancé et mis en service.
Le réplica en lecture de remplacement est lancé dans la zone de disponibilité où se trouvait le nœud principal défaillant afin que la distribution de nœuds soit maintenue.
1. La synchronisation des autres réplicas avec le nouveau nœud principal se produit.
Lorsque le nouveau réplica est disponible, vous devez être conscient des effets suivants :
+ **Point de terminaison principal** : vous n'avez besoin d'effectuer aucune modification sur votre application, dans la mesure où le nom DNS du nouveau nœud primaire est propagé au point de terminaison principal.
+ **Point de terminaison de lecture** : le point de terminaison du lecteur est automatiquement mis à jour de manière à pointer vers les nouveaux nœuds de réplica.
Pour plus d'informations sur la recherche des points de terminaison d'un cluster, consultez les rubriques suivantes :
+ [Trouver les points de terminaison d'un cluster Valkey ou Redis OSS (mode cluster désactivé) (console)](Endpoints.md#Endpoints.Find.Redis)
+ [Recherche des points de terminaison pour les groupes de réplication Valkey ou Redis OSS ()AWS CLI](Endpoints.md#Endpoints.Find.CLI.ReplGroups)
+ [Recherche de points de terminaison pour les groupes de réplication (API) Valkey ou Redis OSS ElastiCache](Endpoints.md#Endpoints.Find.API.ReplGroups)
### Scénarios de défaillance en cas de défaillance du nœud primaire et de certains réplicas en lecture
Lorsque le nœud principal et au moins un réplica en lecture sont défaillants, le réplica disponible avec le moindre décalage de réplication est promu cluster principal. De nouveaux réplicas en lecture sont également créés et mis en service dans les mêmes zones de disponibilité que les nœuds défaillants et le réplica promu cluster principal.
Lorsque le nœud principal et certaines répliques de lecture échouent, ElastiCache Multi-AZ effectue les opérations suivantes :
1. Le nœud principal et les réplicas en lecture ayant échoué sont mis hors ligne.
1. Le réplica en lecture disponible ayant le moindre décalage de réplication est promu au rang de nœud principal.
Les écritures peuvent reprendre dès que le processus de promotion est terminé, généralement au bout de quelques secondes. Si votre application écrit sur le point de terminaison principal, il n'est pas nécessaire de modifier le point de terminaison pour les écritures. ElastiCache propage le nom DNS de la réplique promue.
1. Des réplicas de remplacement sont créés et provisionnés.
Les réplicas de remplacement sont créés dans les zones de disponibilité des nœuds ayant échoué afin que la distribution des nœuds soit maintenue.
1. Tous les clusters sont synchronisés avec le nouveau nœud principal.
Vous devez apporter les modifications suivantes à votre application, une fois que les nouveaux nœuds sont disponibles :
+ **Point de terminaison principal** : n'apportez aucune modification à votre application. Le nom DNS du nouveau nœud principal est propagé au point de terminaison principal.
+ **Point de terminaison de lecture** : le point de terminaison de lecture est automatiquement mis à jour de manière à pointer vers les nouveaux nœuds de réplica.
Pour plus d'informations sur la recherche des points de terminaison d'un groupe de réplication, consultez les rubriques suivantes :
+ [Trouver les points de terminaison d'un cluster Valkey ou Redis OSS (mode cluster désactivé) (console)](Endpoints.md#Endpoints.Find.Redis)
+ [Recherche des points de terminaison pour les groupes de réplication Valkey ou Redis OSS ()AWS CLI](Endpoints.md#Endpoints.Find.CLI.ReplGroups)
+ [Recherche de points de terminaison pour les groupes de réplication (API) Valkey ou Redis OSS ElastiCache](Endpoints.md#Endpoints.Find.API.ReplGroups)
### Scénarios d'échec lorsque l'ensemble du cluster tombe en panne
En cas de défaillance générale, tous les nœuds sont recréés et mis en service dans les mêmes zones de disponibilité que les nœuds initiaux.
Dans ce scénario, toutes les données du cluster sont perdues en raison de la défaillance au niveau de chaque nœud du cluster. Cela se produit rarement.
Lorsque l'ensemble du cluster échoue, ElastiCache Multi-AZ effectue les opérations suivantes :
1. Le nœud principal et les réplicas en lecture ayant échoué sont mis hors ligne.
1. Un nœud principal de remplacement est créé et mis en service.
1. Des réplicas de remplacement sont créés et provisionnés.
Les remplacements sont créés dans les zones de disponibilité des nœuds ayant échoué afin que la distribution des nœuds soit maintenue.
Etant donné que la totalité du cluster a échoué, les données sont perdues et tous les nouveaux nœuds démarrent à vide.
Comme chacun des nœuds de remplacement a le même point de terminaison que le nœud qu'il remplace, il n'est pas nécessaire de modifier le point de terminaison de votre application.
Pour plus d'informations sur la recherche des points de terminaison d'un groupe de réplication, consultez les rubriques suivantes :
+ [Trouver les points de terminaison d'un cluster Valkey ou Redis OSS (mode cluster désactivé) (console)](Endpoints.md#Endpoints.Find.Redis)
+ [Recherche des points de terminaison pour les groupes de réplication Valkey ou Redis OSS ()AWS CLI](Endpoints.md#Endpoints.Find.CLI.ReplGroups)
+ [Recherche de points de terminaison pour les groupes de réplication (API) Valkey ou Redis OSS ElastiCache](Endpoints.md#Endpoints.Find.API.ReplGroups)
Nous vous recommandons de créer le nœud principal et les réplicas dans différentes zones de disponibilité pour augmenter votre niveau de tolérance aux pannes.
## Test du basculement automatique
Après avoir activé le basculement automatique, vous pouvez le tester à l'aide de la ElastiCache console AWS CLI, du et de l' ElastiCache API.
Lors du test, tenez compte des points suivants :
+ Vous pouvez utiliser cette opération pour tester le basculement automatique sur un maximum de 15 partitions (appelées groupes de nœuds dans l' ElastiCache API et AWS CLI) sur une période continue de 24 heures.
+ Si vous appelez cette opération sur des partitions de différents clusters (nommés groupes de réplication dans l'API et la CLI), vous pouvez effectuer des appels simultanément.
+ Dans certains cas, vous pouvez effectuer cette opération plusieurs fois sur différents fragments du même groupe de réplication Valkey ou Redis OSS (mode cluster activé). Dans de tels cas, le premier remplacement de nœud doit se terminer avant qu'un appel ultérieur puisse être effectué.
+ Pour déterminer si le remplacement du nœud est terminé, vérifiez les événements à l'aide de la ElastiCache console Amazon, de l' AWS CLI API ou de l' ElastiCache API. Recherchez les événements suivants liés au basculement automatique, répertoriés ici dans leur ordre d'occurrence probable :
1. Message du groupe de réplication : `Test Failover API called for node group `
1. Message du cluster de cache : `Failover from primary node to replica node completed`
1. Message du groupe de réplication : `Failover from primary node to replica node completed`
1. Message du cluster de cache : `Recovering cache nodes `
1. Message du cluster de cache : `Finished recovery for cache nodes `
Pour plus d’informations, consultez les ressources suivantes :
+ [Affichage des ElastiCache événements](ECEvents.Viewing.md) dans le *guide de l'utilisateur ElastiCache *
+ [DescribeEvents](https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_DescribeEvents.html) dans la *Référence d'API ElastiCache *
+ [describe-events](https://docs.aws.amazon.com/cli/latest/reference/elasticache/describe-events.html) dans la *Référence des commandes de l'AWS CLI *.
+ Cette API est conçue pour tester le comportement de votre application en cas de ElastiCache basculement. Elle n’a pas été conçue pour être un outil opérationnel permettant de lancer un basculement pour résoudre un problème avec le cluster. De plus, dans certaines conditions, telles que des événements opérationnels à grande échelle, cette API AWS peut être bloquée.
**Topics**
+ [Test du basculement automatique à l'aide du AWS Management Console](#auto-failover-test-con)
+ [Test du basculement automatique à l'aide du AWS CLI](#auto-failover-test-cli)
+ [Test du basculement automatique à l'aide de l'API ElastiCache](#auto-failover-test-api)
### Test du basculement automatique à l'aide du AWS Management Console
Utilisez la procédure suivante pour tester le basculement automatique avec la console.
**Pour tester le basculement automatique**
1. Connectez-vous à la ElastiCache console AWS Management Console et ouvrez-la à l'adresse [ https://console.aws.amazon.com/elasticache/](https://console.aws.amazon.com/elasticache/).
1. Dans le volet de navigation, choisissez **Valkey** ou **Redis OSS**.
1. Dans la liste des clusters, cochez la case située à gauche du cluster que vous souhaitez tester. Ce cluster doit avoir au moins un nœud de réplica en lecture.
1. Dans la zone **Détails** vérifiez que la fonctionnalité Multi-AZ est activée pour ce cluster. Si tel n'est pas le cas, choisissez un autre cluster ou modifiez-le afin d'activer Multi-AZ. Pour de plus amples informations, veuillez consulter [À l'aide du ElastiCache AWS Management Console](Clusters.Modify.md#Clusters.Modify.CON).
![\[Image : zone de détails d'un cluster compatible multi-AZ\]](http://docs.aws.amazon.com/fr_fr/AmazonElastiCache/latest/dg/images/ElastiCache-AutoFailover-MultiAZ-Enabled.png)
1. Pour Valkey ou Redis OSS (mode cluster désactivé), choisissez le nom du cluster.
Pour Valkey ou Redis OSS (mode cluster activé), procédez comme suit :
1. Choisissez le nom du cluster.
1. Sur la page **Partitions**, pour la partition (nommée groupe de nœuds dans l'API ou la CLI) sur laquelle vous souhaitez tester le basculement, choisissez le nom de la partition.
1. Sur la page Nœuds, choisissez **Failover Primary**.
1. Choisissez **Continuer** pour basculer le nœud principal, ou sur **Annuler** pour annuler l'opération et ne pas basculer le nœud principal.
Au cours du processus de basculement, la console continue à afficher le statut *available* du nœud. Pour suivre l'avancement du test de basculement, choisissez**Événements** dans le volet de navigation de la console. Sous l'onglet **Événements**, recherchez les événements indiquant que le basculement a commencé (`Test Failover API called`) et est terminé (`Recovery completed`).
### Test du basculement automatique à l'aide du AWS CLI
Vous pouvez tester le basculement automatique sur n'importe quel cluster compatible Multi-AZ à l' AWS CLI aide de cette opération. `test-failover`
**Paramètres**
+ `--replication-group-id` : obligatoire. Groupe de réplication (sur la console, cluster) qui va être testé.
+ `--node-group-id` : obligatoire. Nom du groupe de nœuds sur lequel vous souhaitez tester le basculement automatique. Vous pouvez tester un maximum de 15 groupes de nœuds sur une période continue de 24 heures.
L'exemple suivant utilise le AWS CLI pour tester le basculement automatique sur le groupe `redis00-0003` de nœuds du cluster Valkey ou Redis OSS (mode cluster activé). `redis00`
**Example Test du basculement automatique**
Pour Linux, macOS ou Unix :
```
aws elasticache test-failover \
--replication-group-id redis00 \
--node-group-id redis00-0003
```
Pour Windows :
```
aws elasticache test-failover ^
--replication-group-id redis00 ^
--node-group-id redis00-0003
```
Le résultat de la commande précédente doit ressembler à ce qui suit.
```
{
"ReplicationGroup": {
"Status": "available",
"Description": "1 shard, 3 nodes (1 + 2 replicas)",
"NodeGroups": [
{
"Status": "available",
"NodeGroupMembers": [
{
"CurrentRole": "primary",
"PreferredAvailabilityZone": "us-west-2c",
"CacheNodeId": "0001",
"ReadEndpoint": {
"Port": 6379,
"Address": "redis1x3-001.7ekv3t.0001.usw2.cache.amazonaws.com"
},
"CacheClusterId": "redis1x3-001"
},
{
"CurrentRole": "replica",
"PreferredAvailabilityZone": "us-west-2a",
"CacheNodeId": "0001",
"ReadEndpoint": {
"Port": 6379,
"Address": "redis1x3-002.7ekv3t.0001.usw2.cache.amazonaws.com"
},
"CacheClusterId": "redis1x3-002"
},
{
"CurrentRole": "replica",
"PreferredAvailabilityZone": "us-west-2b",
"CacheNodeId": "0001",
"ReadEndpoint": {
"Port": 6379,
"Address": "redis1x3-003.7ekv3t.0001.usw2.cache.amazonaws.com"
},
"CacheClusterId": "redis1x3-003"
}
],
"NodeGroupId": "0001",
"PrimaryEndpoint": {
"Port": 6379,
"Address": "redis1x3.7ekv3t.ng.0001.usw2.cache.amazonaws.com"
}
}
],
"ClusterEnabled": false,
"ReplicationGroupId": "redis1x3",
"SnapshotRetentionLimit": 1,
"AutomaticFailover": "enabled",
"MultiAZ": "enabled",
"SnapshotWindow": "11:30-12:30",
"SnapshottingClusterId": "redis1x3-002",
"MemberClusters": [
"redis1x3-001",
"redis1x3-002",
"redis1x3-003"
],
"CacheNodeType": "cache.m3.medium",
"DataTiering": "disabled",
"PendingModifiedValues": {}
}
}
```
Pour suivre la progression de votre basculement, utilisez l' AWS CLI `describe-events`opération.
Pour plus d'informations, veuillez consulter les ressources suivantes :
+ [test-failover](https://docs.aws.amazon.com/cli/latest/reference/elasticache/test-failover.html) dans la *Référence des commandes de l'AWS CLI *.
+ [describe-events](https://docs.aws.amazon.com/cli/latest/reference/elasticache/describe-events.html) dans la *Référence des commandes de l'AWS CLI *.
### Test du basculement automatique à l'aide de l'API ElastiCache
Vous pouvez tester le basculement automatique sur n'importe quel cluster activé avec Multi-AZ à l'aide de l'opération ElastiCache API. `TestFailover`
**Paramètres**
+ `ReplicationGroupId` : obligatoire. Groupe de réplication (sur la console, le cluster) qui va être testé.
+ `NodeGroupId` : obligatoire. Nom du groupe de nœuds sur lequel vous souhaitez tester le basculement automatique. Vous pouvez tester un maximum de 15 groupes de nœuds sur une période continue de 24 heures.
L'exemple suivant teste le basculement automatique sur le groupe de nœuds `redis00-0003` dans le groupe de réplication (sur la console, cluster) `redis00`.
**Example Test du basculement automatique**
```
https://elasticache.us-west-2.amazonaws.com/
?Action=TestFailover
&NodeGroupId=redis00-0003
&ReplicationGroupId=redis00
&Version=2015-02-02
&SignatureVersion=4
&SignatureMethod=HmacSHA256
&Timestamp=20140401T192317Z
&X-Amz-Credential=
```
Pour suivre la progression de votre basculement, utilisez l'opération ElastiCache `DescribeEvents` API.
Pour plus d’informations, consultez les ressources suivantes :
+ [TestFailover](https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_TestFailover.html)dans la *référence de ElastiCache l'API*
+ [DescribeEvents](https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_DescribeEvents.html)dans la *référence de ElastiCache l'API*
## Limitations relatives à la technologie Multi-AZ
Tenez compte des limites suivantes pour le Multi-AZ :
+ Le multi-AZ est pris en charge sur Valkey et sur Redis OSS version 2.8.6 et versions ultérieures.
+ Le multi-AZ n'est pas pris en charge sur les types de nœuds T1.
+ La réplication Valkey et Redis OSS est asynchrone. Par conséquent, lorsqu'un nœud principal bascule vers un réplica, une petite quantité de données peut être perdue en raison d'un décalage de réplication.
Lorsque vous choisissez le réplica à promouvoir au niveau principal, ElastiCache choisissez le réplica présentant le moins de retard de réplication. En d'autres termes, il choisit le réplica le plus à jour. Cela permet de réduire la quantité de données perdues. Le réplica dont le décalage de réplication est le moins important peut se trouver dans la même zone de disponibilité que le nœud principal défaillant ou dans une zone de disponibilité différente.
+ Lorsque vous promouvez manuellement des répliques en lecture au statut principal sur des clusters Valkey ou Redis OSS avec le mode cluster désactivé, vous ne pouvez le faire que lorsque le mode multi-AZ et le basculement automatique sont désactivés. Pour promouvoir un réplica en lecture en réplica principal, procédez comme suit :
1. Désactivez Multi-AZ sur le cluster.
1. Désactivez le basculement automatique sur le cluster. Vous pouvez le faire via la console en décochant la case **Auto failover** pour le groupe de réplication. Vous pouvez également le faire en AWS CLI définissant la `AutomaticFailoverEnabled` propriété sur `false` lorsque vous appelez l'`ModifyReplicationGroup`opération.
1. Promouvez le réplica en lecture en réplica principal.
1. Réactivez Multi-AZ.
+ ElastiCache pour Redis OSS Multi-AZ et fichier d'ajout uniquement (AOF) s'excluent mutuellement. Si vous en activez une, vous ne pouvez pas activer l'autre.
+ La défaillance d'un nœud peut être provoquée par une improbable panne générale de la zone de disponibilité. Dans ce cas, le réplica remplaçant le réplica principal ayant échoué n'est créé que si la zone de disponibilité est rétablie. Par exemple, imaginons un groupe de réplication avec le principal dans AZ-a et des réplicas dans AZ-b et AZ-c. En cas de défaillance du principal, le réplica ayant le moindre décalage de réplication sera promu au rang de cluster principal. ElastiCache Crée ensuite une nouvelle réplique dans AZ-a (où se trouvait le principal défaillant) uniquement lorsque AZ-a est de nouveau disponible.
+ Un redémarrage lancé par le client d'un principal n'entraîne de basculement automatique. D'autres redémarrages et défaillances déclenchent un basculement automatique.
+ Lorsque le principal est redémarré, ses données sont effacées dès qu'il est à nouveau en ligne. Lorsque les réplicas en lecture voient le cluster principal effacé, ils effacent leur copie de données, ce qui entraîne une perte des données.
+ Une fois qu'un réplica en lecture a été promu, les autres réplicas se synchronisent avec le nouveau principal. Après la synchronisation initiale, le contenu des réplicas est supprimé et ils synchronisent les données du nouveau principal. Ce processus de synchronisation provoque une brève interruption, au cours de laquelle les réplicas ne sont pas accessibles. Le processus de synchronisation entraîne également une augmentation de la charge temporaire sur le cluster principal lors de la synchronisation avec les réplicas. Ce comportement est propre à Valkey et Redis OSS et n'est pas propre à ElastiCache Multi-AZ. Pour plus de détails sur ce comportement, consultez la section [Réplication](http://valkey.io/topics/replication) sur le site Web de Valkey.
**Important**
Pour Valkey 7.2.6 et versions ultérieures ou Redis OSS version 2.8.22 et versions ultérieures, vous ne pouvez pas créer de répliques externes.
Pour les versions de Redis OSS antérieures à 2.8.22, nous vous recommandons de ne pas connecter de réplique externe à un ElastiCache cluster compatible avec le mode multi-AZ. Cette configuration non prise en charge peut créer des problèmes qui ElastiCache empêchent d'effectuer correctement le basculement et la restauration. Pour connecter une réplique externe à un ElastiCache cluster, assurez-vous que le mode Multi-AZ n'est pas activé avant d'établir la connexion.
# Implémentation de la sauvegarde et de la synchronisation
Toutes les versions prises en charge de Valkey et Redis OSS prennent en charge la sauvegarde et la synchronisation entre le nœud principal et le nœud de réplication. Cependant, la manière dont la sauvegarde et la synchronisation sont mises en œuvre varie en fonction de la version.
## Redis OSS version 2.8.22 et versions ultérieures
La réplication Redis OSS, dans les versions 2.8.22 et ultérieures, permet de choisir entre deux méthodes. Pour plus d’informations, consultez [Versions de Redis OSS antérieures à 2.8.22](#Replication.Redis.Earlier2-8-22) et [Instantané et restauration](backups.md).
Au cours d'un processus sans fonction fork, si les charges d'écriture sont élevées, les écritures sur le cluster sont retardées pour éviter d'accumuler trop de changements et de mettre en échec la création de l'instantané.
## Versions de Redis OSS antérieures à 2.8.22
La sauvegarde et la synchronisation de Redis OSS dans les versions antérieures à la version 2.8.22 sont un processus en trois étapes.
1. Appliquez la fonction fork et, dans le processus d'arrière-plan, sérialisez les données de cluster sur le disque. Cela crée un point-in-time instantané.
1. Au premier plan, créez un journal des modifications dans la *mémoire tampon de sortie du client*.
**Important**
Si le journal des modifications dépasse la taille de la *mémoire tampon de sortie du client*, la sauvegarde ou la synchronisation échoue. Pour de plus amples informations, veuillez consulter [S'assurer que vous disposez de suffisamment de mémoire pour créer un instantané Valkey ou Redis OSS](BestPractices.BGSAVE.md).
1. Enfin, transmettez les données de cache, puis le journal des modifications au nœud réplica.
# Création d'un groupe de réplication Valkey ou Redis OSS
Vous disposez des options suivantes pour créer un cluster avec des nœuds de réplica. L'une s'applique lorsque vous disposez déjà d'un cluster Valkey ou Redis OSS (mode cluster désactivé) disponible qui n'est associé à aucun cluster contenant des répliques à utiliser comme nœud principal. L'autre s'applique lorsque vous avez besoin de créer un nœud principal avec les réplicas de cluster et en lecture. Actuellement, un cluster Valkey ou Redis OSS (mode cluster activé) doit être créé à partir de zéro.
**Option 1 :[Création d'un groupe de réplication à l'aide d'un cluster existant](Replication.CreatingReplGroup.ExistingCluster.md)**
Utilisez cette option pour tirer parti d'un cluster Valkey ou Redis OSS à nœud unique existant (mode cluster désactivé). Vous spécifiez ce nœud existant en tant que nœud primaire dans le nouveau cluster, puis ajoutez individuellement de 1 à 5 réplicas en lecture au cluster. Si le cluster existant est actif, les réplicas en lecture se synchronisent avec lui au fur et à mesure de leur création. Consultez [Création d'un groupe de réplication à l'aide d'un cluster existant](Replication.CreatingReplGroup.ExistingCluster.md).
Vous ne pouvez pas créer de cluster Valkey ou Redis OSS (mode cluster activé) en utilisant un cluster existant. Pour créer un cluster Valkey ou Redis OSS (mode cluster activé) (API/CLI : groupe de réplication) à l'aide de la ElastiCache console, consultez. [Création d'un cluster Valkey ou Redis OSS (mode cluster activé) (console)](Clusters.Create.md#Clusters.Create.CON.RedisCluster)
**Option 2 :[Création d'un groupe de réplication Valkey ou Redis OSS à partir de zéro](Replication.CreatingReplGroup.NoExistingCluster.md)**
Utilisez cette option si vous ne disposez pas encore d'un cluster Valkey ou Redis OSS (mode cluster désactivé) disponible à utiliser comme nœud principal du cluster, ou si vous souhaitez créer un cluster Valkey ou Redis OSS (mode cluster activé). Consultez [Création d'un groupe de réplication Valkey ou Redis OSS à partir de zéro](Replication.CreatingReplGroup.NoExistingCluster.md).
# Création d'un groupe de réplication à l'aide d'un cluster existant
La procédure suivante ajoute un groupe de réplication à votre cluster à nœud unique Valkey ou Redis OSS (mode cluster désactivé), ce qui est nécessaire pour mettre à niveau votre cluster vers la dernière version de Valkey. Il s'agit d'une procédure sur place qui n'implique aucun temps d'arrêt ni aucune perte de données. Lorsque vous créez un groupe de réplication pour votre cluster à nœud unique, le nœud du cluster devient le nœud principal du nouveau cluster. Si vous ne disposez pas d'un cluster Valkey ou Redis OSS (mode cluster désactivé) que vous pouvez utiliser comme cluster principal du nouveau cluster, consultez. [Création d'un groupe de réplication Valkey ou Redis OSS à partir de zéro](Replication.CreatingReplGroup.NoExistingCluster.md)
Un cluster disponible est un cluster Valkey ou Redis OSS à nœud unique existant. Actuellement, Valkey ou Redis OSS (mode cluster activé) ne prennent pas en charge la création d'un cluster avec des répliques à l'aide d'un cluster à nœud unique disponible. Si vous souhaitez créer un cluster Valkey ou Redis OSS (mode cluster activé), consultez. [Création d'un cluster Valkey ou Redis OSS (mode cluster activé) (console)](Replication.CreatingReplGroup.NoExistingCluster.Cluster.md#Replication.CreatingReplGroup.NoExistingCluster.Cluster.CON)
## Création d'un groupe de réplication à l'aide d'un cluster existant (console)
Consultez la rubrique [À l'aide du ElastiCache AWS Management Console](Clusters.AddNode.md#Clusters.AddNode.CON).
## Création d'un groupe de réplication à l'aide d'un cluster Valkey ou Redis OSS disponible ()AWS CLI
La création d'un groupe de réplication avec des répliques de lecture se fait en deux étapes lorsque vous utilisez un cluster de cache Valkey ou Redis OSS disponible pour le serveur principal lorsque vous utilisez le.AWS CLI
Lorsque vous utilisez le,AWS CLI vous créez un groupe de réplication en spécifiant le nœud autonome disponible comme nœud principal du cluster, `--primary-cluster-id` ainsi que le nombre de nœuds que vous souhaitez dans le cluster à l'aide de la commande CLI,`create-replication-group`. Incluez les paramètres suivants.
**--replication-group-id**
Le nom du groupe de réplication que vous créez. La valeur de ce paramètre sert de base pour les noms des nœuds ajoutés avec une séquence de 3 chiffres ajoutés à la fin du `--replication-group-id`. Par exemple, `sample-repl-group-001`.
Les contraintes de dénomination des groupes de réplication Valkey ou Redis OSS (mode cluster désactivé) sont les suivantes :
+ Doit contenir entre 1 et 40 caractères alphanumériques ou traits d'union.
+ Doit commencer par une lettre.
+ Ils ne peuvent pas comporter deux traits d'union consécutifs.
+ Ils ne peuvent pas se terminer par un trait d'union.
**--replication-group-description**
Description du groupe de réplication.
**--num-node-groups**
Nombre de nœuds que vous souhaitez dans ce cluster. Cette valeur inclut le nœud principal. Ce paramètre a une valeur maximale de six.
**--primary-cluster-id**
Nom du nœud du cluster Valkey ou Redis OSS (mode cluster désactivé) disponible dont vous souhaitez faire le nœud principal de ce groupe de réplication.
La commande suivante crée le groupe de réplication `sample-repl-group` en utilisant le cluster Valkey ou Redis OSS (mode cluster désactivé) disponible `redis01` comme nœud principal du groupe de réplication. Cela crée 2 nœuds qui sont des réplicas en lecture seule. Les paramètres de `redis01` (c'est-à-dire, le groupe de paramètres, le groupe de sécurité, le type de nœud, la version du moteur, etc.) seront appliqués à tous les nœuds du groupe de réplication.
Pour Linux, macOS ou Unix :
```
aws elasticache create-replication-group \
--replication-group-id sample-repl-group \
--replication-group-description "demo cluster with replicas" \
--num-cache-clusters 3 \
--primary-cluster-id redis01
```
Pour Windows :
```
aws elasticache create-replication-group ^
--replication-group-id sample-repl-group ^
--replication-group-description "demo cluster with replicas" ^
--num-cache-clusters 3 ^
--primary-cluster-id redis01
```
Pour plus d'informations et de paramètres que vous pourriez vouloir utiliser, consultez la AWS CLI rubrique[create-replication-group](https://docs.aws.amazon.com/cli/latest/reference/elasticache/create-replication-group.html).
**Ajoutez ensuite des réplicas en lecture à ce groupe de réplication.**
Après la création du groupe de réplication, ajoutez au groupe de un à cinq réplicas en lecture à l'aide de la commande `create-cache-cluster`, sans oublier de définir les paramètres suivants.
**--cache-cluster-id**
Le nom du cluster que vous ajoutez au groupe de réplication.
Les contraintes d'attribution de noms de cluster sont les suivantes :
+ Doit contenir entre 1 et 40 caractères alphanumériques ou traits d'union.
+ Doit commencer par une lettre.
+ Ils ne peuvent pas comporter deux traits d'union consécutifs.
+ Ils ne peuvent pas se terminer par un trait d'union.
**--replication-group-id**
Nom du groupe de réplication auquel vous ajoutez ce cluster.
Répétez cette commande pour chaque réplica en lecture que vous souhaitez ajouter au groupe de réplication, en modifiant seulement du paramètre `--cache-cluster-id`.
**Note**
Rappelez-vous qu'un groupe de réplication ne peut pas avoir plus de cinq réplicas en lecture. Si vous essayez d'ajouter un réplica en lecture à un groupe de réplication qui en contient déjà cinq, l'opération échoue.
Le code suivant ajoute le réplica en lecture `my-replica01` au groupe de réplication `sample-repl-group`. Les paramètres du cluster principal (groupe de paramètres, groupe de sécurité, type de nœud, etc.) seront appliqués aux nœuds à mesure qu'ils sont ajoutés au groupe de réplication.
Pour Linux, macOS ou Unix :
```
aws elasticache create-cache-cluster \
--cache-cluster-id my-replica01 \
--replication-group-id sample-repl-group
```
Pour Windows :
```
aws elasticache create-cache-cluster ^
--cache-cluster-id my-replica01 ^
--replication-group-id sample-repl-group
```
Le résultat de cette commande doit être semblable à ce qui suit.
```
{
"ReplicationGroup": {
"Status": "creating",
"Description": "demo cluster with replicas",
"ClusterEnabled": false,
"ReplicationGroupId": "sample-repl-group",
"SnapshotRetentionLimit": 1,
"AutomaticFailover": "disabled",
"SnapshotWindow": "00:00-01:00",
"SnapshottingClusterId": "redis01",
"MemberClusters": [
"sample-repl-group-001",
"sample-repl-group-002",
"redis01"
],
"CacheNodeType": "cache.m4.large",
"DataTiering": "disabled",
"PendingModifiedValues": {}
}
}
```
Pour plus d'informations, consultez les AWS CLI rubriques suivantes :
+ [create-replication-group](https://docs.aws.amazon.com/cli/latest/reference/elasticache/create-replication-group.html)
+ [modify-replication-group](https://docs.aws.amazon.com/cli/latest/reference/elasticache/modify-replication-group.html)
## Ajouter des répliques à un cluster (API) autonome Valkey ou Redis OSS (mode cluster désactivé) ElastiCache
Lorsque vous utilisez l' ElastiCache API, vous créez un groupe de réplication en spécifiant le nœud autonome disponible en tant que nœud principal du cluster, `PrimaryClusterId` ainsi que le nombre de nœuds que vous souhaitez inclure dans le cluster à l'aide de la commande CLI,`CreateReplicationGroup`. Incluez les paramètres suivants.
**ReplicationGroupId**
Le nom du groupe de réplication que vous créez. La valeur de ce paramètre sert de base pour les noms des nœuds ajoutés avec une séquence de 3 chiffres ajoutés à la fin du `ReplicationGroupId`. Par exemple, `sample-repl-group-001`.
Les contraintes de dénomination des groupes de réplication Valkey ou Redis OSS (mode cluster désactivé) sont les suivantes :
+ Doit contenir entre 1 et 40 caractères alphanumériques ou traits d'union.
+ Doit commencer par une lettre.
+ Ils ne peuvent pas comporter deux traits d'union consécutifs.
+ Ils ne peuvent pas se terminer par un trait d'union.
**ReplicationGroupDescription**
Description du cluster avec réplicas.
**NumCacheClusters**
Nombre de nœuds que vous souhaitez dans ce cluster. Cette valeur inclut le nœud principal. Ce paramètre a une valeur maximale de six.
**PrimaryClusterId**
Le nom du cluster Valkey ou Redis OSS disponible (mode cluster désactivé) dont vous souhaitez faire le nœud principal de ce cluster.
La commande suivante crée le cluster avec des répliques `sample-repl-group` en utilisant le cluster Valkey ou Redis OSS (mode cluster désactivé) disponible `redis01` comme nœud principal du groupe de réplication. Cela crée 2 nœuds qui sont des réplicas en lecture seule. Les paramètres de `redis01` (c'est-à-dire, le groupe de paramètres, le groupe de sécurité, le type de nœud, la version du moteur, etc.) seront appliqués à tous les nœuds du groupe de réplication.
```
https://elasticache.us-west-2.amazonaws.com/
?Action=CreateReplicationGroup
&Engine=redis
&EngineVersion=6.0
&ReplicationGroupDescription=Demo%20cluster%20with%20replicas
&ReplicationGroupId=sample-repl-group
&PrimaryClusterId=redis01
&Version=2015-02-02
&SignatureVersion=4
&SignatureMethod=HmacSHA256
&Timestamp=20150202T192317Z
&X-Amz-Credential=
```
Pour plus d'informations, consultez les rubriques relatives aux ElastiCache APL :
+ [CreateReplicationGroup](https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_CreateReplicationGroup.html)
+ [ModifyReplicationGroup](https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_ModifyReplicationGroup.html)
**Ajoutez ensuite des réplicas en lecture à ce groupe de réplication.**
Après la création du groupe de réplication, ajoutez au groupe de un à cinq réplicas en lecture en utilisant l'opération `CreateCacheCluster`, sans oublier de définir les paramètres ci-dessous.
**CacheClusterId**
Le nom du cluster que vous ajoutez au groupe de réplication.
Les contraintes d'attribution de noms de cluster sont les suivantes :
+ Doit contenir entre 1 et 40 caractères alphanumériques ou traits d'union.
+ Doit commencer par une lettre.
+ Ils ne peuvent pas comporter deux traits d'union consécutifs.
+ Ils ne peuvent pas se terminer par un trait d'union.
**ReplicationGroupId**
Nom du groupe de réplication auquel vous ajoutez ce cluster.
Répétez cette opération pour chaque réplica en lecture que vous souhaitez ajouter au groupe de réplication, en modifiant seulement la valeur du paramètre `CacheClusterId`.
Le code suivant ajouter le réplica en lecture `myReplica01` au groupe de réplication `myReplGroup`. Les paramètres du cluster principal (groupe de paramètres, groupe de sécurité, type de nœud, etc.) seront appliqués aux nœuds à mesure qu'ils sont ajoutés au groupe de réplication.
```
https://elasticache.us-west-2.amazonaws.com/
?Action=CreateCacheCluster
&CacheClusterId=myReplica01
&ReplicationGroupId=myReplGroup
&SignatureMethod=HmacSHA256
&SignatureVersion=4
&Version=2015-02-02
&X-Amz-Algorithm=&AWS;4-HMAC-SHA256
&X-Amz-Credential=[your-access-key-id]/20150202/us-west-2/elasticache/aws4_request
&X-Amz-Date=20150202T170651Z
&X-Amz-SignedHeaders=content-type;host;user-agent;x-amz-content-sha256;x-amz-date
&X-Amz-Signature=[signature-value]
```
Pour plus d'informations et de paramètres que vous souhaiterez peut-être utiliser, consultez la rubrique ElastiCache API[CreateCacheCluster](https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_CreateCacheCluster.html).
# Création d'un groupe de réplication Valkey ou Redis OSS à partir de zéro
Vous trouverez ci-dessous comment créer un groupe de réplication Valkey ou Redis OSS sans utiliser un cluster Valkey ou Redis OSS existant comme principal. Vous pouvez créer un groupe de réplication Valkey ou Redis OSS (mode cluster désactivé) ou Valkey ou Redis OSS (mode cluster activé) à partir de zéro à l'aide de la ElastiCache console, de l'API ou de l'API AWS CLI. ElastiCache
Avant de continuer, décidez si vous souhaitez créer un groupe de réplication Valkey ou Redis OSS (mode cluster désactivé) ou un groupe de réplication Valkey ou Redis OSS (mode cluster activé). Pour vous aider à faire votre choix, consultez [Réplication : mode cluster Valkey et Redis OSS désactivé ou activé](Replication.Redis-RedisCluster.md).
**Topics**
+ [Création d'un groupe de réplication Valkey ou Redis OSS (mode cluster désactivé) à partir de zéro](Replication.CreatingReplGroup.NoExistingCluster.Classic.md)
+ [Création d'un groupe de réplication dans Valkey ou Redis OSS (mode cluster activé) à partir de zéro](Replication.CreatingReplGroup.NoExistingCluster.Cluster.md)
# Création d'un groupe de réplication Valkey ou Redis OSS (mode cluster désactivé) à partir de zéro
Vous pouvez créer un groupe de réplication Valkey ou Redis OSS (mode cluster désactivé) à partir de zéro à l'aide de la ElastiCache console, de l' AWS CLI API ou de l' ElastiCache API. Un groupe de réplication Valkey ou Redis OSS (mode cluster désactivé) possède toujours un groupe de nœuds, un cluster principal et jusqu'à cinq répliques de lecture. Les groupes de réplication Valkey ou Redis OSS (mode cluster désactivé) ne prennent pas en charge le partitionnement de vos données.
**Note**
La node/shard limite peut être augmentée jusqu'à un maximum de 500 par cluster. Pour demander une augmentation de la limite, veuillez consulter [AWS Service Limits](https://docs.aws.amazon.com/general/latest/gr/aws_service_limits.html) et indiquez le type d'instance dans la demande.
Pour créer un groupe de réplication Valkey ou Redis OSS (mode cluster désactivé) à partir de zéro, adoptez l'une des approches suivantes :
## Création d'un groupe de réplication Valkey ou Redis OSS (mode cluster désactivé) à partir de zéro ()AWS CLI
La procédure suivante crée un groupe de réplication Valkey ou Redis OSS (mode cluster désactivé) à l'aide du. AWS CLI
Lorsque vous créez un groupe de réplication Valkey ou Redis OSS (mode cluster désactivé) à partir de zéro, vous créez le groupe de réplication et tous ses nœuds en un seul appel à la AWS CLI `create-replication-group` commande. Incluez les paramètres suivants.
**--replication-group-id**
Le nom du groupe de réplication que vous créez.
Les contraintes de dénomination des groupes de réplication Valkey ou Redis OSS (mode cluster désactivé) sont les suivantes :
+ Doit contenir entre 1 et 40 caractères alphanumériques ou traits d'union.
+ Doit commencer par une lettre.
+ Ils ne peuvent pas comporter deux traits d'union consécutifs.
+ Ils ne peuvent pas se terminer par un trait d'union.
**--replication-group-description**
Description du groupe de réplication.
**--num-cache-clusters**
Le nombre de nœuds que vous souhaitez créer avec ce groupe de réplication, réplica principal et réplicas en lecture combinés.
Si vous activez Multi-AZ (`--automatic-failover-enabled`), la valeur de `--num-cache-clusters` doit être au moins 2.
**--cache-node-type**
Le type de nœud pour chaque nœud dans le groupe de réplication.
ElastiCache prend en charge les types de nœuds suivants. En général, les types de la génération actuelle offrent davantage de mémoire et de puissance de calcul pour un coût inférieur, par rapport à leurs homologues équivalents de la génération précédente.
Pour plus d'informations sur les performances de chaque type de nœud, consultez [Amazon EC2 Instance Types](https://aws.amazon.com/ec2/instance-types/).
**--data-tiering-enabled**
Définissez ce paramètre si vous utilisez un type de nœud r6gd. Si vous ne souhaitez pas effectuer de hiérarchisation des données, définissez `--no-data-tiering-enabled`. Pour de plus amples informations, veuillez consulter [Hiérarchisation des données ElastiCache](data-tiering.md).
**--cache-parameter-group**
Spécifiez un groupe de paramètres qui correspond à la version de votre moteur. Si vous exécutez Redis OSS 3.2.4 ou version ultérieure, spécifiez le groupe de `default.redis3.2` paramètres ou un groupe de paramètres dérivé `default.redis3.2` pour créer un groupe de réplication Valkey ou Redis OSS (mode cluster désactivé). Pour de plus amples informations, veuillez consulter [Paramètres OSS Valkey et Redis](ParameterGroups.Engine.md#ParameterGroups.Redis).
**--network-type**
`ipv4`, `ipv6` ou `dual-stack`. Si vous choisissez la double pile, vous devez définir le paramètre `--IpDiscovery` sur `ipv4` ou `ipv6`.
**--engine**
redis
**--engine-version**
Pour bénéficier de l'ensemble des fonctionnalités, choisissez la dernière version du moteur.
Les noms des nœuds dériveront du nom du groupe de réplication en ajoutant le suffixe `-00`*\$1* au nom du groupe de réplication. Par exemple, en utilisant le nom de groupe de réplication `myReplGroup`, le nom du nœud principal sera `myReplGroup-001` et pour les réplicas en lecture de `myReplGroup-002` jusqu'à `myReplGroup-006`.
Si vous souhaitez activer le chiffrement en transit ou au repos sur ce groupe de réplication, ajoutez l'un ou l'autre ou les deux paramètres `--transit-encryption-enabled` ou `--at-rest-encryption-enabled` et remplissez les conditions suivantes.
+ Votre groupe de réplication doit exécuter Redis OSS version 3.2.6 ou 4.0.10.
+ Le groupe de réplication doit être créé dans un Amazon VPC.
+ Vous devez également inclure le paramètre `--cache-subnet-group`.
+ Vous devez également inclure le paramètre `--auth-token` avec la valeur de chaîne à client spécifié pour votre jeton AUTH (mot de passe) nécessaire à la réalisation des opérations sur ce groupe de réplication.
L'opération suivante crée un groupe de réplication Valkey ou Redis OSS (mode cluster désactivé) `sample-repl-group` avec trois nœuds, un nœud principal et deux répliques.
Pour Linux, macOS ou Unix :
```
aws elasticache create-replication-group \
--replication-group-id sample-repl-group \
--replication-group-description "Demo cluster with replicas" \
--num-cache-clusters 3 \
--cache-node-type cache.m4.large \
--engine redis
```
Pour Windows :
```
aws elasticache create-replication-group ^
--replication-group-id sample-repl-group ^
--replication-group-description "Demo cluster with replicas" ^
--num-cache-clusters 3 ^
--cache-node-type cache.m4.large ^
--engine redis
```
Le résultat de la commande ressemble à ceci.
```
{
"ReplicationGroup": {
"Status": "creating",
"Description": "Demo cluster with replicas",
"ClusterEnabled": false,
"ReplicationGroupId": "sample-repl-group",
"SnapshotRetentionLimit": 0,
"AutomaticFailover": "disabled",
"SnapshotWindow": "01:30-02:30",
"MemberClusters": [
"sample-repl-group-001",
"sample-repl-group-002",
"sample-repl-group-003"
],
"CacheNodeType": "cache.m4.large",
"DataTiering": "disabled",
"PendingModifiedValues": {}
}
}
```
Pour plus d'informations et de paramètres que vous pourriez vouloir utiliser, consultez la AWS CLI rubrique [create-replication-group](https://docs.aws.amazon.com/cli/latest/reference/elasticache/create-replication-group.html).
## Création d'un groupe de réplication Valkey ou Redis OSS (mode cluster désactivé) à partir de zéro (ElastiCache API)
La procédure suivante crée un groupe de réplication Valkey ou Redis OSS (mode cluster désactivé) à l'aide de l' ElastiCache API.
Lorsque vous créez un groupe de réplication Valkey ou Redis OSS (mode cluster désactivé) à partir de zéro, vous créez le groupe de réplication et tous ses nœuds en un seul appel à l'opération d' ElastiCache API`CreateReplicationGroup`. Incluez les paramètres suivants.
**ReplicationGroupId**
Le nom du groupe de réplication que vous créez.
Les contraintes de dénomination des groupes de réplication Valkey ou Redis OSS (mode cluster activé) sont les suivantes :
+ Doit contenir entre 1 et 40 caractères alphanumériques ou traits d'union.
+ Doit commencer par une lettre.
+ Ils ne peuvent pas comporter deux traits d'union consécutifs.
+ Ils ne peuvent pas se terminer par un trait d'union.
**ReplicationGroupDescription**
La description de votre groupe de sécurité.
**NumCacheClusters**
Le nombre total de nœuds que vous souhaitez créer avec ce groupe de réplication, réplica principal et réplicas en lecture combinés.
Si vous activez Multi-AZ (`AutomaticFailoverEnabled=true`), la valeur de `NumCacheClusters` doit être au moins 2.
**CacheNodeType**
Le type de nœud pour chaque nœud dans le groupe de réplication.
ElastiCache prend en charge les types de nœuds suivants. En général, les types de la génération actuelle offrent davantage de mémoire et de puissance de calcul pour un coût inférieur, par rapport à leurs homologues équivalents de la génération précédente.
Pour plus d'informations sur les performances de chaque type de nœud, consultez [Amazon EC2 Instance Types](https://aws.amazon.com/ec2/instance-types/).
**--data-tiering-enabled**
Définissez ce paramètre si vous utilisez un type de nœud r6gd. Si vous ne souhaitez pas effectuer de hiérarchisation des données, définissez `--no-data-tiering-enabled`. Pour de plus amples informations, veuillez consulter [Hiérarchisation des données ElastiCache](data-tiering.md).
**CacheParameterGroup**
Spécifiez un groupe de paramètres qui correspond à la version de votre moteur. Si vous exécutez Redis OSS 3.2.4 ou version ultérieure, spécifiez le groupe de `default.redis3.2` paramètres ou un groupe de paramètres dérivé `default.redis3.2` pour créer un groupe de réplication Valkey ou Redis OSS (mode cluster désactivé). Pour de plus amples informations, veuillez consulter [Paramètres OSS Valkey et Redis](ParameterGroups.Engine.md#ParameterGroups.Redis).
**--network-type**
`ipv4`, `ipv` ou `dual-stack`. Si vous choisissez la double pile, vous devez définir le paramètre `--IpDiscovery` sur `ipv4` ou `ipv6`.
**Moteur**
redis
**EngineVersion**
6.0
Les noms des nœuds dériveront du nom du groupe de réplication en ajoutant le suffixe `-00`*\$1* au nom du groupe de réplication. Par exemple, en utilisant le nom de groupe de réplication `myReplGroup`, le nom du nœud principal sera `myReplGroup-001` et pour les réplicas en lecture de `myReplGroup-002` jusqu'à `myReplGroup-006`.
Si vous souhaitez activer le chiffrement en transit ou au repos sur ce groupe de réplication, ajoutez l'un ou l'autre ou les deux paramètres `TransitEncryptionEnabled=true` ou `AtRestEncryptionEnabled=true` et remplissez les conditions suivantes.
+ Votre groupe de réplication doit exécuter Redis OSS version 3.2.6 ou 4.0.10.
+ Le groupe de réplication doit être créé dans un Amazon VPC.
+ Vous devez également inclure le paramètre `CacheSubnetGroup`.
+ Vous devez également inclure le paramètre `AuthToken` avec la valeur de chaîne à client spécifié pour votre jeton AUTH (mot de passe) nécessaire à la réalisation des opérations sur ce groupe de réplication.
L'opération suivante crée le groupe de réplication Valkey ou Redis OSS (mode cluster désactivé) `myReplGroup` avec trois nœuds, un nœud principal et deux répliques.
```
https://elasticache.us-west-2.amazonaws.com/
?Action=CreateReplicationGroup
&CacheNodeType=cache.m4.large
&CacheParameterGroup=default.redis6.x
&Engine=redis
&EngineVersion=6.0
&NumCacheClusters=3
&ReplicationGroupDescription=test%20group
&ReplicationGroupId=myReplGroup
&Version=2015-02-02
&SignatureVersion=4
&SignatureMethod=HmacSHA256
&Timestamp=20150202T192317Z
&X-Amz-Credential=
```
Pour plus d'informations et de paramètres que vous souhaiterez peut-être utiliser, consultez la rubrique ElastiCache API[CreateReplicationGroup](https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_CreateReplicationGroup.html).
# Création d'un groupe de réplication dans Valkey ou Redis OSS (mode cluster activé) à partir de zéro
Vous pouvez créer un cluster Valkey ou Redis OSS (mode cluster activé) (API/CLI : *groupe de réplication*) à l'aide de la ElastiCache console, de l'API ou de l' AWS CLI API. ElastiCache Un groupe de réplication Valkey ou Redis OSS (mode cluster activé) comprend de 1 à 500 partitions (API/CLI : groupes de nœuds), un nœud principal dans chaque partition et jusqu'à 5 répliques de lecture dans chaque partition. Vous pouvez créer un cluster contenant un nombre de partitions supérieur et un nombre de réplicas inférieur, qui conduisent à un nombre total de 90 nœuds par cluster. Cette configuration de cluster peut contenir de 90 partitions avec 0 réplica à 15 partitions avec 5 réplicas, ce qui correspond au nombre maximal de réplicas autorisé.
La limite de nœuds ou de partitions peut être augmentée jusqu'à un maximum de 500 par cluster si la version du moteur Valkey ou Redis OSS est 5.0.6 ou supérieure. Par exemple, vous pouvez choisir de configurer un cluster de 500 nœuds compris entre 83 (un principal et 5 réplicas par partition) et 500 partitions (un principal et aucun réplicas). Assurez-vous qu’il y ait suffisamment d’adresses IP disponibles pour faire face à l’augmentation. Les pièges courants incluent les sous-réseaux du groupe de sous-réseaux avec une plage CIDR trop petite ou les sous-réseaux partagés et fortement utilisés par d’autres clusters. Pour de plus amples informations, veuillez consulter [Création d'un groupe de sous-réseaux](SubnetGroups.Creating.md).
Pour les versions antérieures à 5.0.6, la limite est de 250 par cluster.
Pour demander une augmentation de cette limite, veuillez consulter [AWS Service Limits](https://docs.aws.amazon.com/general/latest/gr/aws_service_limits.html) et sélectionnez le type de limite **Nœuds par cluster par type d'instance**.
**Topics**
+ [Utilisation de la ElastiCache console](#Replication.CreatingReplGroup.NoExistingCluster.Cluster.CON)
+ [Création d'un groupe de réplication Valkey ou Redis OSS (mode cluster activé) à partir de zéro ()AWS CLI](#Replication.CreatingReplGroup.NoExistingCluster.Cluster.CLI)
+ [Création d'un groupe de réplication dans Valkey ou Redis OSS (mode cluster activé) à partir de zéro (ElastiCache API)](#Replication.CreatingReplGroup.NoExistingCluster.Cluster.API)
## Création d'un cluster Valkey ou Redis OSS (mode cluster activé) (console)
Pour créer un cluster Valkey ou Redis OSS (mode cluster activé), consultez. [Création d'un cluster Valkey ou Redis OSS (mode cluster activé) (console)](Clusters.Create.md#Clusters.Create.CON.RedisCluster) Veillez à activer le mode de cluster, **Cluster Mode enabled (Scale Out)** et spécifiez au moins deux partitions et un nœud de réplica dans chaque.
## Création d'un groupe de réplication Valkey ou Redis OSS (mode cluster activé) à partir de zéro ()AWS CLI
La procédure suivante crée un groupe de réplication Valkey ou Redis OSS (mode cluster activé) à l'aide du. AWS CLI
Lorsque vous créez un groupe de réplication Valkey ou Redis OSS (mode cluster activé) à partir de zéro, vous créez le groupe de réplication et tous ses nœuds en un seul appel à la AWS CLI `create-replication-group` commande. Incluez les paramètres suivants.
**--replication-group-id**
Le nom du groupe de réplication que vous créez.
Les contraintes de dénomination des groupes de réplication Valkey ou Redis OSS (mode cluster activé) sont les suivantes :
+ Doit contenir entre 1 et 40 caractères alphanumériques ou traits d'union.
+ Doit commencer par une lettre.
+ Ils ne peuvent pas comporter deux traits d'union consécutifs.
+ Ils ne peuvent pas se terminer par un trait d'union.
**--replication-group-description**
Description du groupe de réplication.
**--cache-node-type**
Le type de nœud pour chaque nœud dans le groupe de réplication.
ElastiCache prend en charge les types de nœuds suivants. En général, les types de la génération actuelle offrent davantage de mémoire et de puissance de calcul pour un coût inférieur, par rapport à leurs homologues équivalents de la génération précédente.
Pour plus d'informations sur les performances de chaque type de nœud, consultez [Amazon EC2 Instance Types](https://aws.amazon.com/ec2/instance-types/).
**--data-tiering-enabled**
Définissez ce paramètre si vous utilisez un type de nœud r6gd. Si vous ne souhaitez pas effectuer de hiérarchisation des données, définissez `--no-data-tiering-enabled`. Pour de plus amples informations, veuillez consulter [Hiérarchisation des données ElastiCache](data-tiering.md).
**--cache-parameter-group**
Spécifiez le groupe de `default.redis6.x.cluster.on` paramètres ou un groupe de paramètres dérivé `default.redis6.x.cluster.on` pour créer un groupe de réplication Valkey ou Redis OSS (mode cluster activé). Pour de plus amples informations, veuillez consulter [Modifications des paramètres de Redis OSS 6.x](ParameterGroups.Engine.md#ParameterGroups.Redis.6-x).
**--engine**
redis
**--engine-version**
3.2.4
**--num-node-groups**
Le nombre de groupes de nœuds dans ce groupe de réplication. Valeurs valides : de 1 à 500.
La node/shard limite peut être augmentée jusqu'à un maximum de 500 par cluster. Pour demander une augmentation de cette limite, veuillez consulter [AWS Service Limit ](https://docs.aws.amazon.com/general/latest/gr/aws_service_limits.html) et choisissez le type de limite « Nœuds par cluster par type d'instance ».
**--replicas-per-node-group**
Le nombre de nœuds de réplica dans chaque groupe de nœuds. Les valeurs valides sont comprises entre 0 et 5.
**--network-type**
`ipv4`, `ipv` ou `dual-stack`. Si vous choisissez la double pile, vous devez définir le paramètre `--IpDiscovery` sur `ipv4` ou `ipv6`.
Si vous souhaitez activer le chiffrement en transit ou au repos sur ce groupe de réplication, ajoutez l'un ou l'autre ou les deux paramètres `--transit-encryption-enabled` ou `--at-rest-encryption-enabled` et remplissez les conditions suivantes.
+ Votre groupe de réplication doit exécuter Redis OSS version 3.2.6 ou 4.0.10.
+ Le groupe de réplication doit être créé dans un Amazon VPC.
+ Vous devez également inclure le paramètre `--cache-subnet-group`.
+ Vous devez également inclure le paramètre `--auth-token` avec la valeur de chaîne à client spécifié pour votre jeton AUTH (mot de passe) nécessaire à la réalisation des opérations sur ce groupe de réplication.
L'opération suivante crée le groupe de réplication Valkey ou Redis OSS (mode cluster activé) `sample-repl-group` avec trois nœuds groups/shards (--num-node-groups), chacun avec trois nœuds, un principal et deux répliques en lecture (--). replicas-per-node-group
Pour Linux, macOS ou Unix :
```
aws elasticache create-replication-group \
--replication-group-id sample-repl-group \
--replication-group-description "Demo cluster with replicas" \
--num-node-groups 3 \
--replicas-per-node-group 2 \
--cache-node-type cache.m4.large \
--engine redis \
--security-group-ids SECURITY_GROUP_ID \
--cache-subnet-group-name SUBNET_GROUP_NAME>
```
Pour Windows :
```
aws elasticache create-replication-group ^
--replication-group-id sample-repl-group ^
--replication-group-description "Demo cluster with replicas" ^
--num-node-groups 3 ^
--replicas-per-node-group 2 ^
--cache-node-type cache.m4.large ^
--engine redis ^
--security-group-ids SECURITY_GROUP_ID ^
--cache-subnet-group-name SUBNET_GROUP_NAME>
```
La commande précédente génère la sortie suivante.
```
{
"ReplicationGroup": {
"Status": "creating",
"Description": "Demo cluster with replicas",
"ReplicationGroupId": "sample-repl-group",
"SnapshotRetentionLimit": 0,
"AutomaticFailover": "enabled",
"SnapshotWindow": "05:30-06:30",
"MemberClusters": [
"sample-repl-group-0001-001",
"sample-repl-group-0001-002",
"sample-repl-group-0001-003",
"sample-repl-group-0002-001",
"sample-repl-group-0002-002",
"sample-repl-group-0002-003",
"sample-repl-group-0003-001",
"sample-repl-group-0003-002",
"sample-repl-group-0003-003"
],
"PendingModifiedValues": {}
}
}
```
Lorsque vous créez un groupe de réplication Valkey ou Redis OSS (mode cluster activé) à partir de zéro, vous pouvez configurer chaque partition du cluster à l'aide du `--node-group-configuration` paramètre illustré dans l'exemple suivant qui configure deux groupes de nœuds (console : partitions). La première partition comporte deux nœuds, un nœud principal et un réplica en lecture. La deuxième partition comporte trois nœuds, un nœud principal et deux réplicas en lecture.
**--node-group-configuration**
La configuration pour chaque groupe de nœuds. Le paramètre `--node-group-configuration` se compose des champs suivants.
+ `PrimaryAvailabilityZone` : la zone de disponibilité où se trouve le nœud primaire de ce groupe de nœuds. Si ce paramètre est omis, ElastiCache choisit la zone de disponibilité pour le nœud principal.
**Par exemple :** us-west-2a.
+ `ReplicaAvailabilityZones` : une liste séparée par des virgules des zones de disponibilité où se trouvent les réplicas en lecture. Le nombre de zones de disponibilité dans cette liste doit correspondre à la valeur `ReplicaCount`. Si ce paramètre est omis, ElastiCache choisit les zones de disponibilité pour les nœuds de réplication.
**Exemple :** « us-west-2a, us-west-2b, us-west-2c »
+ `ReplicaCount` – Le nombre de nœuds de réplica dans ce groupe de nœuds.
+ `Slots` : chaîne qui spécifie l'espace de clés pour le groupe de nœuds. La chaîne est au format `startKey-endKey`. Si ce paramètre est omis, les clés sont réparties ElastiCache de manière égale entre les groupes de nœuds.
**Exemple :** "0-4999"
L'opération suivante crée le groupe de réplication Valkey ou Redis OSS (mode cluster activé) `new-group` avec deux groupes/fragments de nœuds (). `--num-node-groups` À l'inverse de l'exemple précédent, chaque groupe de nœuds est configuré différemment de l'autre groupe de nœuds (`--node-group-configuration`).
Pour Linux, macOS ou Unix :
```
aws elasticache create-replication-group \
--replication-group-id new-group \
--replication-group-description "Sharded replication group" \
--engine redis \
--snapshot-retention-limit 8 \
--cache-node-type cache.m4.medium \
--num-node-groups 2 \
--node-group-configuration \
"ReplicaCount=1,Slots=0-8999,PrimaryAvailabilityZone='us-east-1c',ReplicaAvailabilityZones='us-east-1b'" \
"ReplicaCount=2,Slots=9000-16383,PrimaryAvailabilityZone='us-east-1a',ReplicaAvailabilityZones='us-east-1a','us-east-1c'"
```
Pour Windows :
```
aws elasticache create-replication-group ^
--replication-group-id new-group ^
--replication-group-description "Sharded replication group" ^
--engine redis ^
--snapshot-retention-limit 8 ^
--cache-node-type cache.m4.medium ^
--num-node-groups 2 ^
--node-group-configuration \
"ReplicaCount=1,Slots=0-8999,PrimaryAvailabilityZone='us-east-1c',ReplicaAvailabilityZones='us-east-1b'" \
"ReplicaCount=2,Slots=9000-16383,PrimaryAvailabilityZone='us-east-1a',ReplicaAvailabilityZones='us-east-1a','us-east-1c'"
```
L'opération précédente génère la sortie suivante.
```
{
"ReplicationGroup": {
"Status": "creating",
"Description": "Sharded replication group",
"ReplicationGroupId": "rc-rg",
"SnapshotRetentionLimit": 8,
"AutomaticFailover": "enabled",
"SnapshotWindow": "10:00-11:00",
"MemberClusters": [
"rc-rg-0001-001",
"rc-rg-0001-002",
"rc-rg-0002-001",
"rc-rg-0002-002",
"rc-rg-0002-003"
],
"PendingModifiedValues": {}
}
}
```
Pour plus d'informations et de paramètres que vous pourriez vouloir utiliser, consultez la AWS CLI rubrique[create-replication-group](https://docs.aws.amazon.com/cli/latest/reference/elasticache/create-replication-group.html).
## Création d'un groupe de réplication dans Valkey ou Redis OSS (mode cluster activé) à partir de zéro (ElastiCache API)
La procédure suivante crée un groupe de réplication Valkey ou Redis OSS (mode cluster activé) à l'aide de l' ElastiCache API.
Lorsque vous créez un groupe de réplication Valkey ou Redis OSS (mode cluster activé) à partir de zéro, vous créez le groupe de réplication et tous ses nœuds en un seul appel à l'opération d' ElastiCache API`CreateReplicationGroup`. Incluez les paramètres suivants.
**ReplicationGroupId**
Le nom du groupe de réplication que vous créez.
Les contraintes de dénomination des groupes de réplication Valkey ou Redis OSS (mode cluster activé) sont les suivantes :
+ Doit contenir entre 1 et 40 caractères alphanumériques ou traits d'union.
+ Doit commencer par une lettre.
+ Ils ne peuvent pas comporter deux traits d'union consécutifs.
+ Ils ne peuvent pas se terminer par un trait d'union.
**ReplicationGroupDescription**
Description du groupe de réplication.
**NumNodeGroups**
Le nombre de groupes de nœuds que vous souhaitez créer avec ce groupe de réplication. Valeurs valides : de 1 à 500.
**ReplicasPerNodeGroup**
Le nombre de nœuds de réplica dans chaque groupe de nœuds. Les valeurs valides sont comprises entre 1 et 5.
**NodeGroupConfiguration**
La configuration pour chaque groupe de nœuds. Le paramètre `NodeGroupConfiguration` se compose des champs suivants.
+ `PrimaryAvailabilityZone` : la zone de disponibilité où se trouve le nœud primaire de ce groupe de nœuds. Si ce paramètre est omis, ElastiCache choisit la zone de disponibilité pour le nœud principal.
**Par exemple :** us-west-2a.
+ `ReplicaAvailabilityZones` : une liste des zones de disponibilité dans lesquelles se trouvent les réplicas en lecture. Le nombre de zones de disponibilité dans cette liste doit correspondre à la valeur `ReplicaCount`. Si ce paramètre est omis, ElastiCache choisit les zones de disponibilité pour les nœuds de réplication.
+ `ReplicaCount` : le nombre de nœuds de réplica dans ce groupe de nœuds.
+ `Slots` : chaîne qui spécifie l'espace de clés pour le groupe de nœuds. La chaîne est au format `startKey-endKey`. Si ce paramètre est omis, les clés sont réparties ElastiCache de manière égale entre les groupes de nœuds.
**Exemple :** "0-4999"
**CacheNodeType**
Le type de nœud pour chaque nœud dans le groupe de réplication.
ElastiCache prend en charge les types de nœuds suivants. En général, les types de la génération actuelle offrent davantage de mémoire et de puissance de calcul pour un coût inférieur, par rapport à leurs homologues équivalents de la génération précédente.
Pour plus d'informations sur les performances de chaque type de nœud, consultez [Amazon EC2 Instance Types](https://aws.amazon.com/ec2/instance-types/).
**--data-tiering-enabled**
Définissez ce paramètre si vous utilisez un type de nœud r6gd. Si vous ne souhaitez pas effectuer de hiérarchisation des données, définissez `--no-data-tiering-enabled`. Pour de plus amples informations, veuillez consulter [Hiérarchisation des données ElastiCache](data-tiering.md).
**CacheParameterGroup**
Spécifiez le groupe de `default.redis6.x.cluster.on` paramètres ou un groupe de paramètres dérivé `default.redis6.x.cluster.on` pour créer un groupe de réplication Valkey ou Redis OSS (mode cluster activé). Pour de plus amples informations, veuillez consulter [Modifications des paramètres de Redis OSS 6.x](ParameterGroups.Engine.md#ParameterGroups.Redis.6-x).
**--network-type**
`ipv4`, `ipv` ou `dual-stack`. Si vous choisissez la double pile, vous devez définir le paramètre `--IpDiscovery` sur `ipv4` ou `ipv6`.
**Moteur**
redis
**EngineVersion**
6.0
Si vous souhaitez activer le chiffrement en transit ou au repos sur ce groupe de réplication, ajoutez l'un ou l'autre ou les deux paramètres `TransitEncryptionEnabled=true` ou `AtRestEncryptionEnabled=true` et remplissez les conditions suivantes.
+ Votre groupe de réplication doit exécuter Redis OSS version 3.2.6 ou 4.0.10.
+ Le groupe de réplication doit être créé dans un Amazon VPC.
+ Vous devez également inclure le paramètre `CacheSubnetGroup`.
+ Vous devez également inclure le paramètre `AuthToken` avec la valeur de chaîne à client spécifié pour votre jeton AUTH (mot de passe) nécessaire à la réalisation des opérations sur ce groupe de réplication.
Des sauts de ligne sont ajoutés pour faciliter la lecture.
```
https://elasticache.us-west-2.amazonaws.com/
?Action=CreateReplicationGroup
&CacheNodeType=cache.m4.large
&CacheParemeterGroup=default.redis6.xcluster.on
&Engine=redis
&EngineVersion=6.0
&NumNodeGroups=3
&ReplicasPerNodeGroup=2
&ReplicationGroupDescription=test%20group
&ReplicationGroupId=myReplGroup
&Version=2015-02-02
&SignatureVersion=4
&SignatureMethod=HmacSHA256
&Timestamp=20150202T192317Z
&X-Amz-Credential=
```
Pour plus d'informations et de paramètres que vous souhaiterez peut-être utiliser, consultez la rubrique ElastiCache API[CreateReplicationGroup](https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_CreateReplicationGroup.html).
# Affichage des détails d'un groupe de réplication
Selon vos besoins, vous pouvez afficher les détails d'un groupe de réplication. Vous pouvez utiliser la ElastiCache console, le AWS CLI for ElastiCache ou l' ElastiCache API. Le processus de console est différent pour Valkey ou Redis OSS (mode cluster désactivé) et Valkey ou Redis OSS (mode cluster activé).
**Contents**
+ [Affichage d'un système d'exploitation Valkey ou Redis (mode cluster désactivé) avec des répliques](Replication.ViewDetails.Redis.md)
+ [Utilisation de la ElastiCache console](Replication.ViewDetails.Redis.md#Replication.ViewDetails.Redis.CON)
+ [À l'aide du AWS CLI](Replication.ViewDetails.Redis.md#Replication.ViewDetails.Redis.CLI)
+ [Utilisation de l' ElastiCache API](Replication.ViewDetails.Redis.md#Replication.ViewDetails.Redis.API)
+ [Affichage d'un groupe de réplication : Valkey ou Redis OSS (mode cluster activé)](Replication.ViewDetails.RedisCluster.md)
+ [Utilisation de la ElastiCache console](Replication.ViewDetails.RedisCluster.md#Replication.ViewDetails.RedisCluster.CON)
+ [À l'aide du AWS CLI](Replication.ViewDetails.RedisCluster.md#Replication.ViewDetails.RedisCluster.CLI)
+ [Utilisation de l' ElastiCache API](Replication.ViewDetails.RedisCluster.md#Replication.ViewDetails.RedisCluster.API)
+ [Affichage des détails d'un groupe de réplication (AWS CLI)](Replication.ViewDetails.CLI.md)
+ [Afficher les détails d'un groupe de réplication (ElastiCache API)](Replication.ViewDetails.API.md)
# Affichage d'un système d'exploitation Valkey ou Redis (mode cluster désactivé) avec des répliques
Vous pouvez afficher les détails d'un cluster Valkey ou Redis OSS (mode cluster désactivé) avec des répliques (API/CLI : *groupe de réplication*) à l'aide de la ElastiCache console, du AWS CLI for ElastiCache ou de l'API. ElastiCache
**Contents**
+ [Utilisation de la ElastiCache console](#Replication.ViewDetails.Redis.CON)
+ [À l'aide du AWS CLI](#Replication.ViewDetails.Redis.CLI)
+ [Utilisation de l' ElastiCache API](#Replication.ViewDetails.Redis.API)
## Affichage d'un groupe de réplication Valkey ou Redis OSS (mode cluster désactivé) (console)
Pour afficher les détails d'un cluster Valkey ou Redis OSS (mode cluster désactivé) avec des répliques à l'aide de la ElastiCache console, consultez la rubrique. [Affichage des détails de Valkey ou Redis OSS (mode cluster désactivé) (console)](Clusters.ViewDetails.md#Clusters.ViewDetails.CON.Redis)
## Affichage d'un groupe de réplication Valkey ou Redis OSS (mode cluster désactivé) ()AWS CLI
Pour un AWS CLI exemple qui affiche les détails d'un groupe de réplication Valkey ou Redis OSS (mode cluster désactivé), consultez. [Affichage des détails d'un groupe de réplication (AWS CLI)](Replication.ViewDetails.CLI.md)
## Affichage d'un groupe de réplication (API) Valkey ou Redis OSS (ElastiCache mode cluster désactivé)
Pour un exemple d' ElastiCache API qui affiche les détails d'un groupe de réplication Valkey ou Redis OSS (mode cluster désactivé), consultez. [Afficher les détails d'un groupe de réplication (ElastiCache API)](Replication.ViewDetails.API.md)
# Affichage d'un groupe de réplication : Valkey ou Redis OSS (mode cluster activé)
## Affichage d'un cluster Valkey ou Redis OSS (mode cluster activé) (console)
Pour afficher les détails d'un cluster Valkey ou Redis OSS (mode cluster activé) à l'aide de la ElastiCache console, consultez. [Affichage des détails d'un cluster Valkey ou Redis OSS (mode cluster activé) (console)](Clusters.ViewDetails.md#Clusters.ViewDetails.CON.RedisCluster)
## Affichage d'un cluster Valkey ou Redis OSS (mode cluster activé) ()AWS CLI
Pour un exemple de ElastiCache CLI qui affiche les détails d'un groupe de réplication Valkey ou Redis OSS (mode cluster activé), consultez. [Affichage des détails d'un groupe de réplication (AWS CLI)](Replication.ViewDetails.CLI.md)
## Affichage d'un cluster (API) Valkey ou Redis OSS (mode cluster activé) ElastiCache
Pour un exemple d' ElastiCache API qui affiche les détails d'un groupe de réplication Valkey ou Redis OSS (mode cluster activé), consultez. [Afficher les détails d'un groupe de réplication (ElastiCache API)](Replication.ViewDetails.API.md)
# Affichage des détails d'un groupe de réplication (AWS CLI)
Vous pouvez consulter les détails d'un groupe de réplication à l'aide de la AWS CLI `describe-replication-groups` commande. Utilisez les paramètres facultatifs suivants pour affiner la liste. Si les paramètres ne sont pas spécifiés, vous obtenez les détails de 100 groupes de réplication maximum.
**Paramètres facultatifs**
+ `--replication-group-id` – Utilisez ce paramètre pour afficher les détails d'un groupe de réplication spécifique. Si le groupe de réplication spécifié comprend plus d'un groupe de nœuds, les résultats obtenus sont regroupés par groupe de nœuds.
+ `--max-items` – Utilisez ce paramètre pour limiter le nombre de groupes de réplication répertoriés. La valeur de `--max-items` doit être comprise entre 20 et 100.
**Example**
Le code suivant répertorie les détails de 100 groupes de réplication maximum.
```
aws elasticache describe-replication-groups
```
Le code suivant répertorie les détails de `sample-repl-group`.
```
aws elasticache describe-replication-groups --replication-group-id sample-repl-group
```
Le code suivant répertorie les détails de `sample-repl-group`.
```
aws elasticache describe-replication-groups --replication-group-id sample-repl-group
```
Le code suivant répertorie les détails de 25 groupes de réplication maximum.
```
aws elasticache describe-replication-groups --max-items 25
```
Le résultat de cette opération doit ressembler à cet exemple (format JSON).
```
{
"ReplicationGroups": [
{
"Status": "available",
"Description": "test",
"NodeGroups": [
{
"Status": "available",
"NodeGroupMembers": [
{
"CurrentRole": "primary",
"PreferredAvailabilityZone": "us-west-2a",
"CacheNodeId": "0001",
"ReadEndpoint": {
"Port": 6379,
"Address": "rg-name-001.1abc4d.0001.usw2.cache.amazonaws.com"
},
"CacheClusterId": "rg-name-001"
},
{
"CurrentRole": "replica",
"PreferredAvailabilityZone": "us-west-2b",
"CacheNodeId": "0001",
"ReadEndpoint": {
"Port": 6379,
"Address": "rg-name-002.1abc4d.0001.usw2.cache.amazonaws.com"
},
"CacheClusterId": "rg-name-002"
},
{
"CurrentRole": "replica",
"PreferredAvailabilityZone": "us-west-2c",
"CacheNodeId": "0001",
"ReadEndpoint": {
"Port": 6379,
"Address": "rg-name-003.1abc4d.0001.usw2.cache.amazonaws.com"
},
"CacheClusterId": "rg-name-003"
}
],
"NodeGroupId": "0001",
"PrimaryEndpoint": {
"Port": 6379,
"Address": "rg-name.1abc4d.ng.0001.usw2.cache.amazonaws.com"
}
}
],
"ReplicationGroupId": "rg-name",
"AutomaticFailover": "enabled",
"SnapshottingClusterId": "rg-name-002",
"MemberClusters": [
"rg-name-001",
"rg-name-002",
"rg-name-003"
],
"PendingModifiedValues": {}
},
{
... some output omitted for brevity
}
]
}
```
Pour plus d'informations, consultez AWS CLI la ElastiCache rubrique dédiée[describe-replication-groups](https://docs.aws.amazon.com/cli/latest/reference/elasticache/describe-replication-groups.html).
# Afficher les détails d'un groupe de réplication (ElastiCache API)
Vous pouvez consulter les détails d'une réplication à l'aide de l' AWS CLI `DescribeReplicationGroups`opération. Utilisez les paramètres facultatifs suivants pour affiner la liste. Si les paramètres ne sont pas spécifiés, vous obtenez les détails de 100 groupes de réplication maximum.
**Paramètres facultatifs**
+ `ReplicationGroupId` – Utilisez ce paramètre pour afficher les détails d'un groupe de réplication spécifique. Si le groupe de réplication spécifié comprend plus d'un groupe de nœuds, les résultats obtenus sont regroupés par groupe de nœuds.
+ `MaxRecords` – Utilisez ce paramètre pour limiter le nombre de groupes de réplication répertoriés. La valeur de `MaxRecords` doit être comprise entre 20 et 100. La valeur par défaut est 100.
**Example**
Le code suivant répertorie les détails de 100 groupes de réplication maximum.
```
https://elasticache.us-west-2.amazonaws.com/
?Action=DescribeReplicationGroups
&Version=2015-02-02
&SignatureVersion=4
&SignatureMethod=HmacSHA256
&Timestamp=20150202T192317Z
&X-Amz-Credential=
```
Le code suivant répertorie les détails de `myReplGroup`.
```
https://elasticache.us-west-2.amazonaws.com/
?Action=DescribeReplicationGroups
&ReplicationGroupId=myReplGroup
&Version=2015-02-02
&SignatureVersion=4
&SignatureMethod=HmacSHA256
&Timestamp=20150202T192317Z
&X-Amz-Credential=
```
Le code suivant affiche les détails de 25 clusters maximum.
```
https://elasticache.us-west-2.amazonaws.com/
?Action=DescribeReplicationGroups
&MaxRecords=25
&Version=2015-02-02
&SignatureVersion=4
&SignatureMethod=HmacSHA256
&Timestamp=20150202T192317Z
&X-Amz-Credential=
```
Pour plus d'informations, consultez la rubrique de référence sur les ElastiCache API[DescribeReplicationGroups](https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_DescribeReplicationGroups.html).
# Recherche des points de terminaison du groupe de réplication
Une application peut se connecter à n'importe quel nœud du groupe de réplication, à condition qu'elle dispose du point de terminaison DNS et du numéro de port de ce nœud. Selon que vous utilisez un groupe de réplication Valkey ou Redis OSS (mode cluster désactivé) ou un groupe de réplication Valkey ou Redis OSS (mode cluster activé), différents points de terminaison vous intéresseront.
**Valkey ou Redis OSS (mode cluster désactivé)**
*Les clusters Valkey ou Redis OSS (mode cluster désactivé) dotés de répliques ont trois types de points de terminaison : le point de *terminaison principal, le point de terminaison* du *lecteur et les points de terminaison* du nœud.* Le point de terminaison principal est un nom DNS qui est toujours résolu dans le nœud principal du cluster. Le point de terminaison principal n'est pas affecté par les changements apportés à votre cluster, tels que la promotion d'un réplica en lecture au rang de réplica principal. Pour l'activité d'écriture, il est préférable que vos applications se connectent au point de terminaison principal.
Un point de terminaison de lecteur répartira de manière égale les connexions entrantes vers le point de terminaison entre toutes les répliques de lecture d'un ElastiCache cluster. Des facteurs supplémentaires, comme le moment où l'application crée les connexions ou la façon dont l'application utilise ou réutilise les connexions, détermineront la distribution du trafic. Les points de terminaison du lecteur suivent les changements de cluster en temps réel au fur et à mesure que des réplicas sont ajoutés ou supprimés. Vous pouvez placer ElastiCache les multiples répliques de lecture de votre cluster Redis OSS dans différentes zones de AWS disponibilité (AZ) afin de garantir la haute disponibilité des points de terminaison des lecteurs.
**Note**
Un point de terminaison du lecteur n'est pas un équilibreur de charge. Il s'agit d'un enregistrement DNS qui se résoudra à une adresse IP de l'un des nœuds de réplica en mode round robin.
Pour l'activité de lecture, les applications peuvent également se connecter à n'importe quel nœud du cluster. Contrairement au point de terminaison principal, les points de terminaison des nœuds sont résolus dans des points de terminaison spécifiques. En cas de modification dans votre cluster, comme l'ajout ou la suppression d'un réplica, vous devez mettre à jour les points de terminaison des nœuds de votre application.
**Valkey ou Redis OSS (mode cluster activé)**
Les clusters Valkey ou Redis OSS (mode cluster activé) avec des répliques, parce qu'ils comportent plusieurs partitions (API/CLI : groupes de nœuds), ce qui signifie qu'ils possèdent également plusieurs nœuds principaux, ont une structure de point de terminaison différente de celle des clusters Valkey ou Redis OSS (mode cluster désactivé). Valkey ou Redis OSS (mode cluster activé) possède un point de *terminaison de configuration* qui « connaît » tous les points de terminaison principaux et nœuds du cluster. Votre application se connecte au point de terminaison de configuration. Chaque fois que votre application écrit ou lit depuis le point de terminaison de configuration du cluster, Valkey et Redis OSS déterminent en arrière-plan à quelle partition appartient la clé et quel point de terminaison de cette partition utiliser. Ce processus est transparent pour votre application.
Vous pouvez trouver les points de terminaison d'un cluster à l'aide de la ElastiCache console AWS CLI, de ou de l' ElastiCache API.
**Recherche des points de terminaison du groupe de réplication**
Pour trouver les points de terminaison de votre groupe de réplication, consultez l'une des rubriques suivantes :
+ [Trouver les points de terminaison d'un cluster Valkey ou Redis OSS (mode cluster désactivé) (console)](Endpoints.md#Endpoints.Find.Redis)
+ [Recherche de points de terminaison pour un cluster Valkey ou Redis OSS (mode cluster activé) (console)](Endpoints.md#Endpoints.Find.RedisCluster)
+ [Recherche des points de terminaison pour les groupes de réplication Valkey ou Redis OSS ()AWS CLI](Endpoints.md#Endpoints.Find.CLI.ReplGroups)
+ [Recherche de points de terminaison pour les groupes de réplication (API) Valkey ou Redis OSS ElastiCache](Endpoints.md#Endpoints.Find.API.ReplGroups)
# Modification d'un groupe de réplication
**Contraintes importantes**
Actuellement, ElastiCache prend en charge des modifications limitées d'un groupe de réplication Valkey ou Redis OSS (mode cluster activé), par exemple la modification de la version du moteur à l'aide de l'opération API (`ModifyReplicationGroup`CLI :`modify-replication-group`). Vous pouvez modifier le nombre de partitions (groupes de nœuds) dans un cluster Valkey ou Redis OSS (mode cluster activé) à l'aide de l'opération API ([https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_ModifyReplicationGroupShardConfiguration.html](https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_ModifyReplicationGroupShardConfiguration.html)CLI :). [https://docs.aws.amazon.com/cli/latest/reference/elasticache/modify-replication-group-shard-configuration.html](https://docs.aws.amazon.com/cli/latest/reference/elasticache/modify-replication-group-shard-configuration.html) Pour de plus amples informations, veuillez consulter [Mise à l'échelle des clusters Valkey ou Redis OSS (mode cluster activé)](scaling-redis-cluster-mode-enabled.md).
Les autres modifications apportées à un cluster Valkey ou Redis OSS (mode cluster activé) nécessitent que vous créiez un cluster avec le nouveau cluster incorporant les modifications.
Vous pouvez mettre à niveau les clusters et groupes de réplication Valkey ou Redis OSS (mode cluster désactivé) et Valkey ou Redis OSS (mode cluster activé) vers des versions de moteur plus récentes. Cependant, vous ne pouvez pas mettre à niveau vers des versions antérieures du moteur, sauf en supprimant le cluster existant ou le groupe de réplication et en le créant à nouveau. Pour de plus amples informations, veuillez consulter [Gestion des versions pour ElastiCache](VersionManagement.md).
Vous pouvez mettre à niveau un cluster existant ElastiCache pour Valkey ou Redis OSS qui utilise le mode cluster désactivé pour utiliser le mode cluster activé, à l'aide de la console, de l'[ModifyReplicationGroup](https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_ModifyReplicationGroup.html)API ou de la commande [modify-replication-group](https://docs.aws.amazon.com/cli/latest/reference/elasticache/modify-replication-group.html)CLI, comme indiqué dans l'exemple ci-dessous. Vous pouvez également suivre les étapes décrites dans [Modifying cluster mode](modify-cluster-mode.md) (Modification du mode cluster).
Vous pouvez modifier les paramètres d'un cluster Valkey ou Redis OSS (mode cluster désactivé) à l'aide de la ElastiCache console, de l' AWS CLI API ou de l' ElastiCache API. Actuellement, ElastiCache prend en charge un nombre limité de modifications sur un groupe de réplication Valkey ou Redis OSS (mode cluster activé). D'autres modifications nécessitent que vous créiez une sauvegarde du groupe de réplication actuel, puis que vous utilisiez cette sauvegarde pour démarrer un nouveau groupe de réplication Valkey ou Redis OSS (mode cluster activé).
**Topics**
+ [À l'aide du AWS Management Console](#Replication.Modify.CON)
+ [À l'aide du AWS CLI](#Replication.Modify.CLI)
+ [Utilisation de l' ElastiCache API](#Replication.Modify.API)
## À l'aide du AWS Management Console
Pour modifier un cluster Valkey ou Redis OSS (mode cluster désactivé), consultez. [Modification d'un ElastiCache cluster](Clusters.Modify.md)
## À l'aide du AWS CLI
Voici des AWS CLI exemples de `modify-replication-group` commande. Vous pouvez utiliser la même commande pour apporter d'autres modifications à un groupe de réplication.
**Activez le Multi-AZ sur un groupe de réplication Valkey ou Redis OSS existant :**
Pour Linux, macOS ou Unix :
```
aws elasticache modify-replication-group \
--replication-group-id myReplGroup \
--multi-az-enabled = true
```
Pour Windows :
```
aws elasticache modify-replication-group ^
--replication-group-id myReplGroup ^
--multi-az-enabled
```
**Modifier le mode cluster de désactivé à activé :**
Pour modifier le mode cluster de *Désactivé* à *Activé*, vous devez d'abord définir le mode cluster comme *Compatible*. Le mode de compatibilité permet à vos clients Valkey ou Redis OSS de se connecter tant avec le mode cluster activé qu’avec le mode cluster désactivé. *Après avoir migré tous les clients Valkey ou Redis OSS pour utiliser le mode cluster activé, vous pouvez terminer la configuration du mode cluster et définir le mode cluster sur activé.*
Pour Linux, macOS ou Unix :
Définissez le mode cluster sur *Compatible*.
```
aws elasticache modify-replication-group \
--replication-group-id myReplGroup \
--cache-parameter-group-name myParameterGroupName \
--cluster-mode compatible
```
Définissez le mode cluster sur *Activé*.
```
aws elasticache modify-replication-group \
--replication-group-id myReplGroup \
--cluster-mode enabled
```
Pour Windows :
Définissez le mode cluster sur *Compatible*.
```
aws elasticache modify-replication-group ^
--replication-group-id myReplGroup ^
--cache-parameter-group-name myParameterGroupName ^
--cluster-mode compatible
```
Définissez le mode cluster sur *Activé*.
```
aws elasticache modify-replication-group ^
--replication-group-id myReplGroup ^
--cluster-mode enabled
```
Pour plus d'informations sur la AWS CLI `modify-replication-group` commande, consultez [modify-replication-group](https://docs.aws.amazon.com/cli/latest/reference/elasticache/modify-replication-group.html) la section [Modification du mode cluster]() dans le *Guide de l'ElastiCache utilisateur de Redis OSS*.
## Utilisation de l' ElastiCache API
L'opération ElastiCache d'API suivante active le multi-AZ sur un groupe de réplication Valkey ou Redis OSS existant. Vous pouvez utiliser la même opération pour apporter d'autres modifications à un groupe de réplication.
```
https://elasticache.us-west-2.amazonaws.com/
?Action=ModifyReplicationGroup
&AutomaticFailoverEnabled=true
&Mutli-AZEnabled=true
&ReplicationGroupId=myReplGroup
&SignatureVersion=4
&SignatureMethod=HmacSHA256
&Timestamp=20141201T220302Z
&Version=2014-12-01
&X-Amz-Algorithm=&AWS;4-HMAC-SHA256
&X-Amz-Date=20141201T220302Z
&X-Amz-SignedHeaders=Host
&X-Amz-Expires=20141201T220302Z
&X-Amz-Credential=
&X-Amz-Signature=
```
Pour plus d'informations sur le `ModifyReplicationGroup` fonctionnement de l' ElastiCache API, consultez[ModifyReplicationGroup](https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_ModifyReplicationGroup.html).
# Suppression d'un groupe de réplication
Si vous n'avez plus besoin d'un de vos clusters avec réplicas (appelés *groupes de réplication* dans l'API/CLI), vous pouvez le supprimer. Lorsque vous supprimez un groupe de réplication, tous ElastiCache les nœuds de ce groupe sont supprimés.
Une fois que vous avez commencé cette opération, elle ne peut être ni interrompue ni annulée.
**Avertissement**
Lorsque vous supprimez un ElastiCache cluster Redis OSS, vos instantanés manuels sont conservés. Vous avez également la possibilité de créer un instantané final avant la suppression du cluster. Les instantanés mis en cache automatiquement ne sont pas conservés.
`CreateSnapshot`une autorisation est requise pour créer un instantané final. Sans cette autorisation, l'appel d'API échouera avec une `Access Denied` exception.
## Suppression d'un groupe de réplication (console)
Pour supprimer un cluster qui contient des réplicas, consultez [Supprimer un cluster dans ElastiCache](Clusters.Delete.md).
## Suppression d'un groupe de réplication (AWS CLI)
Utilisez la commande [delete-replication-group](https://docs.aws.amazon.com/AmazonElastiCache/latest/CommandLineReference/CLIReference-cmd-DeleteReplicationGroup.html) pour supprimer un groupe de réplication.
```
aws elasticache delete-replication-group --replication-group-id my-repgroup
```
Une invite vous demande de confirmer votre décision. Entrez *y* (oui) pour démarrer l'opération immédiatement. Une fois le processus entamé, il est irréversible.
```
After you begin deleting this replication group, all of its nodes will be deleted as well.
Are you sure you want to delete this replication group? [Ny]y
REPLICATIONGROUP my-repgroup My replication group deleting
```
## Supprimer un groupe de réplication (ElastiCache API)
Appelez [DeleteReplicationGroup](https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_DeleteReplicationGroup.html) avec le paramètre `ReplicationGroup`.
**Example**
```
https://elasticache.us-west-2.amazonaws.com/
?Action=DeleteReplicationGroup
&ReplicationGroupId=my-repgroup
&Version=2014-12-01
&SignatureVersion=4
&SignatureMethod=HmacSHA256
&Timestamp=20141201T220302Z
&X-Amz-Algorithm=&AWS;4-HMAC-SHA256
&X-Amz-Date=20141201T220302Z
&X-Amz-SignedHeaders=Host
&X-Amz-Expires=20141201T220302Z
&X-Amz-Credential=
&X-Amz-Signature=
```
**Note**
Si vous définissez le paramètre `RetainPrimaryCluster` sur `true`, tous les réplicas en lecture seront supprimés, mais le cluster principal sera conservé.
# Modification du nombre de réplicas
Vous pouvez augmenter ou diminuer dynamiquement le nombre de répliques de lecture dans votre groupe de réplication Valkey ou Redis OSS à l'aide de l'API AWS Management Console, de ou de l' AWS CLI API. ElastiCache Si votre groupe de réplication est un groupe de réplication Valkey ou Redis OSS (mode cluster activé), vous pouvez choisir les partitions (groupes de nœuds) pour augmenter ou diminuer le nombre de répliques.
Pour modifier dynamiquement le nombre de répliques dans votre groupe de réplication, choisissez l'opération adaptée à votre situation dans le tableau suivant.
| Pour ce faire | Pour Valkey ou Redis OSS (mode cluster activé) | Pour Valkey ou Redis OSS (mode cluster désactivé) |
| --- | --- | --- |
| Ajouter des réplicas | [Augmentation du nombre de réplicas dans une partition](increase-replica-count.md) | [Augmentation du nombre de réplicas dans une partition](increase-replica-count.md) [Ajouter une réplique de lecture pour Valkey ou Redis OSS (mode cluster désactivé)](Replication.AddReadReplica.md) |
| Supprimer des réplicas | [Diminution du nombre de réplicas dans une partition](decrease-replica-count.md) | [Diminution du nombre de réplicas dans une partition](decrease-replica-count.md) [Suppression d'une réplique de lecture pour Valkey ou Redis OSS (mode cluster désactivé)](Replication.RemoveReadReplica.md) |
# 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 à l'aide de AWS Management Console, de AWS CLI, ou de l' ElastiCache API.
**Topics**
+ [À l'aide du AWS Management Console](#increase-replica-count-con)
+ [À l'aide du AWS CLI](#increase-replica-count-cli)
+ [Utilisation de l' ElastiCache API](#increase-replica-count-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/](https://console.aws.amazon.com/elasticache/).
1. 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.
1. Cochez la case correspondant à chaque partition à laquelle vous souhaitez ajouter des réplicas.
1. Choisissez **Add replicas (Ajouter des réplicas)**.
1. 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.
1. 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 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 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 (partition) Valkey ou Redis OSS (mode cluster activé), consultez. [Recherche de l'ID d'une partition](Shards.md#shard-find-id)
+ `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 pour Redis OSS, il 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.
**Example**
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 de la CLI, consultez le [increase-replica-count](https://docs.aws.amazon.com/cli/latest/reference/elasticache/increase-replica-count.html)manuel *Amazon ElastiCache Command Line Reference*.
## Utilisation de l' ElastiCache API
Pour augmenter le nombre de répliques dans une partition Valkey ou Redis OSS, utilisez l'`IncreaseReplicaCount`action 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 (partition) Valkey ou Redis OSS (mode cluster activé), consultez. [Recherche de l'ID d'une partition](Shards.md#shard-find-id)
+ `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 pour Redis OSS, il 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.
**Example**
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=
```
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=
```
Pour plus d'informations sur l'augmentation du nombre de répliques à l'aide de l'API, consultez [IncreaseReplicaCount](https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_IncreaseReplicaCount.html)le *Amazon ElastiCache API Reference*.
# Diminution du nombre de réplicas dans une partition
Vous pouvez réduire le nombre de répliques dans une partition pour Valkey ou Redis OSS (mode cluster activé), ou dans un groupe de réplication pour Valkey ou Redis OSS (mode cluster désactivé) :
+ Pour Valkey ou Redis OSS (mode cluster désactivé), vous pouvez réduire le nombre de répliques à un si le mode multi-AZ est activé, et à zéro s'il n'est pas activé.
+ Pour Valkey ou Redis OSS (mode cluster activé), vous pouvez réduire le nombre de répliques à zéro. Cependant, vous ne pouvez pas basculer vers un réplica en cas d'échec du nœud principal.
Vous pouvez utiliser l' AWS Management Console API AWS CLI ou l' ElastiCache API pour réduire le nombre de répliques dans un groupe de nœuds (partition) ou un groupe de réplication.
**Topics**
+ [En utilisant le AWS Management Console](#decrease-replica-count-con)
+ [En utilisant le AWS CLI](#decrease-replica-count-cli)
+ [Utilisation de l' ElastiCache API](#decrease-replica-count-api)
## En utilisant le AWS Management Console
La procédure suivante utilise la console pour diminuer le nombre de répliques dans un groupe de réplication Valkey ou Redis OSS (mode cluster activé).
**Pour réduire le nombre de répliques dans une partition Valkey ou Redis OSS**
1. Connectez-vous à la ElastiCache console AWS Management Console et ouvrez-la à l'adresse [ https://console.aws.amazon.com/elasticache/](https://console.aws.amazon.com/elasticache/).
1. Dans le volet de navigation, choisissez **Valkey** ou **Redis OSS**, puis choisissez le nom du groupe de réplication dont vous souhaitez supprimer les répliques.
1. Cochez la case correspondant à chaque partition dont vous souhaitez supprimer un nœud de réplica.
1. Choisissez **Delete replicas (Supprimer des réplicas)**.
1. Renseignez la page **Delete Replicas from Shards (Supprimer des réplicas de partitions)** :
1. 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 à 1. Nous vous recommandons d'utiliser au moins deux réplicas par partition.
1. Choisissez **Delete (Supprimer)** pour supprimer les réplicas ou **Cancel (Annuler)** pour annuler l'opération.
**Important**
Si vous ne spécifiez pas les nœuds de réplication à supprimer, ElastiCache Redis OSS sélectionne automatiquement les nœuds de réplication à supprimer. Ce faisant, ElastiCache Redis OSS tente de conserver l'architecture multi-AZ de votre groupe de réplication, puis de conserver les répliques avec un délai de réplication minimal par rapport au principal.
Vous ne pouvez pas supprimer le nœud primaire ou le nœud maître dans un groupe de réplication. Si vous spécifiez un nœud principal afin qu'il soit supprimé, l'opération échoue et une erreur indique que le nœud principal a été sélectionné pour être supprimé.
## En utilisant le AWS CLI
Pour réduire le nombre de répliques dans une partition Valkey ou Redis OSS, utilisez la `decrease-replica-count` commande avec les paramètres suivants :
+ `--replication-group-id` – Obligatoire. Identifie le groupe de réplication dans lequel vous souhaitez diminuer le nombre de réplicas.
+ `--apply-immediately` ou `--no-apply-immediately` : obligatoire. Spécifie si le nombre de réplicas doit être diminué 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 souhaité. La valeur de `--new-replica-count` doit être une valeur valide inférieure au nombre de réplicas actuel dans les groupes de nœuds. Pour consulter les valeurs minimum autorisées, consultez [Diminution du nombre de réplicas dans une partition](#decrease-replica-count). Si la valeur de `--new-replica-count` ne répond pas à cette exigence, l'appel échoue.
+ `--replicas-to-remove` : facultatif. Contient une liste de nœuds IDs spécifiant les nœuds répliques à supprimer.
+ `--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 (partition) Valkey ou Redis OSS (mode cluster activé), consultez. [Recherche de l'ID d'une partition](Shards.md#shard-find-id)
+ `NewReplicaCount` : paramètre facultatif qui spécifie le nombre de nœuds de réplica souhaité. La valeur de `NewReplicaCount` doit être une valeur valide inférieure au nombre de réplicas actuel dans les groupes de nœuds. Pour consulter les valeurs minimum autorisées, consultez [Diminution du nombre de réplicas dans une partition](#decrease-replica-count). Si la valeur de `NewReplicaCount` ne répond pas à cette exigence, l'appel échoue.
+ `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 pour Redis OSS, il choisit la zone de disponibilité pour chacune des nouvelles répliques.
**Important**
Vous devez uniquement inclure l'un des paramètres suivants : `--new-replica-count`, `--replicas-to-remove` ou `--replica-configuration`.
**Example**
L'exemple suivant utilise `--new-replica-count` pour abaisser à 1 le nombre de réplicas du groupe de réplication `sample-repl-group`. À la fin de cet exemple, il y a un réplica 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 decrease-replica-count
--replication-group-id sample-repl-group \
--new-replica-count 1 \
--apply-immediately
```
Pour Windows :
```
aws elasticache decrease-replica-count ^
--replication-group-id sample-repl-group ^
--new-replica-count 1 ^
--apply-immediately
```
L'exemple suivant diminue le nombre de réplicas du groupe de réplication `sample-repl-group` en supprimant deux réplicas spécifiés (`0001` et `0003`) du groupe de nœuds.
Pour Linux, macOS ou Unix :
```
aws elasticache decrease-replica-count \
--replication-group-id sample-repl-group \
--replicas-to-remove 0001,0003 \
--apply-immediately
```
Pour Windows :
```
aws elasticache decrease-replica-count ^
--replication-group-id sample-repl-group ^
--replicas-to-remove 0001,0003 \
--apply-immediately
```
L'exemple suivant utilise `--replica-configuration` pour diminuer 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 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
```
Pour 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
```
Pour plus d'informations sur la réduction du nombre de répliques à l'aide de la CLI, consultez le [decrease-replica-count](https://docs.aws.amazon.com/cli/latest/reference/elasticache/decrease-replica-count.html)manuel *Amazon ElastiCache Command Line Reference*.
## Utilisation de l' ElastiCache API
Pour réduire le nombre de répliques dans une partition Valkey ou Redis OSS, utilisez l'`DecreaseReplicaCount`action avec les paramètres suivants :
+ `ReplicationGroupId` – Obligatoire. Identifie le groupe de réplication dans lequel vous souhaitez diminuer le nombre de réplicas.
+ `ApplyImmediately` : obligatoire. Spécifie si le nombre de réplicas doit être diminué 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 souhaité. La valeur de `NewReplicaCount` doit être une valeur valide inférieure au nombre de réplicas actuel dans les groupes de nœuds. Pour consulter les valeurs minimum autorisées, consultez [Diminution du nombre de réplicas dans une partition](#decrease-replica-count). Si la valeur de `--new-replica-count` ne répond pas à cette exigence, l'appel échoue.
+ `ReplicasToRemove` : facultatif. Contient une liste de nœuds IDs spécifiant les nœuds répliques à supprimer.
+ `ReplicaConfiguration` : facultatif. Contient une liste de groupes de nœuds qui 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 est toujours. `0001` Pour trouver l'ID d'un groupe de nœuds (partition) Valkey ou Redis OSS (mode cluster activé), consultez. [Recherche de l'ID d'une partition](Shards.md#shard-find-id)
+ `NewReplicaCount` : nombre de réplicas que vous souhaitez dans ce groupe de nœuds à la fin de cette opération. La valeur doit être inférieure au nombre actuel de réplicas et être de 1 minimum si l'option Multi-AZ est activée, ou de 0 si cette option n'est pas activée. Si cette valeur n'est pas infé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 pour Redis OSS, il choisit la zone de disponibilité pour chacune des nouvelles répliques.
**Important**
Vous devez uniquement inclure l'un des paramètres suivants : `NewReplicaCount`, `ReplicasToRemove` ou `ReplicaConfiguration`.
**Example**
L'exemple suivant utilise `NewReplicaCount` pour abaisser à 1 le nombre de réplicas du groupe de réplication `sample-repl-group`. À la fin de cet exemple, il y a un réplica 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=DecreaseReplicaCount
&ApplyImmediately=True
&NewReplicaCount=1
&ReplicationGroupId=sample-repl-group
&Version=2015-02-02
&SignatureVersion=4
&SignatureMethod=HmacSHA256
&Timestamp=20150202T192317Z
&X-Amz-Credential=
```
L'exemple suivant diminue le nombre de réplicas du groupe de réplication `sample-repl-group` en supprimant deux réplicas spécifiés (`0001` et `0003`) du groupe de nœuds.
```
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=
```
L'exemple suivant utilise `ReplicaConfiguration` pour diminuer 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=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=
```
Pour plus d'informations sur la réduction du nombre de répliques à l'aide de l'API, consultez [DecreaseReplicaCount](https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_DecreaseReplicaCount.html)le *Amazon ElastiCache API Reference*.
# Ajouter une réplique de lecture pour Valkey ou Redis OSS (mode cluster désactivé)
Les informations de la rubrique suivante s'appliquent uniquement aux groupes de réplication Valkey ou Redis OSS (mode cluster désactivé).
À mesure que la charge de lecture augmente, vous pouvez avoir besoin de répartir ces lectures sur plusieurs nœuds et réduire la charge sur chaque nœud individuellement. Dans cette rubrique, vous découvrirez comment ajouter une réplique en lecture à un cluster Valkey ou Redis OSS (mode cluster désactivé).
Un groupe de réplication Valkey ou Redis OSS (mode cluster désactivé) peut avoir un maximum de cinq répliques en lecture. Si vous essayez d'ajouter un réplica en lecture à un groupe de réplication qui en contient déjà cinq, l'opération échoue.
Pour plus d'informations sur l'ajout de répliques à un groupe de réplication Valkey ou Redis OSS (mode cluster activé), consultez ce qui suit :
+ [Mise à l'échelle des clusters Valkey ou Redis OSS (mode cluster activé)](scaling-redis-cluster-mode-enabled.md)
+ [Augmentation du nombre de réplicas dans une partition](increase-replica-count.md)
Vous pouvez ajouter une réplique en lecture à un cluster Valkey ou Redis OSS (mode cluster désactivé) à l'aide de la ElastiCache console, de l'API ou de l' AWS CLI API. ElastiCache
**Rubriques en relation**
+ [Ajouter des nœuds à un ElastiCache cluster](Clusters.AddNode.md)
+ [Ajout d'un réplica en lecture à un groupe de réplication (AWS CLI)](#Replication.AddReadReplica.CLI)
+ [Ajout d'un réplica en lecture à un groupe de réplication à l'aide de l'API](#Replication.AddReadReplica.API)
## Ajout d'un réplica en lecture à un groupe de réplication (AWS CLI)
Pour ajouter une réplique en lecture à un groupe de réplication Valkey ou Redis OSS (mode cluster désactivé), utilisez la AWS CLI `create-cache-cluster` commande, avec le paramètre `--replication-group-id` pour spécifier le groupe de réplication auquel ajouter le cluster (nœud).
L'exemple suivant crée le cluster `my-read replica` et l'ajoute au groupe de réplication `my-replication-group`. Les types de nœud, les groupes de paramètres, les groupes de sécurité, le créneau de maintenance et les autres paramètres du réplica en lecture seront les mêmes que ceux des autres nœuds dans `my-replication-group`.
Pour Linux, macOS ou Unix :
```
aws elasticache create-cache-cluster \
--cache-cluster-id my-read-replica \
--replication-group-id my-replication-group
```
Pour Windows :
```
aws elasticache create-cache-cluster ^
--cache-cluster-id my-read-replica ^
--replication-group-id my-replication-group
```
Pour plus d'informations sur l'ajout d'une réplique en lecture à l'aide de la CLI, consultez [create-cache-cluster](https://docs.aws.amazon.com/cli/latest/reference/elasticache/create-cache-cluster.html) le manuel *Amazon ElastiCache Command Line Reference.*
## Ajout d'un réplica en lecture à un groupe de réplication à l'aide de l'API
Pour ajouter une réplique en lecture à un groupe de réplication Valkey ou Redis OSS (mode cluster désactivé), utilisez l' ElastiCache `CreateCacheCluster`opération, avec le paramètre `ReplicationGroupId` pour spécifier le groupe de réplication auquel ajouter le cluster (nœud).
L'exemple suivant crée le cluster `myReadReplica` et l'ajoute au groupe de réplication `myReplicationGroup`. Les types de nœud, les groupes de paramètres, les groupes de sécurité, le créneau de maintenance et les autres paramètres du réplica en lecture seront les mêmes que ceux des autres nœuds `myReplicationGroup`.
```
https://elasticache.us-west-2.amazonaws.com/
?Action=CreateCacheCluster
&CacheClusterId=myReadReplica
&ReplicationGroupId=myReplicationGroup
&Version=2015-02-02
&SignatureVersion=4
&SignatureMethod=HmacSHA256
&Timestamp=20150202T192317Z
&X-Amz-Credential=
```
Pour plus d'informations sur l'ajout d'une réplique en lecture à l'aide de l'API, consultez [CreateCacheCluster](https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_CreateCacheCluster.html) le *Amazon ElastiCache API Reference.*
# Suppression d'une réplique de lecture pour Valkey ou Redis OSS (mode cluster désactivé)
Les informations de la rubrique suivante s'appliquent uniquement aux groupes de réplication Valkey ou Redis OSS (mode cluster désactivé).
À mesure que le trafic de lecture sur votre groupe de réplication Valkey ou Redis OSS change, vous souhaiterez peut-être ajouter ou supprimer des répliques de lecture. La suppression d'un nœud d'un groupe de réplication équivaut à supprimer un cluster, avec les restrictions suivantes :
+ Vous ne pouvez pas supprimer le réplica principal d'un groupe de réplication. Si vous souhaitez supprimer le réplica principal, procédez comme suit :
1. Promouvez un réplica en lecture en réplica principal. Pour plus d'informations sur la promotion d'un réplica en lecture en réplica principal, consultez [Promouvoir une réplique en lecture au statut principal, pour les groupes de réplication Valkey ou Redis OSS (mode cluster désactivé)](Replication.PromoteReplica.md).
1. Supprimez l'ancienne réplica principal. Reportez-vous au point suivant pour consulter une restriction à cette méthode.
+ Si l'option Multi-AZ est activée sur un groupe de réplication, vous ne pouvez pas supprimer le dernier réplica en lecture de ce groupe de réplication. Dans ce cas, procédez comme suit :
1. Modifiez le groupe de réplication en désactivant Multi-AZ. Pour de plus amples informations, veuillez consulter [Modification d'un groupe de réplication](Replication.Modify.md).
1. Supprimez le réplica en lecture.
Vous pouvez supprimer une réplique en lecture d'un groupe de réplication Valkey ou Redis OSS (mode cluster désactivé) à l'aide de la ElastiCache console, du AWS CLI for ElastiCache ou de l' ElastiCache API.
Pour savoir comment supprimer un cluster d'un groupe de réplication Valkey ou Redis OSS, consultez ce qui suit :
+ [En utilisant le AWS Management Console](Clusters.Delete.md#Clusters.Delete.CON)
+ [Utilisation du AWS CLI pour supprimer un ElastiCache cluster](Clusters.Delete.md#Clusters.Delete.CLI)
+ [Utilisation de l' ElastiCache API](Clusters.Delete.md#Clusters.Delete.API)
+ [Mise à l'échelle des clusters Valkey ou Redis OSS (mode cluster activé)](scaling-redis-cluster-mode-enabled.md)
+ [Diminution du nombre de réplicas dans une partition](decrease-replica-count.md)
# Promouvoir une réplique en lecture au statut principal, pour les groupes de réplication Valkey ou Redis OSS (mode cluster désactivé)
Les informations de la rubrique suivante s'appliquent uniquement aux groupes de réplication Valkey ou Redis OSS (mode cluster désactivé).
Vous pouvez promouvoir une réplique de lecture Valkey ou Redis OSS (mode cluster désactivé) en tant que réplique principale à l'aide de l'API AWS Management Console, de ou de l' ElastiCache API. AWS CLI Vous ne pouvez pas promouvoir un réplica en lecture en réplica principal lorsque l'option Multi-AZ avec basculement automatique est activée sur le groupe de réplication . Pour faire d'une réplique Valkey ou Redis OSS (mode cluster désactivé) une réplique principale sur un groupe de réplication compatible multi-AZ, procédez comme suit :
1. Modifiez le groupe de réplication pour désactiver le mode Multi-AZ (pour cela, tous les clusters ne doivent pas obligatoirement se trouver dans la même zone de disponibilité). Pour de plus amples informations, veuillez consulter [Modification d'un groupe de réplication](Replication.Modify.md).
1. Promouvez le réplica en lecture en réplica principal.
1. Modifiez le groupe de réplication pour réactiver Multi-AZ.
Le mode multi-AZ n'est pas disponible sur les groupes de réplication exécutant Redis OSS 2.6.13 ou une version antérieure.
## À l'aide du AWS Management Console
La procédure suivante utilise la console pour promouvoir un nœud de réplica et nœud principal.
**Pour promouvoir un réplica en lecture en réplica principal (console)**
1. Connectez-vous à la ElastiCache console AWS Management Console et ouvrez-la à l'adresse [ https://console.aws.amazon.com/elasticache/](https://console.aws.amazon.com/elasticache/).
1. Si le réplica que vous souhaitez promouvoir est membre d'un groupe de réplication Valkey ou Redis OSS (mode cluster désactivé) dans lequel le mode multi-AZ est activé, modifiez le groupe de réplication pour désactiver le mode multi-AZ avant de continuer. Pour de plus amples informations, veuillez consulter [Modification d'un groupe de réplication](Replication.Modify.md).
1. Choisissez **Valkey** ou **Redis OSS**, puis dans la liste des clusters, choisissez le groupe de réplication que vous souhaitez modifier. Ce groupe de réplication doit exécuter le moteur « Redis », et non le moteur « Clustered Redis », et doit avoir au moins 2 nœuds.
1. Dans la liste des nœuds, choisissez le nœud de réplica que vous souhaitez promouvoir en nœud principal, puis, dans **Actions**, choisissez **Promote (Promouvoir)**.
1. Dans la boîte de dialogue **Promote Read Replica (Promouvoir le réplica en lecture)**, exécutez l'une des actions suivantes :
1. Pour **Apply Immediately (Appliquer immédiatement)**, choisissez **Yes (Oui)** pour promouvoir immédiatement le réplica en lecture, ou **No (Non)** pour le promouvoir au créneau de maintenance suivant du cluster.
1. Choisissez **Promote** pour promouvoir le réplica en lecture ou **Cancel** pour annuler l'opération.
1. Si l'option Multi-AZ est activée pour le cluster avant que vous ne commenciez le processus de promotion, patientez jusqu'à ce que le statut du groupe de réplication soit **available (disponible)**, puis modifiez le cluster pour activer à nouveau Multi-AZ. Pour de plus amples informations, veuillez consulter [Modification d'un groupe de réplication](Replication.Modify.md).
## À l'aide du AWS CLI
Il est impossible de promouvoir un réplica en lecture en réplica principal si Multi-AZ est activé pour le groupe de réplication. Dans certains cas, le réplica que vous souhaitez promouvoir peut appartenir à un groupe de réplication pour lequel le mode Multi-AZ est activé. Dans ces cas, vous devez modifier le groupe de réplication pour pouvoir désactiver le mode Multi-AZ avant de continuer. Pour cela, tous les clusters ne doivent pas obligatoirement se trouver dans la même zone de disponibilité. Pour plus d'informations sur la modification d'un groupe de réplication, consultez [Modification d'un groupe de réplication](Replication.Modify.md).
La AWS CLI commande suivante modifie le groupe de réplication`sample-repl-group`, faisant de la réplique en lecture `my-replica-1` le principal du groupe de réplication.
Pour Linux, macOS ou Unix :
```
aws elasticache modify-replication-group \
--replication-group-id sample-repl-group \
--primary-cluster-id my-replica-1
```
Pour Windows :
```
aws elasticache modify-replication-group ^
--replication-group-id sample-repl-group ^
--primary-cluster-id my-replica-1
```
Pour plus d'informations sur la modification d'un groupe de réplication, consultez [modify-replication-group](https://docs.aws.amazon.com/cli/latest/reference/elasticache/modify-replication-group.html) le manuel *Amazon ElastiCache Command Line Reference.*
## Utilisation de l' ElastiCache API
Il est impossible de promouvoir un réplica en lecture en réplica principal si Multi-AZ est activé pour le groupe de réplication. Dans certains cas, le réplica que vous souhaitez promouvoir peut appartenir à un groupe de réplication pour lequel le mode Multi-AZ est activé. Dans ces cas, vous devez modifier le groupe de réplication pour pouvoir désactiver le mode Multi-AZ avant de continuer. Pour cela, tous les clusters ne doivent pas obligatoirement se trouver dans la même zone de disponibilité. Pour plus d'informations sur la modification d'un groupe de réplication, consultez [Modification d'un groupe de réplication](Replication.Modify.md).
L'action d' ElastiCache API suivante modifie le groupe de réplication`myReplGroup`, faisant de la réplique en lecture `myReplica-1` le principal du groupe de réplication.
```
https://elasticache.us-west-2.amazonaws.com/
?Action=ModifyReplicationGroup
&ReplicationGroupId=myReplGroup
&PrimaryClusterId=myReplica-1
&Version=2014-12-01
&SignatureVersion=4
&SignatureMethod=HmacSHA256
&Timestamp=20141201T220302Z
&X-Amz-Algorithm=&AWS;4-HMAC-SHA256
&X-Amz-Date=20141201T220302Z
&X-Amz-SignedHeaders=Host
&X-Amz-Expires=20141201T220302Z
&X-Amz-Credential=
&X-Amz-Signature=
```
Pour plus d'informations sur la modification d'un groupe de réplication, consultez [ModifyReplicationGroup](https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_ModifyReplicationGroup.html) le *Amazon ElastiCache API Reference.*