このページでは、複数のリージョンで Cassandra を復元する方法について説明します。
マルチリージョン デプロイでは、Apigee ハイブリッドがさまざまなデータセンターの複数の地理的位置にデプロイされます。デプロイに複数の Apigee 組織が存在する場合、復元プロセスではすべての組織のデータが復元されることに注意してください。複数組織の設定では、特定の組織のみ復元することはできません。
Cassandra の復元
マルチリージョン デプロイでは、障害が発生したリージョンを復旧する方法が 2 つあります。このトピックでは、次の方法について説明します。
- 障害が発生したリージョンを復旧 - 正常なリージョンに基づいて障害が発生したリージョンを復元する手順を説明します。
- 障害が発生したリージョンを復元する - 障害が発生したリージョンをバックアップから復元する手順を説明します。このアプローチは、すべてのハイブリッド リージョンが影響を受ける場合にのみ必要です。
障害が発生したリージョンを復旧する
障害が発生したリージョンを正常なリージョンから復元するには、次の手順に沿います。
- 影響を受けたリージョンから正常に動作するリージョンに API トラフィックをリダイレクトします。障害が発生したリージョンから迂回されるトラフィックに対応できるよう容量を適宜計画します。
- 影響を受けたリージョンを廃止します。影響を受けた各リージョンに対して、ハイブリッド リージョンを廃止するで説明されている操作を行います。廃止が完了するまで待ってから次のステップに進みます。
- 影響を受けたリージョンを復元します。復元するには、GKE、GKE On-Prem、AKS でのマルチリージョン デプロイの説明に沿って、新しいリージョンを作成します。
バックアップからの復元
Cassandra のバックアップは、構成に基づいて、Cloud Storage 上またはリモート サーバー上のいずれかに存在します。バックアップから Cassandra を復元するには、次の手順に沿って操作します。
- すべてのリージョンから Apigee ハイブリッド デプロイを削除します。
apigeectl delete -f overrides.yaml
-
バックアップから目的のリージョンを復元します。詳細については、バックアップからのリージョンの復元をご覧ください。
- 削除したリージョンの参照を削除し、復元したリージョンの参照を
KeySpaces
メタデータに追加します。 nodetool status
オプションを使用してリージョン名を取得します。kubectl exec -n apigee -it apigee-cassandra-default-0 -- bash nodetool -u APIGEE_JMX_USER -pw APIGEE_JMX_PASSWORD status |grep -i Datacenter
ここで
- APIGEE_JMX_USER は、Cassandra JMX オペレーション ユーザーのユーザー名です。Cassandra JMX インターフェースの認証と通信に使用されます。
cassandra:auth:jmx:username
を参照してください。 - APIGEE_JMX_PASSWORD は、Cassandra JMX オペレーション ユーザーのパスワードです。
cassandra:auth:jmx:password
を参照してください。
- APIGEE_JMX_USER は、Cassandra JMX オペレーション ユーザーのユーザー名です。Cassandra JMX インターフェースの認証と通信に使用されます。
KeySpaces
レプリケーションを更新します。- クライアント コンテナを作成し、CQL インターフェースから Cassandra クラスタに接続します。
- CQL インターフェースからユーザー キースペースのリストを取得します。
cqlsh CASSANDRA_SEED_HOST -u APIGEE_DDL_USER -p APIGEE_DDL_PASSWORD --ssl -e "select keyspace_name from system_schema.keyspaces;"|grep -v system
ここで
- CASSANDRA_SEED_HOST は、Cassandra マルチリージョンのシードホストです。ほとんどのマルチリージョン インストールでは、最初のリージョンのホストの IP アドレスを使用します。Apigee ハイブリッドをマルチリージョン用に構成すると
cassandra:externalSeedHost
をご覧ください。 - APIGEE_DDL_USER と APIGEE_DDL_PASSWORD は、Cassandra データ定義言語(DDL)の管理者ユーザーの名前とパスワードです。デフォルト値は
ddl_user
とiloveapis123
です。構成プロパティのリファレンスの
cassandra.auth.ddl.password
と Apache Cassandra cqlsh ドキュメントのコマンドライン オプションをご覧ください。
- CASSANDRA_SEED_HOST は、Cassandra マルチリージョンのシードホストです。ほとんどのマルチリージョン インストールでは、最初のリージョンのホストの IP アドレスを使用します。Apigee ハイブリッドをマルチリージョン用に構成すると
- キースペースごとに、CQL インターフェースから次のコマンドを実行して、レプリケーション設定を更新します。
ALTER KEYSPACE KEYSPACE_NAME WITH replication = {'class': 'NetworkTopologyStrategy', 'REGION_NAME':3};
ここで
- KEYSPACE_NAME は、前の手順の出力に示されているキースペースの名前です。
- REGION_NAME は手順 4 で取得したリージョン名です。