翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

既存のクラスターを使用したレプリケーショングループの作成

使用可能なクラスターは、既存の単一ノードの Valkey または Redis OSS クラスターです。現時点では、Valkey または Redis OSS (クラスターモードが有効) では使用可能な単一ノードのクラスターを使用して、レプリカを持つクラスターを作成することはできません。Valkey または Redis OSS (クラスターモードが有効) クラスターを作成する場合は、「Valkey または Redis OSS (クラスターモードが有効) クラスターの作成 (コンソール）」を参照してください。

次の手順は、単一ノードの Valkey または Redis OSS (クラスターモードが無効) クラスターがある場合に限り使用できます。このノードは新しいクラスターのプライマリノードになります。新しいクラスターのプライマリとして使用できる Valkey または Redis OSS (クラスターモードが無効) クラスターがない場合は、「Valkey または Redis OSS レプリケーショングループを最初から作成する」を参照してください。

既存のクラスターを使用したレプリケーショングループの作成 (コンソール)

トピック「ElastiCache AWS Management Console の使用」を参照してください。

使用可能な Valkey または Redis OSS キャッシュクラスターを使用したレプリケーショングループの作成 (AWS CLI)

AWS CLI を使う場合、使用可能な Valkey または Redis OSS キャッシュクラスターをプライマリとして、リードレプリカを持つレプリケーショングループを作成するには 2 つのステップがあります。

AWS CLI を使用する場合、CLI コマンド create-replication-group を使用して、クラスターのプライマリノードとして使用可能なスタンドアロンノードを指定して (--primary-cluster-id)、クラスター内に含めるノードの数を指定し、レプリケーショングループを作成します。以下のパラメータを含めます。

次のコマンドは、レプリケーショングループのプライマリノードとして使用できる Valkey または Redis OSS (クラスターモードが無効) クラスター redis01 を使用して、レプリケーショングループ sample-repl-group を作成します。リードレプリカとなる 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 コマンドを使用して、そのグループに 1 〜 5 個のリードレプリカを追加します。その際に、以下のパラメータを必ず含めます。

レプリケーショングループに追加するそれぞれのリードレプリカで、このコマンドを --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 のトピックを参照してください。

スタンドアロンの Valkey または Redis OSS (クラスターモードが無効) クラスターにレプリカを追加する (ElastiCache API)

ElastiCache API を使用する場合、CLI コマンド CreateReplicationGroup を使用して、クラスターのプライマリノードとして使用可能なスタンドアロンノードを指定して (PrimaryClusterId)、クラスター内に含めるノードの数を指定し、レプリケーショングループを作成します。以下のパラメータを含めます。

次のコマンドは、レプリケーショングループのプライマリノードとして使用できる Valkey または Redis OSS (クラスターモードが無効) クラスター redis01 を使用して、レプリカ sample-repl-group を持つクラスターを作成します。リードレプリカとなる 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 オペレーションを使用して、そのグループに 1 〜 5 個のリードレプリカを追加します。その際に、以下のパラメータを必ず含めます。

レプリケーショングループに追加するリードレプリカごとに、このオペレーションを繰り返します。その際に、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」を参照してください。