メニュー
Amazon ElastiCache
ユーザーガイド (API Version 2015-02-02)

使用可能な Redis (クラスターモードが無効) クラスターによる、レプリカを持つクラスターの作成

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

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

使用可能な Redis クラスターによる、レプリカを持つクラスターの作成 (コンソール)

トピック「クラスターへのノードの追加 (コンソール)」を参照してください。

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

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

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

--replication-group-id

作成するレプリケーショングループの名前。このパラメータの値が追加されたノードの名前の基礎として使用され、3 桁の連番が --replication-group-id の末尾に追加されます。たとえば、new-group-001 と指定します。

Redis (クラスターモードが無効) レプリケーショングループの命名に関する制約

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

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

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

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

--replication-group-description

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

--num-cache-clusters

このクラスターに含めるノードの合計数 (プライマリノードを含む)このパラメータの最大値は 6 です。

--primary-cluster-id

このレプリケーショングループのプライマリノードにする、使用可能な Redis (クラスターモードが無効) クラスターの名前。

このクラスターで転送時の暗号化または保管時の暗号化を有効にする場合、以下のパラメータを追加します。

  • --transit-encryption-enabled

    転送時の暗号化を有効にする場合、クラスターは、Amazon VPC で作成される必要があり、パラメータ --cache-subnet-group を含める必要があります。

  • AUTH トークン (パスワード) 用に顧客が文字列値を指定した --auth-token が、このクラスター上のオペレーションに必要です。

  • --at-rest-encryption-enabled

次のコマンドは、レプリケーショングループ new-group を作成します。レプリケーショングループのプライマリノードとして使用できる Redis (クラスターモードが無効) クラスター redis01 を使用します。リードレプリカとなる 2 つの新しいノードを作成します。redis01 の設定 (パラメータグループ、セキュリティグループ、ノードタイプ、エンジンバージョンなど) は、レプリケーショングループのすべてのノードに適用されます。

Linux, macOS, or Unix 用:

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

Windows の場合:

Copy
aws elasticache create-replication-group ^ --replication-group-id new-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~20 文字の英数字またはハイフンを使用する必要があります。

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

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

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

--replication-group-id

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

レプリケーショングループに追加するそれぞれのリードレプリカで、このコマンドを --cache-cluster-id パラメーターの値のみを変更して繰り返します。

注記

レプリケーショングループに追加できるリードレプリカの数は 5 個までです。すでに 5 個のリードレプリカを持つレプリケーショングループに別のリードレプリカを追加しようとすると、オペレーションが失敗します。

次のコードは、リードレプリカ my-replica01 をレプリケーショングループ my-repl-group に追加します。プライマリクラスター – パラメータグループ、セキュリティグループ、ノードタイプなどの設定です。– はレプリケーショングループに追加されると、ノードに適用されます。

Linux, macOS, or Unix 用:

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

Windows の場合:

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

このコマンドの出力は次のようになります。

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

詳細については、以下の AWS CLI のトピックを参照してください。

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

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

ReplicationGroupId

作成するレプリケーショングループの名前。このパラメータの値が追加されたノードの名前の基礎として使用され、3 桁の連番が ReplicationGroupId の末尾に追加されます。たとえば、new-group-001 と指定します。

Redis (クラスターモードが無効) レプリケーショングループの命名に関する制約

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

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

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

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

ReplicationGroupDescription

レプリカを持つクラスターの説明。

NumCacheClusters

このクラスターに含めるノードの合計数 (プライマリノードを含む)このパラメータの最大値は 6 です。

PrimaryClusterId

このクラスターのプライマリノードにする、使用可能な Redis (クラスターモードが無効) クラスターの名前。

次のコマンドは、レプリカを持つクラスター new-group を作成します。レプリケーショングループのプライマリノードとして使用できる Redis (クラスターモードが無効) クラスター redis01 を使用します。リードレプリカとなる 2 つの新しいノードを作成します。redis01 の設定 (パラメータグループ、セキュリティグループ、ノードタイプ、エンジンバージョンなど) は、レプリケーショングループのすべてのノードに適用されます。

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

詳細については、以下の ElastiCache APL のトピックを参照してください。

次に、リードレプリカをレプリケーショングループに追加します。

レプリケーショングループの作成後に、CreateCacheCluster オペレーションを使用して、そのグループに 1 〜 5 個のリードレプリカを追加します。その際に、以下のパラメーターを必ず含めます。

CacheClusterId

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

クラスターの命名上の制約

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

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

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

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

ReplicationGroupId

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

レプリケーショングループに追加するリードレプリカごとに、このオペレーションを繰り返します。その際に、CacheClusterId パラメーターの値のみを変更します。

次のコードは、リードレプリカ myReplica01 をレプリケーショングループ myReplGroup に追加します。プライマリクラスター – パラメータグループ、セキュリティグループ、ノードタイプなどの設定です。– はレプリケーショングループに追加されると、ノードに適用されます。

Copy
https://elasticache.us-west-2.amazonaws.com/ ?Action=CreateCacheCluster &CacheClusterId=myReplica01 &ReplicationGroupId=myReplGroup &SignatureMethod=HmacSHA256 &SignatureVersion=4 &Version=2015-02-02 &X-Amz-Algorithm=AWS4-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」を参照してください。