1.8. Galera で MariaDB を複製する

• 同期のレプリケーション
• アクティブ/アクティブのマルチソーストポロジー
• クラスターノードへの読み取りおよび書き込み
• 自動メンバーシップ制御、失敗したノードのクラスターからの削除
• 自動ノードの参加
• 行レベルの並列レプリケーション
• ダイレクトクライアント接続: ユーザーはクラスターノードにログインし、レプリケーションの実行中にノードを直接操作できます。

• 特定のクラスターノード間の変更の伝播に遅延がない
• すべてのクラスターノードには常に一貫性がある
• いずれかのクラスターノードがクラッシュしても、最新の変更は失われない
• すべてのクラスターノードのトランザクションが並列に実行する
• クラスター全体にわたる因果関係

• mariadb-server-galera: MariaDB Galera Cluster のサポートファイルとスクリプトが含まれます。
• mariadb-server: MariaDB アップストリームがパッチを適用し、書き込みセットレプリケーション API (wsrep API) を組み込みます。この API は、Galera レプリケーションと MariaDB との間のインターフェイスを提供します。

• galera: MariaDB アップストリームがパッチを適用し、MariaDB の完全サポートを追加します。galera パッケージには、以下の内容が含まれます。

  • Galera Replication Library は、レプリケーション機能全体を提供します。
  • Galera Arbitrator ユーティリティーは、スプリットブレインのシナリオで投票に参加するクラスターメンバーとして使用できます。ただし、Galera Arbitrator は実際のレプリケーションには参加できません。
  • Galera Arbitrator ユーティリティーのデプロイに使用される Galera Systemd service および Galera wrapper script。RHEL 10 は、/usr/lib/systemd/system/garbd.service および /usr/sbin/garb-systemd にあるこれらのファイルのアップストリームバージョンを提供します。

前提条件

• クラスター内のすべてのノードに TLS がセットアップ されている。

• すべてのノード上のすべての証明書の Extended Key Usage フィールドが次のように設定されている。

  TLS Web Server Authentication, TLS Web Client Authentication

検証

• MariaDB Galera クラスターのステータスを確認する を参照してください。

• クラスター内のノードの数を表示します。

  # mysql -u root -p -e 'show status like "wsrep_cluster_size";'
  +--------------------+-------+
  | Variable_name      | Value |
  +--------------------+-------+
  | wsrep_cluster_size | 4     |
  +--------------------+-------+

• ノードのクラスターコンポーネントのステータスを表示します。

  # mysql -u root -p -e 'show status like "wsrep_cluster_status";'
  +----------------------+---------+
  | Variable_name        | Value   |
  +----------------------+---------+
  | wsrep_cluster_status | Primary |
  +----------------------+---------+

  wsrep_cluster_status 変数の値は、現在のノードが属するクラスターコンポーネントのステータスを示します。可能な値は次のとおりです。

  • Primary: クラスターは正常に機能しています。定足数が満たされています。正常なクラスターでは、すべてのノードが Primary を報告します。
  • Non-primary: ノードはクラスターのプライマリーコンポーネントへの接続を失い、アクティブクラスターの一部ではなくなりました。ただし、ノードは引き続き読み取りクエリーを処理できますが、書き込み操作を処理することはできません。
  • Disconnected: ノードはどのクラスターコンポーネントにも接続されていません。その結果、クエリーを受け入れることができず、データはレプリケートされません。

• ノードのステータスを表示します。

  # mysql -u root -p -e 'show status like "wsrep_local_state_comment";'
  +---------------------------+--------+
  | Variable_name             | Value  |
  +---------------------------+--------+
  | wsrep_local_state_comment | Synced |
  +---------------------------+--------+

  wsrep_local_state_comment 変数の頻繁に使用される値は次のとおりです。

  • Synced: ノードはクラスター内で完全に同期されており、レプリケーションにアクティブに参加しています。
  • Desynced: ノードは引き続きクラスターの一部ですが、状態の遷移で主にビジー状態です。
  • Joining: ノードはクラスターへの参加処理中です。
  • Joined: ノードはクラスターに正常に参加しました。クラスターから書き込みセットを受信して適用できます。
  • Donor: ノードは現在、State Snapshot Transfer (SST) を提供しています。新しいノードが参加して完全な状態の遷移が必要な場合、クラスターは既存のノードを選択して必要なデータを送信します。

• ノードがクラスターからの書き込みセットを受け入れるかどうかを確認します。

  # mysql -u root -p -e 'show status like "wsrep_ready";'
  +---------------+-------+
  | Variable_name | Value |
  +---------------+-------+
  | wsrep_ready   | ON    |
  +---------------+-------+

  wsrep_ready 変数が ON の場合、ノードはコンポーネントを正常に初期化し、クラスターに接続されています。さらに、ノードは同期されているか、クエリーを処理できる状態に達しています。

• ノードが他のホストとネットワーク接続されているか確認します。

  # mysql -u root -p -e 'show status like "wsrep_connected";'
  +-----------------+-------+
  | Variable_name   | Value |
  +-----------------+-------+
  | wsrep_connected | ON    |
  +-----------------+-------+

  ON 値は、ノードがクラスター内の少なくとも 1 つのメンバーに接続されていることを意味します。

• 最後の FLUSH STATUS コマンド以降、またはサーバーの起動以降の書き込みセットのローカル受信キューの平均サイズを表示します。

  # mysql -u root -p -e 'show status like "wsrep_local_recv_queue_avg";'
  +----------------------------+-------+
  | Variable_name              | Value |
  +----------------------------+-------+
  | wsrep_local_recv_queue_avg | 0.012 |
  +----------------------------+-------+

  0 に近い値は理想的な状態であり、ノードが書き込みセットを受信するとそれを適用し続けることを示します。値が継続的に高い、または増加している場合は、ディスク I/O が遅いなどのパフォーマンスのボトルネックが発生している可能性があります。

• フロー制御ステータスを表示します。

  # mysql -u root -p -e 'show status like "wsrep_flow_control_paused";'
  +---------------------------+-------+
  | Variable_name             | Value |
  +---------------------------+-------+
  | wsrep_flow_control_paused | 0     |
  +---------------------------+-------+

  この変数は、ローカル受信キューがいっぱいでフロー制御がトリガーされたために、ノードが一時停止され、新しい着信トランザクションを処理できない時間の割合を表します。値が 0 に近い場合、ノードはレプリケーションワークロードを効率的に継続していることを示します。値が 1.0 に近づくと、ノードが書き込みセットの適用で頻繁または継続的に問題に遭遇し、クラスターのボトルネックになる可能性があることを意味します。

  ノードが頻繁に一時停止する場合は、/etc/my.cnf.d/galera.cnf ファイルの wsrep_slave_threads パラメーターを調整できます。

• ノードが並列に適用できる最小シーケンス番号と最大シーケンス番号間の平均距離を表示します。

  # mysql -u root -p -e 'show status like "wsrep_cert_deps_distance";'
  +--------------------------+-------+
  | Variable_name            | Value |
  +--------------------------+-------+
  | wsrep_cert_deps_distance | 1     |
  +--------------------------+-------+

  値が大きいほど、並列度が高くなります。これは、/etc/my.cnf.d/galera.cnf ファイルの wsrep_slave_threads パラメーターで使用できる最適な値です。

手順

• 特定のノードで、/etc/my.cnf.d/galera.cnf 設定ファイルの [mariadb] セクション内にある wsrep_cluster_address オプションで、1 つ以上の既存クラスターメンバーにアドレスを指定します。

  [mariadb]
  wsrep_cluster_address="gcomm://192.168.0.1"

  新規ノードを既存クラスターノードのいずれかに接続すると、クラスター内のすべてのノードを表示できるようになります。

  ただし、wsrep_cluster_address にクラスターのすべてのノードをリスト表示することを推奨します。

  したがって、1 つ以上のクラスターノードがダウンしても、その他のクラスターノードに接続することでノードがクラスターに参加できます。すべてのメンバーがメンバーシップに同意すると、クラスターの状態が変更します。新規ノードの状態がクラスターの状態と異なる場合、新しいノードは Incremental State Transfer (IST) または State Snapshot Transfer (SST) のいずれかを要求し、他のノードとの一貫性を確保します。