翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
利用可能な Redis (クラスターモードが無効) クラスターを使用したレプリケーショングループの作成
使用可能なクラスターは、単一ノードの Redis クラスターです。現時点では、Redis (クラスターモードが有効) では使用可能な単一ノードのクラスターを使用して、レプリカを持つクラスターを作成することはできません。Redis (クラスターモードが有効) クラスターを作成する場合は、「Redis (クラスターモードが有効) クラスターの作成 (コンソール)」を参照してください。
次の手順は、単一ノードの Redis (クラスターモードが無効) クラスターがある場合に限り使用できます。このノードは新しいクラスターのプライマリノードになります。新しいクラスターのプライマリとして使用できる Redis (クラスターモードが無効) クラスターがない場合は、「ゼロからの Redis レプリケーショングループの作成」を参照してください。
利用可能な Redis クラスターを使用したレプリケーショングループの作成 (コンソール)
トピック「AWS Management Console を使用する場合」を参照してください。
使用可能な Redis キャッシュクラスターを使用したレプリケーショングループの作成 (AWS CLI)
AWS CLI を使う場合、使用可能な Redis キャッシュクラスターをプライマリとして、リードレプリカを持つレプリケーショングループを作成するには 2 つのステップがあります。
AWS CLI を使用する場合、CLI コマンド create-replication-group
を使用して、クラスターのプライマリノードとして使用可能なスタンドアロンノードを指定して (--primary-cluster-id
)、クラスター内に含めるノードの数を指定し、レプリケーショングループを作成します。以下のパラメータを含めます。
- --replication-group-id
作成するレプリケーショングループの名前。このパラメータの値が追加されたノードの名前の基礎として使用され、3 桁の連番が
--replication-group-id
の末尾に追加されます。例えば、sample-repl-group-001
です。Redis (クラスターモードが無効) レプリケーショングループの命名に関する制約は、次のとおりです。
1~40 個の英数字またはハイフンを使用する必要があります。
先頭は文字を使用する必要があります。
連続する 2 つのハイフンを含めることはできません。
ハイフンで終わることはできません。
- --replication-group-description
レプリケーショングループの説明。
- --num-node-groups
このクラスターに必要なノードの数。この値はプライマリノードを含みます。このパラメータの最大値は 6 です。
- --primary-cluster-id
このレプリケーショングループのプライマリノードにする、使用可能な Redis (クラスターモードが無効) クラスターの名前。
次のコマンドは、レプリケーショングループ sample-repl-group
を作成します。レプリケーショングループのプライマリノードとして使用できる Redis (クラスターモードが無効) クラスター 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-clusters3
\ --primary-cluster-idredis01
Windows の場合:
aws elasticache create-replication-group ^ --replication-group-id
sample-repl-group
^ --replication-group-description"demo cluster with replicas"
^ --num-cache-clusters3
^ --primary-cluster-idredis01
使用するパラメータおよび追加情報については、AWS CLI トピックの「create-replication-group」を参照してください。
次に、リードレプリカをレプリケーショングループに追加します。
レプリケーショングループの作成後に、create-cache-cluster
コマンドを使用して、そのグループに 1 〜 5 個のリードレプリカを追加します。その際に、以下のパラメータを必ず含めます。
- --cache-cluster-id
レプリケーショングループに追加するクラスターの名前。
クラスターの命名に関する制約は次のとおりです。
1~40 個の英数字またはハイフンを使用する必要があります。
先頭は文字を使用する必要があります。
連続する 2 つのハイフンを含めることはできません。
ハイフンで終わることはできません。
- --replication-group-id
このキャッシュクラスターに追加するレプリケーショングループの名前。
レプリケーショングループに追加するそれぞれのリードレプリカで、このコマンドを --cache-cluster-id
パラメータの値のみを変更して繰り返します。
注記
レプリケーショングループに追加できるリードレプリカの数は 5 個までです。すでに 5 個のリードレプリカを持つレプリケーショングループに別のリードレプリカを追加しようとすると、オペレーションが失敗します。
次のコードは、リードレプリカ my-replica01
をレプリケーショングループ sample-repl-group
に追加します。プライマリクラスター–パラメータグループ、セキュリティグループ、ノードタイプなどの設定は、レプリケーショングループに追加されるノードに適用されます。
Linux、macOS、Unix の場合:
aws elasticache create-cache-cluster \ --cache-cluster-id
my-replica01
\ --replication-group-idsample-repl-group
Windows の場合:
aws elasticache create-cache-cluster ^ --cache-cluster-id
my-replica01
^ --replication-group-idsample-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 (クラスターモードが無効) クラスターへのレプリカの追加 (ElastiCache API)
ElastiCache API を使用する場合、CLI コマンド CreateReplicationGroup
を使用して、クラスターのプライマリノードとして使用可能なスタンドアロンノードを指定して (PrimaryClusterId
)、クラスター内に含めるノードの数を指定し、レプリケーショングループを作成します。以下のパラメータを含めます。
- ReplicationGroupId
作成するレプリケーショングループの名前。このパラメータの値が追加されたノードの名前の基礎として使用され、3 桁の連番が
ReplicationGroupId
の末尾に追加されます。例えば、sample-repl-group-001
です。Redis (クラスターモードが無効) レプリケーショングループの命名に関する制約は、次のとおりです。
1~40 個の英数字またはハイフンを使用する必要があります。
先頭は文字を使用する必要があります。
連続する 2 つのハイフンを含めることはできません。
ハイフンで終わることはできません。
- ReplicationGroupDescription
レプリカを持つクラスターの説明。
- NumCacheClusters
このクラスターに必要なノードの数。この値はプライマリノードを含みます。このパラメータの最大値は 6 です。
- PrimaryClusterId
このクラスター内のプライマリノードにする Redis (クラスターモード無効) クラスターの名前。
次のコマンドは、レプリカを持つクラスター sample-repl-group
を作成します。レプリケーショングループのプライマリノードとして使用できる Redis (クラスターモードが無効) クラスター 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
オペレーションを使用して、そのグループに 1 〜 5 個のリードレプリカを追加します。その際に、以下のパラメータを必ず含めます。
- CacheClusterId
レプリケーショングループに追加するクラスターの名前。
クラスターの命名に関する制約は次のとおりです。
1~40 個の英数字またはハイフンを使用する必要があります。
先頭は文字を使用する必要があります。
連続する 2 つのハイフンを含めることはできません。
ハイフンで終わることはできません。
- 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」を参照してください。