使用現有叢集建立複寫群組使用可用的 Redis OSS 快取叢集建立複寫群組 ()AWS CLI 將複本新增至獨立 Redis OSS (已停用叢集模式) 叢集 (API) ElastiCache

使用可用的 Redis OSS (已停用叢集模式) 叢集建立複寫群組

可用叢集是現有的單節點 Redis OSS 叢集。目前，Redis OSS (已啟用叢集模式) 不支援使用可用的單一節點叢集建立具有複本的叢集。如果您想要建立 Redis OSS (已啟用叢集模式) 叢集，請參閱。建立 Redis OSS (已啟用叢集模式) 叢集 (主控台)

只有在 Redis OSS (叢集模式停用) 單節點叢集時，才能使用下列程序。此叢集的節點會成為新叢集中的主要節點。如果您沒有可作為新叢集的主叢集使用的 Redis OSS (叢集模式停用) 叢集，請參閱。從頭開始建立 Redis 的 OSS 複寫群組

使用可用的 Redis OSS 叢集 (主控台) 建立複寫群組

請參閱主題：使用 AWS Management Console。

使用可用的 Redis OSS 快取叢集建立複寫群組 ()AWS CLI

使用可用的 Redis OSS 快取叢集作為主要伺服器時，使用僅供讀取複本建立複寫群組的複寫群組有兩個步驟。 AWS CLI

使用時， AWS CLI 您可以建立一個複寫群組，將可用的獨立節點指定為叢集的主要節點，--primary-cluster-id並使用 CLI 指令建立叢集中所需的節點數目create-replication-group。包含以下參數。

--replication-group-id

您要建立的複寫群組名稱。此參數的值會用來做為新增節點名稱的基礎，並在 --replication-group-id 的結尾加上 3 位數的序號。例如 sample-repl-group-001。

Redis OSS (叢集模式已停用) 複寫群組命名條件約束如下所示：

必須包含 1-40 個英數字元或連字號。
必須以字母開頭。
不能連續包含兩個連字號。
結尾不能是連字號。

--replication-group-description

複寫群組的說明。

--num-node-groups

此叢集中的您希望的節點數量。此值包含主要節點。此參數的最大值為 6。

--primary-cluster-id

要作為此複寫群組中主要節點之可用 Redis OSS (叢集模式已停用) 叢集節點的名稱。

下列命令會使用可sample-repl-group用的 Redis OSS (叢集模式已停用) 叢集redis01作為複寫群組的主要節點來建立複寫群組。它會建立 2 個新節點 (皆為僅供讀取複本)。redis01 的設定 (即參數群組、安全群組、節點類型、引擎版本等) 會套用到所有複寫群組中的節點。

若為 Linux、macOS 或 Unix：


aws elasticache create-replication-group \
   --replication-group-id sample-repl-group \
   --replication-group-description "demo cluster with replicas" \
   --num-cache-clusters 3 \
   --primary-cluster-id redis01

針對 Windows：


aws elasticache create-replication-group ^
   --replication-group-id sample-repl-group ^
   --replication-group-description "demo cluster with replicas" ^
   --num-cache-clusters 3 ^
   --primary-cluster-id redis01

如需您可能想要使用的其他資訊和參數，請參閱 AWS CLI 主題create-replication-group。

接下來，將僅供讀取複本新增到複寫群組

在建立複寫群組之後，使用 create-cache-cluster 命令將一到五個僅供讀取複本新增到其中，並確認包含以下參數。

--cache-cluster-id

您欲新增到複寫群組的叢集名稱。

叢集命名限制條件如下：

必須包含 1-40 個英數字元或連字號。
必須以字母開頭。
不能連續包含兩個連字號。
結尾不能是連字號。

--replication-group-id

您要將此快取叢集新增到其中的複寫群組名稱。

針對每個您欲新增到複寫群組的僅供讀取複本重複此命令，並只變更 --cache-cluster-id 參數的值。

注意

請記住，複寫群組無法擁有超過五個僅供讀取複本。嘗試將僅供讀取複本新增到已有五個僅供讀取複本的複寫群組，會造成操作失敗。

以下程式碼會將僅供讀取複本 my-replica01 新增到複寫群組 sample-repl-group。主要叢集的設定 (參數群組、安全群組、節點類型等) 會在新增到複寫群組時套用到節點。

若為 Linux、macOS 或 Unix：


aws elasticache create-cache-cluster \
   --cache-cluster-id my-replica01 \
   --replication-group-id sample-repl-group

針對 Windows：


aws elasticache create-cache-cluster ^
   --cache-cluster-id my-replica01 ^
   --replication-group-id sample-repl-group

此命令的輸出看起來會與以下內容相似。


{
    "ReplicationGroup": {
        "Status": "creating",
        "Description": "demo cluster with replicas",
        "ClusterEnabled": false,
        "ReplicationGroupId": "sample-repl-group",
        "SnapshotRetentionLimit": 1,
        "AutomaticFailover": "disabled",
        "SnapshotWindow": "00:00-01:00",
        "SnapshottingClusterId": "redis01",
        "MemberClusters": [
            "sample-repl-group-001",
            "sample-repl-group-002",
            "redis01"
        ],
        "CacheNodeType": "cache.m4.large",
        "DataTiering": "disabled",
        "PendingModifiedValues": {}
    }
}

如需其他資訊，請參閱以下 AWS CLI 主題：

將複本新增至獨立 Redis OSS (已停用叢集模式) 叢集 (API) ElastiCache

使用 ElastiCache API 時，您可以建立一個複寫群組，將可用的獨立節點指定為叢集的主要節點，PrimaryClusterId並使用 CLI 指令建立叢集中所需的節點數目CreateReplicationGroup。包含以下參數。

ReplicationGroupId

您要建立的複寫群組名稱。此參數的值會用來做為新增節點名稱的基礎，並在 ReplicationGroupId 的結尾加上 3 位數的序號。例如 sample-repl-group-001。

Redis OSS (叢集模式已停用) 複寫群組命名條件約束如下所示：

必須包含 1-40 個英數字元或連字號。
必須以字母開頭。
不能連續包含兩個連字號。
結尾不能是連字號。

ReplicationGroupDescription

包含複本的叢集說明。

NumCacheClusters

此叢集中的您希望的節點數量。此值包含主要節點。此參數的最大值為 6。

PrimaryClusterId

要作為此叢集中主要節點之可用 Redis OSS (叢集模式已停用) 叢集的名稱。

下列命令會使用可用的 Redis OSS (已停sample-repl-group用叢集模式) 叢集作為複寫群組的主要節點來建立具有複本的叢集redis01。它會建立 2 個新節點 (皆為僅供讀取複本)。redis01 的設定 (即參數群組、安全群組、節點類型、引擎版本等) 會套用到所有複寫群組中的節點。


https://elasticache.us-west-2.amazonaws.com/
   ?Action=CreateReplicationGroup 
   &Engine=redis
   &EngineVersion=6.0
   &ReplicationGroupDescription=Demo%20cluster%20with%20replicas
   &ReplicationGroupId=sample-repl-group
   &PrimaryClusterId=redis01
   &Version=2015-02-02
   &SignatureVersion=4
   &SignatureMethod=HmacSHA256
   &Timestamp=20150202T192317Z
   &X-Amz-Credential=<credential>

如需其他資訊，請參閱 ElastiCache APL 主題：

接下來，將僅供讀取複本新增到複寫群組

在建立複寫群組之後，使用 CreateCacheCluster 操作將一到五個僅供讀取複本新增到其中，並確認包含以下參數。

CacheClusterId

您欲新增到複寫群組的叢集名稱。

叢集命名限制條件如下：

必須包含 1-40 個英數字元或連字號。
必須以字母開頭。
不能連續包含兩個連字號。
結尾不能是連字號。

ReplicationGroupId

您要將此快取叢集新增到其中的複寫群組名稱。

針對每個您欲新增到複寫群組的僅供讀取複本重複此操作，並只變更 CacheClusterId 參數的值。

以下程式碼會將僅供讀取複本 (myReplica01) 新增到複寫群組 (myReplGroup)。主要叢集的設定 (參數群組、安全群組、節點類型等) 會在新增到複寫群組時套用到節點。


https://elasticache.us-west-2.amazonaws.com/
	?Action=CreateCacheCluster
	&CacheClusterId=myReplica01
	&ReplicationGroupId=myReplGroup
	&SignatureMethod=HmacSHA256
	&SignatureVersion=4
	&Version=2015-02-02
	&X-Amz-Algorithm=&AWS;4-HMAC-SHA256
	&X-Amz-Credential=[your-access-key-id]/20150202/us-west-2/elasticache/aws4_request
	&X-Amz-Date=20150202T170651Z
	&X-Amz-SignedHeaders=content-type;host;user-agent;x-amz-content-sha256;x-amz-date
	&X-Amz-Signature=[signature-value]

如需您可能想要使用的其他資訊和參數，請參閱 ElastiCache API 主題CreateCacheCluster。

您的瀏覽器已停用或無法使用 Javascript。

您必須啟用 Javascript，才能使用 AWS 文件。請參閱您的瀏覽器說明頁以取得說明。

文件慣用形式

建立複寫群組

從頭開始建立 Redis 的 OSS 複寫群組