Ajout de nœuds à un cluster

Pour reconfigurer votre cluster Redis (mode cluster activé), veuillez consulter Mise à l'échelle des clusters dans Redis (Mode Cluster activé)

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

Si vous voulez ajouter un nœud à un cluster Redis (mode cluster désactivé) à nœud unique (sans réplication activée), le processus compte deux étapes : vous ajoutez d'abord la réplication, puis un nœud de réplica.

Rubriques

Pour ajouter une réplication à un cluster Redis sans partition
Pour ajouter des nœuds à un cluster (console)

La procédure suivante ajoute la réplication à un Redis à 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 Redis sans partition

Connectez-vous à la AWS Management Console et ouvrez la console ElastiCache à l'adresse https://console.aws.amazon.com/elasticache/.
Dans le panneau de navigation, choisissez Redis clusters (Clusters Redis).

Une liste de clusters qui exécutent le moteur Redis s'affiche.
Choisissez le nom d'un cluster, pas la case à gauche du nom du cluster, auquel vous souhaitez ajouter des nœuds.

Un cluster Redis qui n'a pas la réplication est activée présente les caractéristiques suivantes :
- Il exécute Redis, et non Redis 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 cluster (console).
Choisissez Add replication.
Dans Ajouter une réplication, entrez une description pour ce cluster avec réplication activée.
Choisissez Add (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 cluster (console)

La procédure suivante peut être utilisée pour ajouter des nœuds à un cluster.

Connectez-vous à la AWS Management Console et ouvrez la console ElastiCache à 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 Redis (mode cluster activé), veuillez consulter Mise à l'échelle des clusters dans Redis (Mode Cluster activé).

Si votre cluster est un cluster Redis (mode cluster désactivé) ne contenant aucune partition, commencez par suivre les étapes indiquées dans Pour ajouter une réplication à un cluster Redis sans partition.
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	Delete	Delete	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	Delete	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	Delete	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é.

Si vous souhaitez ajouter des nœuds à un cluster Redis (mode cluster désactivé) existant pour lequel 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 Création d'un groupe de réplication à l'aide d'un cluster de cache 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 l'AWS CLI, utilisez l'opération increase-replica-count de l'AWS CLI 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 de plus amples informations, consultez la rubrique AWS CLI increase-replica-count.

Si vous souhaitez ajouter des nœuds à un cluster Redis (mode cluster désactivé) existant pour lequel 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 Redis autonome (mode cluster désactivé) (API) ElastiCache . Une fois que le groupe de réplication est disponible, vous pouvez passer au processus suivant.

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

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 région AWS du cluster auquel 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, veuillez consulter la rubrique de référence de l'API ElastiCache IncreaseReplicaCount.

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 cluster

Suppression de nœuds d'un cluster

Ajout de nœuds à un cluster

Rubriques

Pour ajouter une réplication à un cluster Redis sans partition

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

Important

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