将节点添加到群集 - Amazon ElastiCache for Redis

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

Topics

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

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

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

登录 Amazon Web Services Management Console并通过以下网址打开 ElastiCache 控制台：https://console.amazonaws.cn/elasticache/。
从导航窗格中，选择 Redis。

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

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

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

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

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

登录 Amazon Web Services Management Console并通过以下网址打开 ElastiCache 控制台：https://console.amazonaws.cn/elasticache/。
在导航窗格中，选择在您要添加节点的集群上运行的引擎。

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

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

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

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

新的添加和删除请求对待处理请求的影响
方案	待处理的操作	新请求	结果
场景 1	Delete	Delete	新的待处理或即时删除请求会取代待处理删除操作。例如，如果节点 0001、0003 和 0007 是待处理删除，并且发出了删除节点 0002 和 0004 的新请求，则仅删除节点 0002 和 0004。不会删除节点 0001、0003 和 0007。
场景 2	Delete	创建	新的待处理或即时创建请求会取代待处理删除操作。例如，如果节点 0001、0003 和 0007 是待处理删除，并且发出了创建节点的新请求，则将创建新节点，而且不会删除节点 0001、0003 和 0007。
场景 3	创建	Delete	新的待处理或即时删除请求会取代待处理创建操作。例如，如果有一个创建两个节点的待处理请求，并且发出了删除节点 0003 的新请求，则不会创建任何新节点，而且将删除节点 0003。
场景 4	创建	创建	新的创建请求会添加到待处理创建请求。例如，如果有一个创建两个节点的待处理请求，并且发出了创建三个节点的新请求，新请求会添加到待处理请求中，而且将创建五个节点。重要如果新的创建请求设置为 Apply Immediately - Yes (立即应用 - 是)，则会立即执行所有创建请求。如果新的创建请求设置为 Apply Immediately - No (立即应用 - 否)，所有创建请求将进入待处理状态。

要确定待处理的操作，请选择 Description (描述) 选项卡，然后查看所显示的待处理的创建或删除操作数。您不能同时拥有待处理的创建和删除操作。

选择 Add 按钮。

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

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

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

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

对于 Linux, OS X, or 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",
        "TransitEncryptionEnabled": false,
        "AtRestEncryptionEnabled": false,
        "ARN": "arn:aws:elasticache:us-west-2:123456789012:replicationgroup:node-test"
    }
}

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

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

(ElastiCache API) 向集群添加节点

按照以下参数调用 IncreaseReplicaCount API 操作：
- ReplicationGroupId 要将节点添加到的集群的 ID。
- NewReplicaCount NewReplicaCount 参数指定应用修改后此集群中应有的节点的数量。要向此集群添加节点，NewReplicaCount 必须大于此集群中的当前节点数。如果此值小于当前节点数，请使用DecreaseReplicaCountAPI，其中包含要从集群中移除的节点数。
- 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。