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 [Dimensionnement 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 ou pour ajouter des nœuds à votre cluster. ## À l'aide du ElastiCache Console de gestion AWS 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), le processus se déroule en deux étapes : ajoutez d'abord la réplication, puis ajoutez un nœud de réplication. **Rubriques** + [Pour ajouter une réplication à un cluster Valkey ou Redis OSS sans fragments](#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 sur 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 fragments** 1. Connectez-vous à Console de gestion AWS et ouvrez la ElastiCache console à l'adresse [ https://console.aws.amazon.com/elasticache/](https://console.aws.amazon.com/elasticache/). 1. Dans le volet de navigation, choisissez Clusters ** Valkey ** ou Clusters ** Redis OSS. ** 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 s'applique à un cluster Redis OSS dont la réplication n'est pas activée : + Il exécute Redis OSS, pas 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 à Console de gestion AWS et ouvrez la ElastiCache console à 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. [Dimensionnement 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 aucun fragment, suivez d'abord les étapes décrites à. [Pour ajouter une réplication à un cluster Valkey ou Redis OSS sans fragments](#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**
ScénariosOpérations en suspensNouvelle demandeRésultats
Scénario 1SuppressionSuppressionLa nouvelle demande de suppression, en attente ou immédiate, remplace la demande de suppression en attente.
Par exemple, si les nœuds 0001, 0003 et 0007 sont en attente de suppression et qu'une nouvelle demande de suppression des nœuds 0002 et 0004 est émise, seuls les nœuds 0002 et 0004 seront supprimés. Les nœuds 0001, 0003 et 0007 ne seront pas supprimés.
Scénario 2SuppressionCréerLa nouvelle demande de création, en attente ou immédiate, remplace la demande de suppression en attente.
Par exemple, si les nœuds 0001, 0003 et 0007 sont en attente de suppression et qu'une nouvelle demande de création d'un nœud est émise, un nouveau nœud sera créé et les nœuds 0001, 0003 et 0007 ne seront pas supprimés.
Scénario 3CréerSuppressionLa nouvelle demande de suppression, en attente ou immédiate, remplace la demande de création en attente.
Par exemple, s'il y a une demande en attente de création de deux nœuds et qu'une nouvelle demande est émise pour supprimer le nœud 0003, aucun nouveau nœud ne sera créé et le nœud 0003 sera supprimé.
Scénario 4CréerCréerLa nouvelle demande de création est ajoutée à la demande de création en attente.
Par exemple, s'il y a une demande en attente pour créer deux nœuds et qu'une nouvelle demande est émise pour créer trois nœuds, les nouvelles demandes sont ajoutées à la demande en attente et cinq nœuds seront créés.Si la nouvelle demande de création est définie sur Apply Immediately - Yes (Appliquer immédiatement. Oui), toutes les demandes de création sont exécutées immédiatement. Si la nouvelle demande de création est définie sur Apply Immediately - No (Appliquer immédiatement. Non), toutes les demandes de création sont en attente.
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é. ## Utilisation de 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 attend le paramètre `cache-node-ids-to-remove` et une liste de nœuds à supprimer du cluster. Pour de plus amples informations, veuillez consulter [Utilisation de 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.m5.large", "DataTiering": "disabled", } } ``` Pour plus d'informations, consultez la AWS CLI rubrique [`modify-cache-cluster`](https://docs.aws.amazon.com/cli/latest/reference/elasticache/modify-cache-cluster.html). ## Utilisation de AWS CLI avec ElastiCache Si vous souhaitez ajouter des nœuds à un cluster Valkey ou Redis OSS (mode cluster désactivé) existant 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 [`increase-replica-count`](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 (mode cluster désactivé) existant 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 cluster 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 [`IncreaseReplicaCount`](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 attend le paramètre `CacheNodeIdsToRemove` avec une liste de nœuds à supprimer 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 [`ModifyCacheCluster`](https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_ModifyCacheCluster.html).