

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

# 移行の開始
<a name="Migration-Initiate"></a>

すべての前提条件を満たせたら、AWS マネジメントコンソール、ElastiCache API、または AWS CLI を使用してデータ移行を開始できます。クラスターモードが有効になっている場合、スロットの移行が異なると、ライブ移行の前にリシャーディングが実行されます。以下に示しているのは、CLI を使用した例です。

**注記**  
`TestMigration` API を使用して移行セットアップを検証することをお勧めします。ただし、これは完全にオプションです。

以下のパラメータを指定して `start-migration` コマンドを呼び出して、移行を開始します。
+ `--replication-group-id` – ターゲット ElastiCache レプリケーショングループの識別子。
+ `--customer-node-endpoint-list` – エンドポイント (DNS または IP アドレス、およびソース Valkey または Redis OSS クラスターが実行されているポートも含む) のリスト。このリストには、クラスターモードが無効になっている場合でも、有効になっている場合でも、1 つの要素しか指定できません。連鎖レプリケーションを有効にしている場合、エンドポイントは Valkey または Redis OSS クラスターのプライマリノードの代わりにレプリカを参照できます。

以下に示しているのは、CLI を使用した例です。

```
aws elasticache start-migration --replication-group-id test-cluster --customer-node-endpoint-list "Address='10.0.0.241',Port=6379"
```

このコマンドを実行すると、ElastiCache プライマリノードは、各シャードで、(クラスターが有効な Redis の同じスロットを所有する対応するシャードにおいて) Valkey または Redis OSS インスタンスのレプリカになるように自ら設定します。ElastiCache クラスターのステータスが **[移行中]** に変わり、Valkey または Redis OSS インスタンスから ElastiCache プライマリノードへのデータの移行が開始されます。データのサイズと Valkey または Redis OSS インスタンスの負荷によっては、移行が完了するまでに時間がかかる場合があります。移行の進行状況を確認するには、Valkey インスタンスと ElastiCache プライマリノードで [valkey-cli INFO](https://valkey.io/commands/info) コマンドを実行します。

レプリケーションが正常に完了すると、Valkey または Redis OSS インスタンスへのすべての書き込みが ElastiCache クラスターに伝播されます。読み取りには ElastiCache ノードを使用できます。ただし、ElastiCache クラスターに書き込むことはできません。ElastiCache プライマリノードに他のレプリカノードが接続されている場合、これらのレプリカノードは ElastiCache プライマリノードからのレプリケートを継続します。このようにして、Valkey または Redis OSS クラスターのすべてのデータが ElastiCache クラスターのすべてのノードにレプリケートされます。

ElastiCache プライマリノードが Valkey または Redis OSS インスタンスのレプリカになることができない場合、数回再試行してから最終的に昇格してプライマリに戻ります。ElastiCache クラスターのステータスは [**available (使用可能)**] に変わり、移行開始の失敗に関するレプリケーショングループイベントが送信されます。このような障害のトラブルシューティングを行うには、以下の点を確認します。
+ レプリケーショングループイベントを確認します。イベントからの具体的な情報を使用して、移行の障害を修正します。
+ イベントから具体的な情報を得られない場合は、「[ソースおよびターゲットの移行を準備する](Migration-Prepare.md)」のガイドラインに従っていることを確認します。
+ VPC とサブネットのルーティング設定で、ElastiCache ノードと Valkey または Redis OSS インスタンスとの間のトラフィックが許可されていることを確認します。
+ Valkey または Redis OSS インスタンスにアタッチされたセキュリティグループが、ElastiCache ノードからのインバウンドトラフィックを許可していることを確認します。
+ レプリケーション固有の障害の詳細については、インスタンスの Valkey または Redis OSS ログを確認してください。