ElastiCache クラスターへのノードの追加 - Amazon ElastiCache

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

ElastiCache クラスターへのノードの追加

Memcached クラスターにノードを追加すると、クラスターのパーティションの数が増えます。クラスターのパーティションの数を変更するときは、正しいノードにマップされるように、一部のキースペースを再マッピングする必要があります。キースペースを再マッピングすると、クラスターでのキャッシュミスの数が一時的に増えます。詳細については、「効率的なロードバランシングのための ElastiCache クライアントの設定 (Memcached)」を参照してください。

Valkey または Redis OSS (クラスターモードが有効) クラスターを再設定するには、「」を参照してください。 Valkey または Redis でのクラスターのスケーリング OSS (クラスターモードが有効）

ElastiCache マネジメントコンソール、 AWS CLI または ElastiCache API を使用して、クラスターにノードを追加できます。

単一ノードの Valkey または Redis OSS (クラスターモードが無効) クラスター (レプリケーションが有効になっていないクラスター) にノードを追加する場合は、まずレプリケーションを追加し、次にレプリカノードを追加するという 2 つのステップのプロセスです。

トピック

次の手順では、レプリケーションが有効になっていOSSない単一ノードの Valkey または Redis にレプリケーションを追加します。レプリケーションを追加すると、既存のノードはレプリケーションが有効なクラスターのプライマリノードになります。レプリケーションの追加後に、最大 5 個のレプリカノードをクラスターに追加できます。

シャードなしで Valkey または Redis OSSクラスターにレプリケーションを追加するには

  1. にサインイン AWS Management Console し、 https://console.aws.amazon.com/elasticache/で ElastiCache コンソールを開きます。

  2. ナビゲーションペインから、Valkey クラスターまたは Redis OSSクラスター を選択します。

    エンジンを実行しているクラスターのリストが表示されます。

  3. ノードを追加するクラスターの名前 (クラスター名の左にあるボックスではなく) を選択します。

    以下は、レプリケーションが有効になっていない Redis OSSクラスターに当てはまります。

  4. [Add replication] を選択します。

  5. [レプリケーションの追加] で、このレプリケーションが有効なクラスターの説明を入力します。

  6. [追加] を選択します。

    クラスターのステータスが [available] になり次第、次の手順に進んでクラスターにレプリカを追加できます。

ElastiCache クラスターにノードを追加するには (コンソール）

次の手順を使用して、クラスターにノードを追加できます。

  1. にサインイン AWS Management Console し、 https://console.aws.amazon.com/elasticache/で ElastiCache コンソールを開きます。

  2. ナビゲーションペインで、ノードを追加する先のクラスターで実行されているエンジンを選択します。

    選択したエンジンを実行しているクラスターが一覧表示されます。

  3. クラスターのリストから、ノードを追加する先のクラスターの名前を選択します。

    クラスターが Valkey または Redis OSS (クラスターモードが有効) クラスターの場合は、「」を参照してくださいValkey または Redis でのクラスターのスケーリング OSS (クラスターモードが有効）。

    クラスターがシャードがゼロの Valkey または Redis OSS (クラスターモードが無効) クラスターの場合は、まず でステップを完了しますシャードなしで Valkey または Redis OSSクラスターにレプリケーションを追加するには。

  4. [Add node] (ノードの追加) を選択します。

  5. [ノードの追加] ダイアログボックスで、要求された情報を入力します。

  6. このノードを直ちに追加する場合は [Apply Immediately (すぐに適用) - はい] ボタンを選択します。クラスターの次のメンテナンス期間にこのノードを追加する場合は [いいえ] を選択します。

    保留中のリクエストに対する新しい追加および削除リクエストの影響
    シナリオ 保留中のオペレーション 新しいリクエスト 結果

    シナリオ 1

    削除

    		 削除

    新しい削除リクエスト (保留中または即時) は、保留中の削除リクエストを置き換えます。

    例えば、ノード 0001、0003、0007 が削除保留中で、ノード 0002 と 0004 を削除する新しいリクエストが発行された場合、ノード 0002 と 0004 のみが削除されます。ノード 0001、0003、0007 は削除されません。

    シナリオ 2

    削除

    作成

    新しい作成リクエスト (保留中または直ちに) は、保留中の削除リクエストを置き換えます。

    例えば、ノード 0001、0003、0007 の削除が保留中で、ノードを作成する新しいリクエストが発行された場合、新しいノードが作成され、ノード 0001、0003、0007 は削除されません。

    シナリオ 3

    作成

    削除

    新しい削除リクエスト (保留中または即時) は、保留中の作成リクエストを置き換えます。

    例えば、2 つのノードを作成する保留中の要求があり、ノード 0003 を削除する新しいリクエストが発行された場合、新しいノードは作成されず、ノード 0003 は削除されます。

    シナリオ 4

    作成

    作成

    新しい作成リクエストが保留中の作成リクエストに追加されます。

    例えば、2 つのノードを作成する保留中のリクエストがあり、3 つのノードを作成する新しいリクエストが発行された場合、新しいリクエストは保留中のリクエストに追加され、5 つのノードが作成されます。

    重要

    新しい作成リクエストが [直ちに適用 - はい] に設定されると、すべての作成リクエストが直ちに実行されます。新しい作成リクエストが [直ちに適用 - いいえ] に設定されると、すべての作成リクエストは保留中になります。

    保留中のオペレーションを確認するには、[説明] タブを選択し、表示されている保留中の作成または削除の数を確認します。保留中の作成と保留中の削除の両方を持つことはできません。

  7. [Add] ボタンを選択します。

    しばらくすると、新しいノードが一覧表示され、ステータス [creating] になります。表示されない場合は、ブラウザのページを更新します。ノードのステータスが [available] (利用可能) に変わったら、新しいノードを使用できます。

を使用してクラスターにノードを追加するには AWS CLI、次のパラメータmodify-cache-clusterで AWS CLI オペレーションを使用します。

  • --cache-cluster-id ノードを追加する先のキャッシュクラスターの ID。

  • --num-cache-nodes --num-cache-nodes パラメータは、変更の適用後に、このクラスターに必要となるノードの数を指定します。このクラスターにノードを追加しても、--num-cache-nodes はこのクラスター内の現在ノードの数よりも大きくする必要があります。この値が現在のノード数より小さい場合、 は パラメータcache-node-ids-to-removeと、クラスターから削除するノードのリスト ElastiCache を求めます。詳細については、「AWS CLI での の使用 ElastiCache」を参照してください。

  • --apply-immediately または --no-apply-immediately は、次のメンテナンス時にこれらのノードを追加するかどうかを指定します。

Linux、macOS、Unix の場合:

aws elasticache modify-cache-cluster \
    --cache-cluster-id my-cluster \
    --num-cache-nodes 5 \
    --apply-immediately

Windows の場合:

aws elasticache modify-cache-cluster ^
    --cache-cluster-id my-cluster ^
    --num-cache-nodes 5 ^
    --apply-immediately

このオペレーションでは、次のような出力が生成されます (JSON 形式）。

{
    "CacheCluster": {
        "Engine": "memcached", 
        "CacheParameterGroup": {
            "CacheNodeIdsToReboot": [], 
            "CacheParameterGroupName": "default.memcached1.4", 
            "ParameterApplyStatus": "in-sync"
        }, 
        "CacheClusterId": "my-cluster", 
        "PreferredAvailabilityZone": "us-west-2b", 
        "ConfigurationEndpoint": {
            "Port": 11211, 
            "Address": "rlh-mem000.7alc7bf-example.cfg.usw2.cache.amazonaws.com"
        }, 
        "CacheSecurityGroups": [], 
        "CacheClusterCreateTime": "2016-09-21T16:28:28.973Z", 
        "AutoMinorVersionUpgrade": true, 
        "CacheClusterStatus": "modifying", 
        "NumCacheNodes": 2, 
        "ClientDownloadLandingPage": "https://console.aws.amazon.com/elasticache/home#client-download:", 
        "SecurityGroups": [
            {
                "Status": "active", 
                "SecurityGroupId": "sg-dbe93fa2"
            }
        ], 
        "CacheSubnetGroupName": "default", 
        "EngineVersion": "1.4.24", 
        "PendingModifiedValues": {
            "NumCacheNodes": 5
        }, 
        "PreferredMaintenanceWindow": "sat:09:00-sat:10:00", 
        "CacheNodeType": "cache.m3.medium",
         "DataTiering": "disabled",
    }
}

詳細については、 AWS CLI 「」トピックを参照してくださいmodify-cache-cluster。

レプリケーションが有効になっていない既存の Valkey または Redis OSS (クラスターモードが無効) クラスターにノードを追加する場合は、まず既存のクラスターをプライマリとして指定するレプリケーショングループを作成する必要があります。詳細については、「使用可能な Valkey または Redis OSSキャッシュクラスターを使用したレプリケーショングループの作成 (AWS CLI）」を参照してください。レプリケーショングループが [available] になった後で、次のプロセスを続行できます。

を使用してクラスターにノードを追加するには AWS CLI、次のパラメータincrease-replica-countで AWS CLI オペレーションを使用します。

  • --replication-group-id ノードを追加する先のレプリケーショングループの ID。

  • --new-replica-count は、変更の適用後に、このレプリケーショングループに必要となるノードの数を指定します。このクラスターにノードを追加しても、--new-replica-count はこのクラスター内の現在ノードの数よりも大きくする必要があります。

  • --apply-immediately または --no-apply-immediately は、次のメンテナンス時にこれらのノードを追加するかどうかを指定します。

Linux、macOS、Unix の場合:

aws elasticache increase-replica-count \
    --replication-group-id my-replication-group \
    --new-replica-count 4 \
    --apply-immediately

Windows の場合:

aws elasticache increase-replica-count ^
    --replication-group-id my-replication-group ^
    --new-replica-count 4 ^
    --apply-immediately

このオペレーションでは、次のような出力が生成されます (JSON 形式）。

{
    "ReplicationGroup": {
        "ReplicationGroupId": "node-test",
        "Description": "node-test",       
        "Status": "modifying",
        "PendingModifiedValues": {},
        "MemberClusters": [
            "node-test-001",
            "node-test-002",
            "node-test-003",
            "node-test-004",
            "node-test-005"
        ],
        "NodeGroups": [
            {
                "NodeGroupId": "0001",
                "Status": "modifying",
                "PrimaryEndpoint": {
                    "Address": "node-test.zzzzzz.ng.0001.usw2.cache.amazonaws.com",
                    "Port": 6379
                },
                "ReaderEndpoint": {
                    "Address": "node-test.zzzzzz.ng.0001.usw2.cache.amazonaws.com",
                    "Port": 6379
                },
                "NodeGroupMembers": [
                    {
                        "CacheClusterId": "node-test-001",
                        "CacheNodeId": "0001",
                        "ReadEndpoint": {
                            "Address": "node-test-001.zzzzzz.0001.usw2.cache.amazonaws.com",
                            "Port": 6379
                        },
                        "PreferredAvailabilityZone": "us-west-2a",
                        "CurrentRole": "primary"
                    },
                    {
                        "CacheClusterId": "node-test-002",
                        "CacheNodeId": "0001",
                        "ReadEndpoint": {
                            "Address": "node-test-002.zzzzzz.0001.usw2.cache.amazonaws.com",
                            "Port": 6379
                        },
                        "PreferredAvailabilityZone": "us-west-2c",
                        "CurrentRole": "replica"
                    },
                    {
                        "CacheClusterId": "node-test-003",
                        "CacheNodeId": "0001",
                        "ReadEndpoint": {
                            "Address": "node-test-003.zzzzzz.0001.usw2.cache.amazonaws.com",
                            "Port": 6379
                        },
                        "PreferredAvailabilityZone": "us-west-2b",
                        "CurrentRole": "replica"
                    }
                ]
            }
        ],
        "SnapshottingClusterId": "node-test-002",
        "AutomaticFailover": "enabled",
        "MultiAZ": "enabled",
        "SnapshotRetentionLimit": 1,
        "SnapshotWindow": "07:30-08:30",
        "ClusterEnabled": false,
        "CacheNodeType": "cache.r5.large",
         "DataTiering": "disabled",
        "TransitEncryptionEnabled": false,
        "AtRestEncryptionEnabled": false,
        "ARN": "arn:aws:elasticache:us-west-2:123456789012:replicationgroup:node-test"
    }
}

詳細については、 AWS CLI 「」トピックを参照してくださいincrease-replica-count。

レプリケーションが有効になっていない既存の Valkey または Redis OSS (クラスターモードが無効) クラスターにノードを追加する場合は、まず既存のクラスターをプライマリとして指定するレプリケーショングループを作成する必要があります。詳細については、「スタンドアロンの Valkey または Redis OSS (クラスターモードが無効) クラスターへのレプリカの追加 (ElastiCache API）」を参照してください。レプリケーショングループが [available] になった後で、次のプロセスを続行できます。

クラスターにノードを追加するには (ElastiCache API）

  • 次のパラメータを使用して IncreaseReplicaCountAPIオペレーションを呼び出します。

    • ReplicationGroupId ノードを追加する先のクラスターの ID。

    • NewReplicaCount NewReplicaCount パラメータは、変更の適用後に、このクラスターに必要となるノードの数を指定します。このクラスターにノードを追加しても、NewReplicaCount はこのクラスター内の現在ノードの数よりも大きくする必要があります。この値が現在のノード数より小さい場合は、 をノード数DecreaseReplicaCountAPIとともに使用してクラスターから削除します。

    • ApplyImmediately は、次のメンテナンス時にこれらのノードを追加するかどうかを指定します。

    • Region ノードを追加するクラスターの AWS リージョンを指定します。

    次の例は、クラスターにノードを追加する呼び出しを示しています。

    https://elasticache.us-west-2.amazonaws.com/
    ?Action=IncreaseReplicaCount
    &ApplyImmediately=true
    &NumCacheNodes=4
    &ReplicationGroupId=my-replication-group
    &Region=us-east-2
    &Version=2014-12-01
    &SignatureVersion=4
    &SignatureMethod=HmacSHA256
    &Timestamp=20141201T220302Z
    &X-Amz-Algorithm=&AWS;4-HMAC-SHA256
    &X-Amz-Date=20141201T220302Z
    &X-Amz-SignedHeaders=Host
    &X-Amz-Expires=20141201T220302Z
    &X-Amz-Credential=<credential>
    &X-Amz-Signature=<signature>

詳細については、「」トピックを参照してください ElastiCache APIIncreaseReplicaCount。

クラスターにノードを追加するには (ElastiCache API）

  • 次のパラメータを使用して ModifyCacheClusterAPIオペレーションを呼び出します。

    • CacheClusterId ノードを追加する先のクラスターの ID。

    • NumCacheNodes NumCachNodes パラメータは、変更の適用後に、このクラスターに必要となるノードの数を指定します。このクラスターにノードを追加しても、NumCacheNodes はこのクラスター内の現在ノードの数よりも大きくする必要があります。この値が現在のノード数より小さい場合、 は、クラスターから削除するノードのリストCacheNodeIdsToRemoveを含む パラメータ ElastiCache を想定します (「」を参照Memcached での ElastiCache APIの使用）。

    • ApplyImmediately は、次のメンテナンス時にこれらのノードを追加するかどうかを指定します。

    • Region ノードを追加するクラスターの AWS リージョンを指定します。

    次の例は、クラスターにノードを追加する呼び出しを示しています。

    https://elasticache.us-west-2.amazonaws.com/
    ?Action=ModifyCacheCluster
    &ApplyImmediately=true
    &NumCacheNodes=5
	&CacheClusterId=my-cluster
	&Region=us-east-2
    &Version=2014-12-01
    &SignatureVersion=4
    &SignatureMethod=HmacSHA256
    &Timestamp=20141201T220302Z
    &X-Amz-Algorithm=&AWS;4-HMAC-SHA256
    &X-Amz-Date=20141201T220302Z
    &X-Amz-SignedHeaders=Host
    &X-Amz-Expires=20141201T220302Z
    &X-Amz-Credential=<credential>
    &X-Amz-Signature=<signature>

詳細については、「 トピック」を参照してください ElastiCache APIModifyCacheCluster。