向集群添加节点

要重新配置 Redis（已启用集群模式）集群，请参阅扩展 Redis（启用集群模式）集群

您可以使用 ElastiCache 管理控制台、Amazon CLI 或 ElastiCache API 向集群添加节点。

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

主题

向没有分片的 Redis 集群添加复制
向集群添加节点（控制台）

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

向没有分片的 Redis 集群添加复制

登录 Amazon Web Services Management Console 并打开 ElastiCache 控制台 (https://console.aws.amazon.com/elasticache/)。
从导航窗格中，选择 Redis clusters（Redis 集群）。

此时会显示运行 Redis 引擎的集群列表。
选择要将节点添加到的集群的名称，而不是集群名称左侧的框。

未启用复制的 Redis 集群满足以下条件：
- 它运行的是 Redis，而不是 Clustered Redis。
- 它有零个分片。
  
  如果该集群有任何分片、已启用复制，则您可以在向集群添加节点（控制台）处继续。
选择 Add replication。
在添加复制中，为该启用复制的集群输入说明。
选择 Add（添加）。

一旦该集群的状态恢复为 available，您就可以在下一个流程中继续，并向该集群中添加副本。

向集群添加节点（控制台）

以下步骤可用于将节点添加到集群。

登录 Amazon Web Services Management Console 并打开 ElastiCache 控制台 (https://console.aws.amazon.com/elasticache/)。
在导航窗格中，选择在您要添加节点的集群上运行的引擎。

此时会显示运行所选引擎的集群的列表。
从集群列表中，对于要向其添加节点的集群，选择其名称。

如果您的集群是 Redis（已启用集群模式）集群，请参阅扩展 Redis（启用集群模式）集群。

如果您的集群是具有零个分区的 Redis（已禁用集群模式）集群，请先完成向没有分片的 Redis 集群添加复制中的步骤。
选择 Add node。
在 Add Node (添加节点) 对话框中，填写请求的信息。

选择 Apply Immediately - Yes (立即应用 - 是) 按钮立即添加此节点，或选择 No (否) 在集群的下一个维护时段添加此节点。

新添加和删除请求对待处理请求的影响
场景	待处理的操作	新建请求	结果
方案 1	删除	删除	新的删除请求（待处理或立即）将替换待处理的删除请求。例如，如果节点 0001、0003 和 0007 处于等待删除状态，同时发出了删除节点 0002 和 0004 的新请求，则只删除节点 0002 和 0004。节点 0001、0003 和 0007 不会被删除。
方案 2	删除	创建	新的创建请求（待处理或立即）将替换待处理的删除请求。例如，如果节点 0001、0003 和 0007 处于等待删除状态，同时发出了创建节点的新请求，则会创建一个新节点，节点 0001、0003 和 0007 不会被删除。
方案三	创建	删除	新的删除请求（待处理或立即）将替换待处理的创建请求。例如，如果存在创建两个节点的待处理请求，同时发出了删除节点 0003 的新请求，则不会创建新节点，节点 0003 会被删除。
方案 4	创建	创建	新创建请求将添加到待处理创建请求中。例如，如果存在创建两个节点的待处理请求，同时发出了创建三个节点的新请求，则新请求将添加到待处理请求中，并将创建五个节点。重要如果新创建请求设置为 Apply Immediately - Yes（立即应用 – 是），则立即执行所有创建请求。如果新创建请求设置为 Apply Immediately - No（立即应用 – 否），则所有创建请求为待处理。

要确定哪些操作处于待处理状态，请选择 Description（描述）选项卡，然后查看显示了多少待处理的创建或删除操作。您不能同时拥有待处理的创建操作和待处理的删除操作。

选择 Add 按钮。

片刻之后，新的节点应会出现在节点列表中，其状态为 creating。若非如此，请刷新浏览器页面。当节点的状态更改为 available 时，便可以使用新节点。

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

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

--replication-group-id 要添加节点的复制组的 ID。
--new-replica-count 指定应用修改后此复制组中应有的节点的数量。要向此集群添加节点，--new-replica-count 必须大于此集群中的当前节点数。
--apply-immediately 或 --no-apply-immediately，用于指定是立即添加这些节点还是在下一维护时段添加这些节点。

对于 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。

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

向集群添加节点 (ElastiCache API)

按照以下参数调用 IncreaseReplicaCount API 操作：
- ReplicationGroupId 要将节点添加到的集群的 ID。
- NewReplicaCount NewReplicaCount 参数指定应用修改后此集群中应有的节点的数量。要向此集群添加节点，NewReplicaCount 必须大于此集群中的当前节点数。如果此值小于当前节点数，请使用 DecreaseReplicaCount API 以及要从集群中移除的节点数量。
- ApplyImmediately 指定是立即添加这些节点还是在下一维护时段添加这些节点。
- Region 指定要添加节点的集群的 Amazon 区域。
以下示例演示向集群添加节点的调用。
```
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>
```

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

Javascript 在您的浏览器中被禁用或不可用。

要使用 Amazon Web Services 文档，必须启用 Javascript。请参阅浏览器的帮助页面以了解相关说明。

修改集群

从集群中移除节点

向集群添加节点

主题

向没有分片的 Redis 集群添加复制

向集群添加节点（控制台）

重要

向集群添加节点 (ElastiCache API)