ElastiCache for Valkey または ElastiCache for Redis OSS クラスターでクラスターモードを変更する方法を教えてください。

簡単な説明

注: クラスターモードの設定は、クラスターモードを無効からクラスターモード有効にのみ変更できます。クラスターモードでこの変更を行った後に、構成を元に戻すことはできません。

前提条件

• クラスターのキーはデータベース 0 にのみ存在する必要があります。
• アプリケーションは、クラスタープロトコルと構成エンドポイントを使用できる Valkey または Redis OSS クライアントを使用する必要があります。
• クラスターでは、自動フェイルオーバーを有効にする必要があり、1 個以上のレプリカが必要です。
• 移行するには、クラスターに Valkey 7.2 以降または Redis OSS 7.0 以降のエンジンバージョンが必要です。詳細については、「クラスターモードの変更」を参照してください。

クラスターモードを無効から有効に更新するには、次のタスクを実行します。

1. クラスターモードを、クラスターモード無効から Compatible モードに更新します。
2. クラスターモードを Compatible モードからクラスターモード有効に更新します。

注: この移行プロセス中も、クラスターは引き続き使用できます。

解決策

Compatible モードに移行する前に、cluster-enabled パラメータを yes に設定する必要があります。デフォルトのパラメータグループを使用する場合、ElastiCache for Valkey および ElastiCache for Redis OSS は、デフォルトのパラメータグループを使用します。このデフォルトのパラメータグループでは、cluster-enabled 設定が yes に設定されているため、対応は必要ありません。

注: カスタムパラメータグループを使用する場合は、クラスターを変更する際に新しいパラメータグループを選択します。または、同じエンジンファミリーに新しいパラメータグループを作成し、cluster-enabled パラメータを yes に設定します。

クラスターモードをクラスターモード無効から Compatible モードに更新する

注: AWS コマンドラインインターフェイス (AWS CLI) コマンドの実行中にエラーが発生した場合は、「AWS CLI で発生したエラーのトラブルシューティング」を参照してください。また、AWS CLI の最新バージョンを使用していることを確認してください。

Compatible モードでは、ElastiCache はノードと連携するシャードを 1 つデプロイします。この構成では、クライアントアプリケーションはどちらのプロトコルでもクラスターと通信できます。

次の手順を実行します。

1. ElastiCache コンソールを開きます。
2. ナビゲーションペインで使用するリソースタイプを選択し、該当するクラスターを選択します。
3. [変更] を選択します。
4. [クラスターモード] で [Compatible] を選択します。
5. (オプション) パラメータ cluster-enabled が yes に設定されているカスタムパラメータグループを選択します。
   注: デフォルトのパラメータグループを使用する場合、アクションは不要です。
6. [変更をプレビュー] を選択し、[変更を保存] を選択します。

AWS CLI を使用してクラスターを変更する場合は、modify-replication-group コマンドを実行し、cluster-mode パラメータを compatible に更新します。

例

aws elasticache modify-replication-group \
    --replication-group-id test-cluster \
    --cluster-mode compatible  \
    --apply-immediately

注: 上記の例で test-cluster を実際のクラスター名に置き換えます。詳細については、「レプリケーショングループの変更」を参照してください。

クラスターモードを Compatible に変更した後は、新しく作成した設定エンドポイントを使用してアプリケーションからクラスターモード対応の接続をテストできます。プライマリエンドポイントとリーダーエンドポイントを使用して、クラスターの既存のクラスターモードが無効な接続を処理することもできます。

Compatible モードからは、クラスターモード無効に戻し、元の構成を保存することもできます。

クラスターモードを Compatible モードからクラスターモード有効に更新する

すべての Valkey または Redis OSS クライアントをクラスターモード有効に移行すると、クライアントアプリケーションはクラスター対応になります。このステータスからは、クラスターモードのパラメータを enabled に設定できます。

次の手順を実行します。

1. ElastiCache コンソールを開きます。
2. ナビゲーションペインで使用するリソースタイプを選択し、該当するクラスターを選択します。
3. [変更] を選択します。
4. [クラスターモード] で [有効] を選択します。
5. [変更をプレビュー] を選択し、[変更を保存] を選択します。

AWS CLI を使用してクラスターを変更するには、modify-replication-group コマンドを実行し、cluster-mode パラメータを enabled に変更します。

例

aws elasticache modify-replication-group \
    --replication-group-id test-cluster \
    --cluster-mode enabled  \
    --apply-immediately

注: 上記の例で test-cluster を実際のクラスター名に置き換えます。

クラスターモードの変更が完了すると、クラスターエンドポイントも変更されます。プライマリエンドポイントとリーダーエンドポイントがなくなったため、新しい設定エンドポイントでアプリケーションを更新する必要があります。

注: 使用するクライアントのドキュメントを確認し、クライアントが (クラスターモード有効) クラスターとのインタラクションをサポートするように構成することをおすすめします。詳細については、Valkey のウェブサイトで「クラスターの仕様」を参照してください。

関連情報

レプリケーション: Valkey と Redis OSS のクラスターモード無効と有効の比較

ベストプラクティス: Redis クライアントおよび Amazon ElastiCache for Redis」