View a markdown version of this page

将 Valkey 或 Redis OSS（已禁用集群模式）复制组的只读副本提升为主节点 - Amazon ElastiCache
使用 AWS 管理控制台使用 AWS CLI使用 ElastiCache API

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

将 Valkey 或 Redis OSS（已禁用集群模式）复制组的只读副本提升为主节点

以下主题中的信息仅适用于 Valkey 或 Redis OSS（已禁用集群模式）复制组。

您可以使用、或 API 将 Valkey 或 Redis OSS（已禁用集群模式）只读副本提升为 AWS CLI主副本。 AWS 管理控制台 ElastiCache 在复制组上启用自动故障转移的情况下 Multi-AZ ，您无法将只读副本提升为主副本。要在已 Multi-AZ 启用的复制组上将 Valkey 或 Redis OSS（已禁用集群模式）副本提升为主副本，请执行以下操作：

  1. 将复制组修改为禁用 Multi-AZ （这样做不需要您的所有集群都位于同一个可用区中）。有关更多信息，请参阅 修改复制组。

  2. 将只读副本提升为主集群。

  3. 修改要重新启 Multi-AZ用的复制组。

Multi-AZ 在运行 Redis OSS 2.6.13 或更早版本的复制组上不可用。

使用 AWS 管理控制台

以下过程使用控制台将副本节点提升为主集群。

将只读副本提升为主节点（控制台）

  1. 登录 AWS 管理控制台 并打开 ElastiCache 控制台，网址为https://console.aws.amazon.com/elasticache/。

  2. 如果您要提升的副本是启用的 Valkey 或 Redis OSS（已禁用集群模式）复制组的成员，请在继续操作 Multi-AZ之前将复制组修改为禁用。 Multi-AZ 有关更多信息，请参阅 修改复制组。

  3. 选择 Valkey 或 Redis OSS，然后从集群列表中选择要修改的复制组。该复制组必须运行“Redis”引擎，而不是“集群化 Redis”引擎，而且必须具有 2 个或更多个节点。

  4. 从节点列表中，选择要提升为主集群的副本节点，然后对于 Actions (操作)，选择 Promote (提升)。

  5. 在 Promote Read Replica (提升只读副本) 对话框中，执行以下操作：

    1. 对于 Apply Immediately (立即应用)，选择 Yes (是) 立即提升只读副本，或者选择 No (否) 在集群的下一维护时段提升它。

    2. 选择 Promote 提升只读副本，或选择 Cancel 取消该操作。

  6. 如果群集在您开始升级过程之前 Multi-AZ 已启用，请等到复制组的状态变为可用，然后修改群集以重新启用 Multi-AZ。有关更多信息，请参阅 修改复制组。

使用 AWS CLI

如果 Multi-AZ启用了复制组，则无法将只读副本提升为主副本。在某些情况下，您要升级的副本可能是已启用的复制组的成员。 Multi-AZ 在这些情况下，必须先将复制组修改为禁用， Multi-AZ 然后才能继续。执行此操作不要求所有集群都位于同一个可用区。有关修改复制组的更多信息，请参阅修改复制组。

以下 AWS CLI 命令修改复制组sample-repl-group，使只读副本成为复制组my-replica-1中的主副本。

对于 Linux、macOS 或 Unix：

aws elasticache modify-replication-group \
   --replication-group-id sample-repl-group \
   --primary-cluster-id my-replica-1

对于 Windows：

aws elasticache modify-replication-group ^
   --replication-group-id sample-repl-group ^
   --primary-cluster-id my-replica-1

有关修改复制组的更多信息，请参阅《Amazon ElastiCache 命令行参考》modify-replication-group中的。

使用 ElastiCache API

如果 Multi-AZ启用了复制组，则无法将只读副本提升为主副本。在某些情况下，您要升级的副本可能是已启用的复制组的成员。 Multi-AZ 在这些情况下，必须先将复制组修改为禁用， Multi-AZ 然后才能继续。执行此操作不要求所有集群都位于同一个可用区。有关修改复制组的更多信息，请参阅修改复制组。

以下 ElastiCache API 操作修改复制组myReplGroup，使只读副本成为复制组myReplica-1中的主副本。

https://elasticache.us-west-2.amazonaws.com/
   ?Action=ModifyReplicationGroup
   &ReplicationGroupId=myReplGroup
   &PrimaryClusterId=myReplica-1  
   &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>

有关修改复制组的更多信息，请参阅 Amazon ElastiCache API 参考ModifyReplicationGroup中的。