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

Pour reconfigurer votre cluster Valkey ou Redis OSS (mode cluster activé), voir Mise à l'échelle des clusters dans Valkey ou Redis OSS (mode cluster activé)

Vous pouvez utiliser la console ElastiCache de gestion, le AWS CLI ou ElastiCache API pour ajouter des nœuds à votre cluster.

Si vous souhaitez ajouter un nœud à un cluster Valkey ou Redis à nœud unique (mode cluster désactivé) OSS (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 OSS cluster Valkey ou Redis sans partitions
Pour ajouter des nœuds à un ElastiCache cluster (console)

La procédure suivante ajoute la réplication à un Valkey ou Redis à nœud unique pour lequel la réplication OSS 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 OSS cluster Valkey ou Redis sans partitions

Connectez-vous à la ElastiCache console AWS Management Console et ouvrez-la à l'adresse https://console.aws.amazon.com/elasticache/.
Dans le volet de navigation, choisissez Valkey clusters ou Redis OSS clusters.

La liste des clusters exécutant ce moteur s'affiche.
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 OSS cluster Redis pour lequel la réplication n'est pas activée :
- Il exécute RedisOSS, pas Redis clusterisé. OSS
- 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).
Choisissez Add replication.
Dans Ajouter une réplication, entrez une description pour ce cluster avec réplication activée.
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.

Connectez-vous à la ElastiCache console AWS Management Console et ouvrez-la à l'adresse https://console.aws.amazon.com/elasticache/.
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.
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 dans Valkey ou Redis OSS (mode cluster activé)

Si votre cluster est un cluster Valkey ou Redis OSS (mode cluster désactivé) ne contenant aucun fragment, effectuez d'abord les étapes indiquées sur. Pour ajouter une réplication à un OSS cluster Valkey ou Redis sans partitions
Choisissez Add node (Ajouter un nœud).
Saisissez les informations demandées dans la boîte de dialogue Add Node (Ajouter un nœud).

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énarios	Opérations en suspens	Nouvelle demande	Résultats
Scénario 1	Suppression	Suppression	La 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 2	Suppression	Création	La 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 3	Création	Suppression	La 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 4	Création	Création	La 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. Important 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.

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

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 de cache 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.
--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 un résultat similaire au suivant (JSONformat) :


{
    "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 modify-cache-cluster.

Si vous souhaitez ajouter des nœuds à un cluster Valkey ou Redis existant OSS (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 de OSS cache Valkey ou Redis disponible ()AWS 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 un résultat similaire au suivant (JSONformat) :


{
    "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.

Si vous souhaitez ajouter des nœuds à un cluster Valkey ou Redis existant OSS (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 autonome Valkey ou Redis OSS (mode cluster désactivé) () ElastiCache 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'IncreaseReplicaCountAPIopération 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 le DecreaseReplicaCount API avec le nombre de nœuds à supprimer du cluster.
- ApplyImmediately spécifie s'il convient d'ajouter ces nœuds immédiatement ou lors du prochain créneau de maintenance.
- RegionSpé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.
```
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=<credential>
    &X-Amz-Signature=<signature>
```

Pour plus d'informations, consultez la ElastiCache API rubrique IncreaseReplicaCount.

Pour ajouter des nœuds à un cluster (ElastiCache API)

Appelez l'ModifyCacheClusterAPIopération 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 (voirUtilisation du ElastiCache API avec Memcached).
- ApplyImmediately spécifie s'il convient d'ajouter ces nœuds immédiatement ou lors du prochain créneau de maintenance.
- RegionSpé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.
```
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=<credential>
    &X-Amz-Signature=<signature>
```

Pour plus d'informations, consultez la ElastiCache API rubrique ModifyCacheCluster.

Avertissement JavaScript est désactivé ou n'est pas disponible dans votre navigateur.

Pour que vous puissiez utiliser la documentation AWS, Javascript doit être activé. Vous trouverez des instructions sur les pages d'aide de votre navigateur.

Conventions de rédaction

Modification d'un ElastiCache cluster

Supprimer des nœuds d'un ElastiCache cluster

Ajouter des nœuds à un ElastiCache cluster

Rubriques

Pour ajouter une réplication à un OSS cluster Valkey ou Redis sans partitions

Pour ajouter des nœuds à un ElastiCache cluster (console)

Important

Pour ajouter des nœuds à un cluster (ElastiCache API)

Pour ajouter des nœuds à un cluster (ElastiCache API)