AWS ドキュメント » Amazon ElastiCache » Redis 用 ElastiCache ユーザーガイド » Redis 用 ElastiCache の実装の管理 » レプリケーショングループを使用する高可用性 » Redis レプリケーショングループの作成 » ゼロからの Redis レプリケーショングループの作成 » ゼロからの Redis (クラスターモードが有効) レプリケーショングループの作成

ゼロからの Redis (クラスターモードが有効) レプリケーショングループの作成

ElastiCache コンソール、AWS CLI、または ElastiCache API を使用して、Redis (クラスターモードが有効) クラスター (API/CLI: レプリケーショングループ) を作成できます。Redis (クラスターモードが有効) レプリケーショングループは、1 〜 90 個のシャード (API/CLI: ノードグループ) で構成され、各シャードには、1 つのプライマリクラスターと、最大 5 個のリードレプリカが含まれます。シャードの数が多くレプリカの数が少ないクラスターを作成できます。クラスターあたり最大 90 ノードです。このクラスター設定は、シャード 90 個およびレプリカ 0 個からシャード 15 個およびレプリカ 5 個 (許容されるレプリカの最大数) までです。

注記

ノードまたはシャード制限は、クラスターあたり 250 まで増やすことができます。この制限の拡大をリクエストするには、「AWS サービスの制限」を参照し、制限タイプ「インスタンスタイプごとのクラスターあたりのノード」を選択します。

Redis (クラスターモードが有効) クラスターの作成 ((コンソール))

Redis (クラスターモードが有効) クラスターを作成するには、「Redis (クラスターモードが有効) クラスターの作成 ((コンソール))」を参照してください。クラスターモード ([Cluster Mode enabled (Scale Out)]) を必ず有効にし、それぞれに最低 2 つのシャードと 1 つのレプリカノードを指定します。

ゼロからの Redis (クラスターモードが有効) レプリケーショングループの作成 ((AWS CLI))

次の手順では、AWS CLI を使用して Redis (クラスターモードが有効) レプリケーショングループを作成します。

Redis (クラスターモードが有効) レプリケーショングループを最初から作成する場合、レプリケーショングループとそのすべてのノードを、AWS CLI create-replication-group コマンドへの 1 回の呼び出しで作成します。以下のパラメーターを含めます。

--replication-group-id

作成するレプリケーショングループの名前。

Redis (クラスターモードが有効) レプリケーショングループの命名に関する制約は次のとおりです。

• 1 ～ 40 文字の英数字またはハイフンを使用する必要があります。

• 先頭は文字にする必要があります。

• 連続する 2 つのハイフンを含めることはできません。

• 末尾をハイフンすることはできません。

--replication-group-description

レプリケーショングループの説明。

--cache-node-type

レプリケーショングループの各ノードのノードタイプ。

ElastiCache では以下のノードがサポートされています。一般に、現行世代のタイプは、以前の世代の同等タイプと比較した場合、メモリが多く処理能力が高くなっています。

• 汎用:

  • 現行世代:

    M5 ノードタイプ: cache.m5.large、cache.m5.xlarge、cache.m5.2xlarge、cache.m5.4xlarge、cache.m5.12xlarge、cache.m5.24xlarge

    M4 ノードタイプ: cache.m4.large、cache.m4.xlarge、cache.m4.2xlarge、cache.m4.4xlarge、cache.m4.10xlarge

    T2 ノードタイプ: cache.t2.micro、cache.t2.small、cache.t2.medium

  • 以前の世代: (推奨しません)

    T1 ノードタイプ: cache.t1.micro

    M1 ノードタイプ: cache.m1.small、cache.m1.medium、cache.m1.large、cache.m1.xlarge

    M3 ノードタイプ: cache.m3.medium、cache.m3.large、cache.m3.xlarge、cache.m3.2xlarge

• コンピューティングの最適化:

  • 以前の世代: (推奨しません)

    C1 ノードタイプ: cache.c1.xlarge

• メモリ最適化:

  • 現行世代:

    R5 ノードタイプ: cache.r5.large、cache.r5.xlarge、cache.r5.2xlarge、cache.r5.4xlarge、cache.r5.12xlarge、cache.r5.24xlarge

    R4 ノードタイプ: cache.r4.large、cache.r4.xlarge、cache.r4.2xlarge、cache.r4.4xlarge、cache.r4.8xlarge、cache.r4.16xlarge

  • 以前の世代: (推奨しません)

    M2 ノードタイプ: cache.m2.xlarge、cache.m2.2xlarge、cache.m2.4xlarge

    R3 ノードタイプ: cache.r3.large、cache.r3.xlarge、cache.r3.2xlarge、cache.r3.4xlarge、cache.r3.8xlarge

追加ノードタイプ情報

• 現在の世代のインスタンスタイプはすべて、デフォルトで Amazon VPC で作成されます。

• Redis AOF (Append-Only File) は、T1 または T2 インスタンスではサポートされません。

• 自動フェイルオーバー機能を備えた Redis マルチ AZ は、T1 インスタンスではサポートされていません。

• Redis 設定変数 appendonly および appendfsync Redis バージョン 2.8.22 以降ではサポートされていません。

--cache-parameter-group

default.redis3.2.cluster.on パラメーターグループまたは default.redis3.2.cluster.on から派生したパラメータグループを指定して、Redis (クラスターモードが有効) レプリケーショングループを作成します。詳細については、「Redis 3.2.4 パラメーターの変更」を参照してください。

--engine

redis

--engine-version

3.2.4

--num-node-groups

このレプリケーショングループのノードグループの数。有効な値は 1 ～ 90 です。

注記

ノード/シャード制限は、クラスターあたり 250 まで増やすことができます。この制限の拡大をリクエストするには、「AWS サービスの制限」を参照し、制限タイプ「インスタンスタイプごとのクラスターあたりのノード」を選択します。

--replicas-per-node-group

各ノードグループのレプリカノードの数。有効な値は 0 ～ 5 です。

このレプリケーショングループで転送時または保管時の暗号化を有効にする場合は、--transit-encryption-enabled パラメーターと --at-rest-encryption-enabled パラメーターの一方または両方を追加し、次の条件を満たす必要があります。

• レプリケーショングループは Redis バージョン 3.2.6 または 4.0.10.

• レプリケーショングループは Amazon VPC で作成されている必要があります。

• パラメーター --cache-subnet-group も含める必要があります。

• このレプリケーショングループに対するオペレーションを実行するために必要な AUTH トークン (パスワード) 用に顧客が指定した文字列値にパラメーター --auth-token も含める必要があります。

次のオペレーションでは、3 つのノードグループおよびシャード (--num-node-groups) を持つ Redis (クラスターモードが有効) レプリケーショングループ sample-repl-group を作成します。各レプリケーショングループに 3 つのノード、1 つのプライマリ、2 つのリードレプリカ (--replicas-per-node-group) が含まれます。

Linux, macOS, or Unix 用:

aws elasticache create-replication-group \
   --replication-group-id sample-repl-group \
   --replication-group-description "Demo cluster with replicas" \
   --num-node-groups 3 \
   --replicas-per-node-group 2 \
   --cache-node-type cache.m4.large \
   --cache-parameter-group default.redis3.2.cluster.on \
   --engine redis \
   --engine-version 3.2.4
   --security-group-ids SECURITY_GROUP_ID       
   --cache-subnet-group-name SUBNET_GROUP_NAME>
 

Windows の場合:

aws elasticache create-replication-group ^
   --replication-group-id sample-repl-group ^
   --replication-group-description "Demo cluster with replicas" ^
   --num-node-groups 3 ^
   --replicas-per-node-group 2 ^
   --cache-node-type cache.m4.large ^
   --cache-parameter-group default.redis3.2.cluster.on ^
   --engine redis ^
   --engine-version 3.2.4
   --security-group-ids SECURITY_GROUP_ID       
   --cache-subnet-group-name SUBNET_GROUP_NAME>             
 

前述のコマンドは、次の出力を生成します。

{
    "ReplicationGroup": {
        "Status": "creating", 
        "Description": "Demo cluster with replicas", 
        "ReplicationGroupId": "sample-repl-group", 
        "SnapshotRetentionLimit": 0, 
        "AutomaticFailover": "enabled", 
        "SnapshotWindow": "05:30-06:30", 
        "MemberClusters": [
            "sample-repl-group-0001-001", 
            "sample-repl-group-0001-002", 
            "sample-repl-group-0001-003", 
            "sample-repl-group-0002-001", 
            "sample-repl-group-0002-002", 
            "sample-repl-group-0002-003", 
            "sample-repl-group-0003-001", 
            "sample-repl-group-0003-002", 
            "sample-repl-group-0003-003"
        ], 
        "PendingModifiedValues": {}
    }
}

--node-group-configuration レプリケーショングループをゼロから作成する際、次の例に示すように Redis (クラスターモードが有効) パラメーターを使用してクラスター内の各シャードを設定することで、2 つのノードグループ (コンソール: シャード) を設定できます。1 つめのシャードは、2 つのノード、1 つのプライマリ、1 つのリードレプリカで構成されます。2 つめのシャードは、3 つのノード、1 つのプライマリ、2 つのリードレプリカで構成されます。

--node-group-configuration

各ノードグループの設定。--node-group-configuration パラメーターは次のフィールドで構成されます。

• PrimaryAvailabilityZone – このノードグループのプライマリノードがあるアベイラビリティーゾーン。このパラメーターを省略すると、ElastiCache によってプライマリノードのアベイラビリティーゾーンが選択されます。

  例: us-west-2a。

• ReplicaAvailabilityZones – リードレプリカがあるアベイラビリティーゾーンのカンマ区切りリスト。このリストのアベイラビリティーゾーンの数は、ReplicaCount の値と一致する必要があります。このパラメーターを省略すると、ElastiCache によってレプリカノードのアベイラビリティーゾーンが選択されます。

  例: "us-west-2a,us-west-2b,us-west-2c"

• ReplicaCount – このノードグループのレプリカノードの数。

• Slots – 対象ノードグループのキースペースを指定する文字列。この文字列は次の形式になります。startKey-endKeyこのパラメーターを省略すると、ElastiCache によってノードグループ間でキーが均等に割り当てられます。

  例: "0-4999"

   

次のオペレーションでは、2 つのノードグループとシャード (--num-node-groups) を持つ Redis (クラスターモードが有効) レプリケーショングループ new-group を作成します。前の例とは異なり、各ノードグループは、その他のノードグループ (--node-group-configuration) とは異なった構成になります。

Linux, macOS, or Unix 用:

aws elasticache create-replication-group \
  --replication-group-id new-group \
  --replication-group-description "Sharded replication group" \
  --engine redis \
  --engine-version 3.2.4 \
  --cache-parameter-group default.redis3.2.cluster.on \
  --snapshot-retention-limit 8 \
  --cache-node-type cache.m4.medium \
  --num-node-groups 2 \
  --node-group-configuration \
      "ReplicaCount=1,Slots=0-8999,PrimaryAvailabilityZone='us-east-1c',ReplicaAvailabilityZones='us-east-1b'" \
      "ReplicaCount=2,Slots=9000-16383,PrimaryAvailabilityZone='us-east-1a',ReplicaAvailabilityZones='us-east-1a','us-east-1c'"

Windows の場合:

aws elasticache create-replication-group ^
  --replication-group-id new-group ^
  --replication-group-description "Sharded replication group" ^
  --engine redis ^
  --engine-version 3.2.4 ^
  --cache-parameter-group default.redis3.2.cluster.on ^
  --snapshot-retention-limit 8 ^
  --cache-node-type cache.m4.medium ^
  --num-node-groups 2 ^
  --node-group-configuration \
      "ReplicaCount=1,Slots=0-8999,PrimaryAvailabilityZone='us-east-1c',ReplicaAvailabilityZones='us-east-1b'" \
      "ReplicaCount=2,Slots=9000-16383,PrimaryAvailabilityZone='us-east-1a',ReplicaAvailabilityZones='us-east-1a','us-east-1c'"

前述のオペレーションは、次の出力を生成します。

{
    "ReplicationGroup": {
        "Status": "creating", 
        "Description": "Sharded replication group", 
        "ReplicationGroupId": "rc-rg", 
        "SnapshotRetentionLimit": 8, 
        "AutomaticFailover": "enabled", 
        "SnapshotWindow": "10:00-11:00", 
        "MemberClusters": [
            "rc-rg-0001-001", 
            "rc-rg-0001-002", 
            "rc-rg-0002-001", 
            "rc-rg-0002-002", 
            "rc-rg-0002-003"
        ], 
        "PendingModifiedValues": {}
    }
}

使用するパラメータおよび追加情報については、AWS CLI トピックの「create-replication-group」を参照してください。

ゼロからの Redis (クラスターモードが有効) レプリケーショングループの作成 ((ElastiCache API))

以下の手順では、ElastiCache API を使用して Redis (クラスターモードが有効) レプリケーショングループを作成します。

Redis (クラスターモードが有効) レプリケーショングループを最初から作成する場合、レプリケーショングループとそのすべてのノードを、ElastiCache API CreateReplicationGroup オペレーションへの 1 回の呼び出しで作成します。以下のパラメーターを含めます。

ReplicationGroupId

作成するレプリケーショングループの名前。

Redis (クラスターモードが有効) レプリケーショングループの命名に関する制約は次のとおりです。

• 1 ～ 40 文字の英数字またはハイフンを使用する必要があります。

• 先頭は文字にする必要があります。

• 連続する 2 つのハイフンを含めることはできません。

• 末尾をハイフンすることはできません。

ReplicationGroupDescription

レプリケーショングループの説明。

NumNodeGroups

このレプリケーショングループで作成するノードグループの数。有効な値は 1 ～ 90 です。

ReplicasPerNodeGroup

各ノードグループのレプリカノードの数。有効な値は 1 ～ 5 です。

NodeGroupConfiguration

各ノードグループの設定。NodeGroupConfiguration パラメーターは次のフィールドで構成されます。

• PrimaryAvailabilityZone – このノードグループのプライマリノードがあるアベイラビリティーゾーン。このパラメーターを省略すると、ElastiCache によってプライマリノードのアベイラビリティーゾーンが選択されます。

  例: us-west-2a。

• ReplicaAvailabilityZones – リードレプリカがあるアベイラビリティーゾーンのリスト。このリストのアベイラビリティーゾーンの数は、ReplicaCount の値と一致する必要があります。このパラメーターを省略すると、ElastiCache によってレプリカノードのアベイラビリティーゾーンが選択されます。

• ReplicaCount – このノードグループのレプリカノードの数。

• Slots – 対象ノードグループのキースペースを指定する文字列。この文字列は次の形式になります。startKey-endKeyこのパラメーターを省略すると、ElastiCache によってノードグループ間でキーが均等に割り当てられます。

  例: "0-4999"

   

CacheNodeType

レプリケーショングループの各ノードのノードタイプ。

ElastiCache では以下のノードがサポートされています。一般に、現行世代のタイプは、以前の世代の同等タイプと比較した場合、メモリが多く処理能力が高くなっています。

• 汎用:

  • 現行世代:

    M5 ノードタイプ: cache.m5.large、cache.m5.xlarge、cache.m5.2xlarge、cache.m5.4xlarge、cache.m5.12xlarge、cache.m5.24xlarge

    M4 ノードタイプ: cache.m4.large、cache.m4.xlarge、cache.m4.2xlarge、cache.m4.4xlarge、cache.m4.10xlarge

    T2 ノードタイプ: cache.t2.micro、cache.t2.small、cache.t2.medium

  • 以前の世代: (推奨しません)

    T1 ノードタイプ: cache.t1.micro

    M1 ノードタイプ: cache.m1.small、cache.m1.medium、cache.m1.large、cache.m1.xlarge

    M3 ノードタイプ: cache.m3.medium、cache.m3.large、cache.m3.xlarge、cache.m3.2xlarge

• コンピューティングの最適化:

  • 以前の世代: (推奨しません)

    C1 ノードタイプ: cache.c1.xlarge

• メモリ最適化:

  • 現行世代:

    R5 ノードタイプ: cache.r5.large、cache.r5.xlarge、cache.r5.2xlarge、cache.r5.4xlarge、cache.r5.12xlarge、cache.r5.24xlarge

    R4 ノードタイプ: cache.r4.large、cache.r4.xlarge、cache.r4.2xlarge、cache.r4.4xlarge、cache.r4.8xlarge、cache.r4.16xlarge

  • 以前の世代: (推奨しません)

    M2 ノードタイプ: cache.m2.xlarge、cache.m2.2xlarge、cache.m2.4xlarge

    R3 ノードタイプ: cache.r3.large、cache.r3.xlarge、cache.r3.2xlarge、cache.r3.4xlarge、cache.r3.8xlarge

追加ノードタイプ情報

• 現在の世代のインスタンスタイプはすべて、デフォルトで Amazon VPC で作成されます。

• Redis AOF (Append-Only File) は、T1 または T2 インスタンスではサポートされません。

• 自動フェイルオーバー機能を備えた Redis マルチ AZ は、T1 インスタンスではサポートされていません。

• Redis 設定変数 appendonly および appendfsync Redis バージョン 2.8.22 以降ではサポートされていません。

CacheParameterGroup

default.redis3.2.cluster.on パラメーターグループまたは default.redis3.2.cluster.on から派生したパラメータグループを指定して、Redis (クラスターモードが有効) レプリケーショングループを作成します。詳細については、「Redis 3.2.4 パラメーターの変更」を参照してください。

エンジン

redis

EngineVersion

3.2.4

このレプリケーショングループで転送時または保管時の暗号化を有効にする場合は、TrasitEncryptionEnabled=true パラメーターと AtRestEncryptionEnabled=true パラメーターの一方または両方を追加し、次の条件を満たす必要があります。

• レプリケーショングループは Redis バージョン 3.2.6 または 4.0.10.

• レプリケーショングループは Amazon VPC で作成されている必要があります。

• パラメーター CacheSubnetGroup も含める必要があります。

• このレプリケーショングループに対するオペレーションを実行するために必要な AUTH トークン (パスワード) 用に顧客が指定した文字列値にパラメーター AuthToken も含める必要があります。

読みやすくするために改行が追加されます。

https://elasticache.us-west-2.amazonaws.com/
   ?Action=CreateReplicationGroup 
   &CacheNodeType=cache.m4.large
   &CacheParemeterGroup=default.redis3.2.cluster.on
   &Engine=redis
   &EngineVersion=3.2.4
   &NumNodeGroups=3
   &ReplicasPerNodeGroup=2
   &ReplicationGroupDescription=test%20group
   &ReplicationGroupId=myReplGroup
   &Version=2015-02-02
   &SignatureVersion=4
   &SignatureMethod=HmacSHA256
   &Timestamp=20150202T192317Z
   &X-Amz-Credential=<credential>

使用するパラメータおよび追加情報については、ElastiCache API トピックの「CreateReplicationGroup」を参照してください。