向 ElastiCache 集群添加节点

将节点添加到单节点 Valkey 或 Redis OSS（已禁用集群模式）集群（未启用复制的集群）是包含两个步骤的流程：首先添加复制，然后添加副本节点。

下面的过程可向未启用复制的单节点 Valkey 或 Redis OSS 添加复制。在添加复制时，现有的节点将成为启用复制的集群中的主节点。添加复制后，您可以向该集群添加最多 5 个副本节点。

要使用 Amazon CLI 向集群添加节点，请使用带以下参数的 Amazon CLI 操作 modify-cache-cluster：

对于 Linux、macOS 或 Unix：

aws elasticache modify-cache-cluster \
    --cache-cluster-id my-cluster \
    --num-cache-nodes 5 \
    --apply-immediately

对于 Windows：

aws elasticache modify-cache-cluster ^
    --cache-cluster-id my-cluster ^
    --num-cache-nodes 5 ^
    --apply-immediately

此操作将生成类似于以下内容的输出（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",
    }
}

有关更多信息，请参阅 Amazon CLI 主题 modify-cache-cluster。

如果要向未启用复制的现有 Valkey 或 Redis OSS（已禁用集群模式）集群添加节点，则必须先创建将该现有集群指定为主集群的复制组。有关更多信息，请参阅 使用可用 Valkey 或 Redis OSS 缓存集群创建复制组（Amazon CLI）。待该复制组为 available（可用）后，您可以继续下面的流程。

要使用 Amazon CLI 向集群添加节点，请使用带以下参数的 Amazon CLI 操作 increase-replica-count：

对于 Linux、macOS 或 Unix：

aws elasticache increase-replica-count \
    --replication-group-id my-replication-group \
    --new-replica-count 4 \
    --apply-immediately

对于 Windows：

aws elasticache increase-replica-count ^
    --replication-group-id my-replication-group ^
    --new-replica-count 4 ^
    --apply-immediately

此操作将生成类似于以下内容的输出（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"
    }
}

有关更多信息，请参阅 Amazon CLI 主题 increase-replica-count。

如果要向未启用复制的现有 Valkey 或 Redis OSS（已禁用集群模式）集群添加节点，则必须先创建将该现有集群指定为主集群的复制组。有关更多信息，请参阅 将副本添加到独立 Valkey 或 Redis OSS（已禁用集群模式）集群（ElastiCache API）。待该复制组为 available（可用）后，您可以继续下面的流程。

有关更多信息，请参阅 ElastiCache API 主题 IncreaseReplicaCount。

有关更多信息，请参阅 ElastiCache API 主题 ModifyCacheCluster。