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. # Ajouter des nœuds à un ElastiCache cluster L'ajout de nœuds à un cluster Memcached augmente le nombre de partitions de votre cluster. Lorsque vous modifiez le nombre de partitions dans un cluster, vous devez redéfinir le mappage de certains de vos espace de clé afin qu'ils soient mappés avec le nœud adéquat. Le remappage des espaces de clé augmente temporairement le nombre d'échecs d'accès au cache sur le cluster. Pour de plus amples informations, veuillez consulter [Configuration de votre ElastiCache client pour un équilibrage de charge efficace (Memcached)](BestPractices.LoadBalancing.md). Pour reconfigurer votre cluster Valkey ou Redis OSS (mode cluster activé), voir [Mise à l'échelle des clusters Valkey ou Redis OSS (mode cluster activé)](scaling-redis-cluster-mode-enabled.md) Vous pouvez utiliser la console ElastiCache de gestion AWS CLI ou l' ElastiCache API pour ajouter des nœuds à votre cluster. ## À l'aide du ElastiCache AWS Management Console Si vous souhaitez ajouter un nœud à un cluster Valkey ou Redis OSS (mode cluster désactivé) à nœud unique (un cluster sans réplication activée), il s'agit d'un processus en deux étapes : ajoutez d'abord la réplication, puis ajoutez un nœud de réplique. **Rubriques** + [Pour ajouter une réplication à un cluster Valkey ou Redis OSS sans partitions](#AddReplication.CON) + [Pour ajouter des nœuds à un ElastiCache cluster (console)](#AddNode.CON) La procédure suivante ajoute la réplication à un Valkey ou Redis OSS à nœud unique pour lequel la réplication n'est pas activée. Lorsque vous ajoutez la réplication, le nœud existant devient le nœud principal dans le cluster avec réplication activée. Une fois la réplication ajoutée, vous pouvez ajouter jusqu'à 5 nœuds de réplica au cluster. **Pour ajouter une réplication à un cluster Valkey ou Redis OSS sans 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 clusters** ou **Redis OSS** clusters. La liste des clusters exécutant ce moteur s'affiche. 1. Choisissez le nom d'un cluster, pas la case à gauche du nom du cluster, auquel vous souhaitez ajouter des nœuds. Ce qui suit est vrai pour un cluster Redis OSS dont la réplication n'est pas activée : + Il exécute Redis OSS, et non Redis OSS en cluster. + Il n'a pas de partitions. Si le cluster a des partitions, la réplication est déjà activée dessus et vous pouvez continuer sur [Pour ajouter des nœuds à un ElastiCache cluster (console)](#AddNode.CON). 1. Choisissez **Add replication**. 1. Dans **Ajouter une réplication**, entrez une description pour ce cluster avec réplication activée. 1. Choisissez **Ajouter**. Dès que l'état du cluster retourne à *disponible*, vous pouvez passer à la prochaine procédure et ajouter des réplicas au cluster. **Pour ajouter des nœuds à un ElastiCache cluster (console)** La procédure suivante peut être utilisée pour ajouter des nœuds à un cluster. 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 le moteur s'exécutant sur le cluster auquel vous voulez ajouter des nœuds. La liste des clusters exécutant le moteur choisi s'affiche. 1. Dans la liste des clusters, choisissez le nom du cluster auquel vous souhaitez ajouter un nœud. Si votre cluster est un cluster Valkey ou Redis OSS (mode cluster activé), consultez. [Mise à l'échelle des clusters Valkey ou Redis OSS (mode cluster activé)](scaling-redis-cluster-mode-enabled.md) Si votre cluster est un cluster Valkey ou Redis OSS (mode cluster désactivé) ne contenant aucune partition, effectuez d'abord les étapes décrites à. [Pour ajouter une réplication à un cluster Valkey ou Redis OSS sans partitions](#AddReplication.CON) 1. Choisissez **Add node** (Ajouter un nœud). 1. Saisissez les informations demandées dans la boîte de dialogue **Add Node (Ajouter un nœud)**. 1. Choisissez le bouton **Apply Immediately - Yes (Appliquer immédiatement - Oui)** pour ajouter ce nœud immédiatement, ou choisissez **No (Non)** pour ajouter ce nœud lors du prochain créneau de maintenance du cluster. **Impact des nouvelles demandes d'ajout et de suppression sur les demandes en attente** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/AmazonElastiCache/latest/dg/Clusters.AddNode.html) Pour déterminer les opérations en attente, choisissez l'onglet **Description** et vérifiez combien de créations ou de suppressions en attente sont affichées. Vous ne pouvez pas avoir à la fois des créations et des suppressions en attente. 1. Choisissez le bouton **Add**. Au bout de quelques instants, les nouveaux nœuds apparaissent dans la liste des nœuds avec le statut **creating**. S'ils n'apparaissent pas, actualisez la page de votre navigateur. Lorsque l'état du nœud passe à *available* (disponible), le nouveau nœud peut être utilisé. ## En utilisant le AWS CLI avec ElastiCache Pour ajouter des nœuds à un cluster à l'aide de AWS CLI, utilisez l'AWS CLI opération `modify-cache-cluster` avec les paramètres suivants : + `--cache-cluster-id` ID du cluster auquel vous souhaitez ajouter des nœuds. + `--num-cache-nodes` Le paramètre `--num-cache-nodes` spécifie le nombre de nœuds que vous voulez ajouter à ce cluster après application de la modification. Pour ajouter des nœuds à ce cluster, `--num-cache-nodes` doit être supérieur au nombre actuel de nœuds dans ce cluster. Si cette valeur est inférieure au nombre actuel de nœuds, ElastiCache attendez-vous à ce que le paramètre `cache-node-ids-to-remove` et une liste de nœuds soient supprimés du cluster. Pour de plus amples informations, veuillez consulter [En utilisant le AWS CLI avec ElastiCache](Clusters.DeleteNode.md#Clusters.DeleteNode.CLI). + `--apply-immediately` ou `--no-apply-immediately` qui spécifie s'il convient d'ajouter ces nœuds immédiatement ou lors du prochain créneau de maintenance. Pour Linux, macOS ou Unix : ``` aws elasticache modify-cache-cluster \ --cache-cluster-id my-cluster \ --num-cache-nodes 5 \ --apply-immediately ``` Pour Windows : ``` aws elasticache modify-cache-cluster ^ --cache-cluster-id my-cluster ^ --num-cache-nodes 5 ^ --apply-immediately ``` Cette opération produit une sortie similaire à la sortie suivante (format JSON) : ``` { "CacheCluster": { "Engine": "memcached", "CacheParameterGroup": { "CacheNodeIdsToReboot": [], "CacheParameterGroupName": "default.memcached1.4", "ParameterApplyStatus": "in-sync" }, "CacheClusterId": "my-cluster", "PreferredAvailabilityZone": "us-west-2b", "ConfigurationEndpoint": { "Port": 11211, "Address": "rlh-mem000.7alc7bf-example.cfg.usw2.cache.amazonaws.com" }, "CacheSecurityGroups": [], "CacheClusterCreateTime": "2016-09-21T16:28:28.973Z", "AutoMinorVersionUpgrade": true, "CacheClusterStatus": "modifying", "NumCacheNodes": 2, "ClientDownloadLandingPage": "https://console.aws.amazon.com/elasticache/home#client-download:", "SecurityGroups": [ { "Status": "active", "SecurityGroupId": "sg-dbe93fa2" } ], "CacheSubnetGroupName": "default", "EngineVersion": "1.4.24", "PendingModifiedValues": { "NumCacheNodes": 5 }, "PreferredMaintenanceWindow": "sat:09:00-sat:10:00", "CacheNodeType": "cache.m3.medium", "DataTiering": "disabled", } } ``` Pour plus d'informations, consultez la AWS CLI rubrique [https://docs.aws.amazon.com/cli/latest/reference/elasticache/modify-cache-cluster.html](https://docs.aws.amazon.com/cli/latest/reference/elasticache/modify-cache-cluster.html). ## En utilisant le AWS CLI avec ElastiCache Si vous souhaitez ajouter des nœuds à un cluster Valkey ou Redis OSS existant (mode cluster désactivé) dont la réplication n'est pas activée, vous devez d'abord créer le groupe de réplication en spécifiant le cluster existant comme principal. Pour de plus amples informations, veuillez consulter [Création d'un groupe de réplication à l'aide d'un cluster Valkey ou Redis OSS disponible ()AWS CLI](Replication.CreatingReplGroup.ExistingCluster.md#Replication.CreatingReplGroup.ExistingCluster.CLI). Une fois que le groupe de réplication est *disponible*, vous pouvez passer au processus suivant. Pour ajouter des nœuds à un cluster à l'aide de AWS CLI, utilisez l'AWS CLI opération `increase-replica-count` avec les paramètres suivants : + `--replication-group-id` ID du groupe de réplication auquel vous souhaitez ajouter des nœuds. + `--new-replica-count` indique le nombre de nœuds que vous souhaitez avoir dans ce groupe de réplication après l'application de la modification. Pour ajouter des nœuds à ce cluster, `--new-replica-count` doit être supérieur au nombre actuel de nœuds dans ce cluster. + `--apply-immediately` ou `--no-apply-immediately` qui spécifie s'il convient d'ajouter ces nœuds immédiatement ou lors du prochain créneau de maintenance. Pour Linux, macOS ou Unix : ``` aws elasticache increase-replica-count \ --replication-group-id my-replication-group \ --new-replica-count 4 \ --apply-immediately ``` Pour Windows : ``` aws elasticache increase-replica-count ^ --replication-group-id my-replication-group ^ --new-replica-count 4 ^ --apply-immediately ``` Cette opération produit une sortie similaire à la sortie suivante (format JSON) : ``` { "ReplicationGroup": { "ReplicationGroupId": "node-test", "Description": "node-test", "Status": "modifying", "PendingModifiedValues": {}, "MemberClusters": [ "node-test-001", "node-test-002", "node-test-003", "node-test-004", "node-test-005" ], "NodeGroups": [ { "NodeGroupId": "0001", "Status": "modifying", "PrimaryEndpoint": { "Address": "node-test.zzzzzz.ng.0001.usw2.cache.amazonaws.com", "Port": 6379 }, "ReaderEndpoint": { "Address": "node-test.zzzzzz.ng.0001.usw2.cache.amazonaws.com", "Port": 6379 }, "NodeGroupMembers": [ { "CacheClusterId": "node-test-001", "CacheNodeId": "0001", "ReadEndpoint": { "Address": "node-test-001.zzzzzz.0001.usw2.cache.amazonaws.com", "Port": 6379 }, "PreferredAvailabilityZone": "us-west-2a", "CurrentRole": "primary" }, { "CacheClusterId": "node-test-002", "CacheNodeId": "0001", "ReadEndpoint": { "Address": "node-test-002.zzzzzz.0001.usw2.cache.amazonaws.com", "Port": 6379 }, "PreferredAvailabilityZone": "us-west-2c", "CurrentRole": "replica" }, { "CacheClusterId": "node-test-003", "CacheNodeId": "0001", "ReadEndpoint": { "Address": "node-test-003.zzzzzz.0001.usw2.cache.amazonaws.com", "Port": 6379 }, "PreferredAvailabilityZone": "us-west-2b", "CurrentRole": "replica" } ] } ], "SnapshottingClusterId": "node-test-002", "AutomaticFailover": "enabled", "MultiAZ": "enabled", "SnapshotRetentionLimit": 1, "SnapshotWindow": "07:30-08:30", "ClusterEnabled": false, "CacheNodeType": "cache.r5.large", "DataTiering": "disabled", "TransitEncryptionEnabled": false, "AtRestEncryptionEnabled": false, "ARN": "arn:aws:elasticache:us-west-2:123456789012:replicationgroup:node-test" } } ``` Pour plus d'informations, consultez la AWS CLI rubrique [https://docs.aws.amazon.com/cli/latest/reference/elasticache/increase-replica-count.html](https://docs.aws.amazon.com/cli/latest/reference/elasticache/increase-replica-count.html). ## Utilisation de l' ElastiCache API Si vous souhaitez ajouter des nœuds à un cluster Valkey ou Redis OSS existant (mode cluster désactivé) dont la réplication n'est pas activée, vous devez d'abord créer le groupe de réplication en spécifiant le cluster existant comme principal. Pour de plus amples informations, veuillez consulter [Ajouter des répliques à un cluster (API) autonome Valkey ou Redis OSS (mode cluster désactivé) ElastiCache](Replication.CreatingReplGroup.ExistingCluster.md#Replication.CreatingReplGroup.ExistingCluster.API). Une fois que le groupe de réplication est *disponible*, vous pouvez passer au processus suivant. **Pour ajouter des nœuds à un cluster (ElastiCache API)** + Appelez l'opération d'API `IncreaseReplicaCount` avec les paramètres suivants : + `ReplicationGroupId` ID du cluster auquel vous souhaitez ajouter des nœuds. + `NewReplicaCount` Le paramètre `NewReplicaCount` spécifie le nombre de nœuds que vous voulez ajouter à ce cluster après application de la modification. Pour ajouter des nœuds à ce cluster, `NewReplicaCount` doit être supérieur au nombre actuel de nœuds dans ce cluster. Si cette valeur est inférieure au nombre actuel de nœuds, utilisez l'API `DecreaseReplicaCount` avec le nombre de nœuds à retirer du cluster. + `ApplyImmediately` spécifie s'il convient d'ajouter ces nœuds immédiatement ou lors du prochain créneau de maintenance. + `Region`Spécifie la AWS région du cluster à laquelle vous souhaitez ajouter des nœuds. L'exemple suivant montre un appel à ajouter des nœuds à un cluster. **Example** ``` https://elasticache.us-west-2.amazonaws.com/ ?Action=IncreaseReplicaCount &ApplyImmediately=true &NumCacheNodes=4 &ReplicationGroupId=my-replication-group &Region=us-east-2 &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, consultez la rubrique ElastiCache API [https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_IncreaseReplicaCount.html](https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_IncreaseReplicaCount.html). ## Utilisation de l' ElastiCache API **Pour ajouter des nœuds à un cluster (ElastiCache API)** + Appelez l'opération d'API `ModifyCacheCluster` avec les paramètres suivants : + `CacheClusterId` ID du cluster auquel vous souhaitez ajouter des nœuds. + `NumCacheNodes` Le paramètre `NumCachNodes` spécifie le nombre de nœuds que vous voulez ajouter à ce cluster après application de la modification. Pour ajouter des nœuds à ce cluster, `NumCacheNodes` doit être supérieur au nombre actuel de nœuds dans ce cluster. Si cette valeur est inférieure au nombre actuel de nœuds, ElastiCache attendez-vous à ce que le paramètre `CacheNodeIdsToRemove` contenant une liste de nœuds soit supprimé du cluster (voir[Utilisation de l' ElastiCache API avec Memcached](Clusters.DeleteNode.md#Clusters.DeleteNode.API)). + `ApplyImmediately` spécifie s'il convient d'ajouter ces nœuds immédiatement ou lors du prochain créneau de maintenance. + `Region`Spécifie la AWS région du cluster à laquelle vous souhaitez ajouter des nœuds. L'exemple suivant montre un appel à ajouter des nœuds à un cluster. **Example** ``` https://elasticache.us-west-2.amazonaws.com/ ?Action=ModifyCacheCluster &ApplyImmediately=true &NumCacheNodes=5 &CacheClusterId=my-cluster &Region=us-east-2 &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, consultez la rubrique ElastiCache API [https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_ModifyCacheCluster.html](https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_ModifyCacheCluster.html).