利用可能な Redis (クラスターモードが無効) クラスターを使用したレプリケーショングループの作成 - Amazon ElastiCache フォー・レディス

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

利用可能な 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-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

レプリケーショングループに追加するクラスターの名前。

クラスターの命名に関する制約は次のとおりです。

  • 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-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 (クラスターモードが無効) クラスターへのレプリカの追加 (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」を参照してください。