翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# ノードを ElastiCache クラスターに追加する
Memcached クラスターにノードを追加すると、クラスターのパーティションの数が増えます。クラスターのパーティションの数を変更するときは、正しいノードにマップされるように、一部のキースペースを再マッピングする必要があります。キースペースを再マッピングすると、クラスターでのキャッシュミスの数が一時的に増えます。詳細については、「[効率的な負荷分散のための ElastiCache クライアントの設定 (Memcached)](BestPractices.LoadBalancing.md)」を参照してください。
Valkey または Redis OSS (クラスターモードが有効) クラスターを再設定するには、「[Valkey または Redis OSS (クラスターモードが有効) クラスターのスケーリング](scaling-redis-cluster-mode-enabled.md)」を参照してください。
ElastiCache マネジメントコンソール、、AWS CLIまたは ElastiCache API を使用して、クラスターにノードを追加できます。
## ElastiCache AWS マネジメントコンソールの使用
単一ノードの Valkey または Redis OSS (クラスターモードが無効) クラスター (レプリケーションが有効でないクラスター) にノードを追加する場合は、2 ステップのプロセスを踏みます。最初にレプリケーションを追加し、次にレプリカノードを追加します。
**トピック**
+ [シャードがない Valkey または Redis OSS クラスターにレプリケーションを追加するには](#AddReplication.CON)
+ [ノードを ElastiCache クラスターに追加するには (コンソール)](#AddNode.CON)
次の手順では、レプリケーションが有効でない単一ノードの Valkey または Redis OSS にレプリケーションを追加します。レプリケーションを追加すると、既存のノードはレプリケーションが有効なクラスターのプライマリノードになります。レプリケーションの追加後に、最大 5 個のレプリカノードをクラスターに追加できます。
**シャードがない Valkey または Redis OSS クラスターにレプリケーションを追加するには**
1. にサインインAWS マネジメントコンソールし、[https://console.aws.amazon.com/elasticache/](https://console.aws.amazon.com/elasticache/) で ElastiCache コンソールを開きます。
1. ナビゲーションペインで **[Valkey クラスター]** または **[Redis OSS クラスター]** を選択します。
そのエンジンを実行しているクラスターが一覧表示されます。
1. ノードを追加するクラスターの名前 (クラスター名の左にあるボックスではなく) を選択します。
レプリケーションが有効でない Redis OSS クラスターは以下に該当します。
+ クラスター化された Redis OSS ではなく、Redis OSS を実行しています。
+ シャードがありません。
クラスターにシャードがある場合は、レプリケーションがすでに有効になっており、[ノードを ElastiCache クラスターに追加するには (コンソール)](#AddNode.CON) を続行できます。
1. [**Add replication**] を選択します。
1. [**レプリケーションの追加**] で、このレプリケーションが有効なクラスターの説明を入力します。
1. **[Add]** (追加) を選択します。
クラスターのステータスが [*available*] になり次第、次の手順に進んでクラスターにレプリカを追加できます。
**ノードを ElastiCache クラスターに追加するには (コンソール)**
次の手順を使用して、クラスターにノードを追加できます。
1. にサインインAWS マネジメントコンソールし、[https://console.aws.amazon.com/elasticache/](https://console.aws.amazon.com/elasticache/) で ElastiCache コンソールを開きます。
1. ナビゲーションペインで、ノードを追加する先のクラスターで実行されているエンジンを選択します。
選択したエンジンを実行しているクラスターが一覧表示されます。
1. クラスターのリストから、ノードを追加する先のクラスターの名前を選択します。
クラスターが Valkey または Redis OSS (クラスターモードが有効) クラスターの場合は、「[Valkey または Redis OSS (クラスターモードが有効) クラスターのスケーリング](scaling-redis-cluster-mode-enabled.md)」を参照してください。
クラスターが、シャードがない Valkey または Redis OSS (クラスターモードが無効) クラスターの場合は、最初に「[シャードがない Valkey または Redis OSS クラスターにレプリケーションを追加するには](#AddReplication.CON)」のステップを完了してください。
1. [**Add node**] (ノードの追加) を選択します。
1. [**ノードの追加**] ダイアログボックスで、要求された情報を入力します。
1. このノードを直ちに追加する場合は [**Apply Immediately (すぐに適用) - はい**] ボタンを選択します。クラスターの次のメンテナンス期間にこのノードを追加する場合は [**いいえ**] を選択します。
**保留中のリクエストに対する新しい追加および削除リクエストの影響**
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/AmazonElastiCache/latest/dg/Clusters.AddNode.html)
保留中のオペレーションを確認するには、[**説明**] タブを選択し、表示されている保留中の作成または削除の数を確認します。保留中の作成と保留中の削除の両方を持つことはできません。
1. [**Add**] ボタンを選択します。
しばらくすると、新しいノードが一覧表示され、ステータス [**creating**] になります。表示されない場合は、ブラウザのページを更新します。ノードのステータスが [*available*] (利用可能) に変わったら、新しいノードを使用できます。
## ElastiCache AWS CLIでの の使用
を使用してクラスターにノードを追加するにはAWS CLI、以下のパラメータ`modify-cache-cluster`を指定してAWS CLIオペレーションを使用します。
+ `--cache-cluster-id` ノードを追加する先のクラスターの ID。
+ `--num-cache-nodes` `--num-cache-nodes` パラメータは、変更の適用後に、このクラスターに必要となるノードの数を指定します。このクラスターにノードを追加しても、`--num-cache-nodes` はこのクラスター内の現在ノードの数よりも大きくする必要があります。この値が現在のノード数より少ない場合、ElastiCache はパラメータ `cache-node-ids-to-remove` と、クラスターから削除するノードの一覧を要求します。詳細については、「[ElastiCache AWS CLIでの の使用](Clusters.DeleteNode.md#Clusters.DeleteNode.CLI)」を参照してください。
+ `--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「」トピックを参照してください[https://docs.aws.amazon.com/cli/latest/reference/elasticache/modify-cache-cluster.html](https://docs.aws.amazon.com/cli/latest/reference/elasticache/modify-cache-cluster.html)。
## ElastiCache AWS CLIでの の使用
レプリケーションが有効でない既存の Valkey または Redis OSS (クラスターモードが無効) クラスターにノードを追加する場合は、最初にレプリケーショングループを作成して既存のクラスターをプライマリとして指定する必要があります。詳細については、「[使用可能な Valkey または Redis OSS のクラスターを使用したレプリケーショングループの作成 (AWS CLI)](Replication.CreatingReplGroup.ExistingCluster.md#Replication.CreatingReplGroup.ExistingCluster.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「」トピックを参照してください[https://docs.aws.amazon.com/cli/latest/reference/elasticache/increase-replica-count.html](https://docs.aws.amazon.com/cli/latest/reference/elasticache/increase-replica-count.html)。
## ElastiCache API の使用
レプリケーションが有効でない既存の Valkey または Redis OSS (クラスターモードが無効) クラスターにノードを追加する場合は、最初にレプリケーショングループを作成して既存のクラスターをプライマリとして指定する必要があります。詳細については、「[スタンドアロンの Valkey または Redis OSS (クラスターモードが無効) クラスターにレプリカを追加する (ElastiCache API)](Replication.CreatingReplGroup.ExistingCluster.md#Replication.CreatingReplGroup.ExistingCluster.API)」を参照してください。レプリケーショングループが [*available*] になった後で、次のプロセスを続行できます。
**ノードをクラスターに追加するには (ElastiCache API)**
+ 以下のパラメーターを指定して `IncreaseReplicaCount` API オペレーションを呼び出します。
+ `ReplicationGroupId` ノードを追加する先のクラスターの ID。
+ `NewReplicaCount` `NewReplicaCount` パラメータは、変更の適用後に、このクラスターに必要となるノードの数を指定します。このクラスターにノードを追加しても、`NewReplicaCount` はこのクラスター内の現在ノードの数よりも大きくする必要があります。この値が現在のノードの数より少ない場合、そのノードの数がある `DecreaseReplicaCount` API を使用してクラスターから削除します。
+ `ApplyImmediately` は、次のメンテナンス時にこれらのノードを追加するかどうかを指定します。
+ `Region` ノードを追加するクラスターのAWSリージョンを指定します。
次の例は、クラスターにノードを追加する呼び出しを示しています。
**Example**
```
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=
&X-Amz-Signature=
```
詳細については、「ElastiCache API トピック [https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_IncreaseReplicaCount.html](https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_IncreaseReplicaCount.html)」を参照してください。
## ElastiCache API の使用
**ノードをクラスターに追加するには (ElastiCache API)**
+ 以下のパラメーターを指定して `ModifyCacheCluster` API オペレーションを呼び出します。
+ `CacheClusterId` ノードを追加する先のクラスターの ID。
+ `NumCacheNodes` `NumCachNodes` パラメータは、変更の適用後に、このクラスターに必要となるノードの数を指定します。このクラスターにノードを追加しても、`NumCacheNodes` はこのクラスター内の現在ノードの数よりも大きくする必要があります。この値が現在のノードの数より少ない場合、ElastiCache は `CacheNodeIdsToRemove` パラメータとノードのリストがノードをクラスターから削除することを想定します (「[Memcached で ElastiCache API を使用する](Clusters.DeleteNode.md#Clusters.DeleteNode.API)」を参照)。
+ `ApplyImmediately` は、次のメンテナンス時にこれらのノードを追加するかどうかを指定します。
+ `Region` ノードを追加するクラスターのAWSリージョンを指定します。
次の例は、クラスターにノードを追加する呼び出しを示しています。
**Example**
```
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=
&X-Amz-Signature=
```
詳細については、「ElastiCache API トピック [https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_ModifyCacheCluster.html](https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_ModifyCacheCluster.html)」を参照してください。