コンテンツにスキップ

機能紹介

Mikagami は、2 台の Linux ノードの一方だけでサービスと VIP を動かし、障害の時に安全に引き継ぎます。ここに書くのは v0.8.0 に実装済みの機能です。検証の範囲は制限事項・検証状況を参照してください。

構成 台数 相手の喪失の自動の引き継ぎ
2 ノード・1 セグメント 2 fencing の装置があり、その制御の経路が別の時だけ
2 ノード・2 セグメント(推奨) 2 fencing の装置で相手の停止を確かめた後だけ
2 ノード+補助ノード(Witness) 3 [fencing] backend = "command" で相手を隔離した後だけ
  • 共通設定(2 ノード構成):両ノードに同じ mikagami.toml を置き、各ノードで mikagami node register を 1 回だけ実行してノード ID を登録します。ノード ID をホスト名から推測することはありません。2 台の設定が違う時は接続せず、config mismatch と表示して自動の切替をしません。
  • サービスの管理:systemd の unit、または start/stop/status のコマンド(argv の配列。シェルを通しません)。
  • リソースグループ(2 ノード構成):[[group.resource]] に systemd/command/vip の資源を並べると、書いた順に起動し、逆の順に停止します。
  • VIP:Linux のインタフェースに VIP を付け、サービスのヘルスチェックが成功してから gratuitous ARP で公開します(/usr/sbin/arping を使います)。
  • ヘルスチェック:任意のコマンドで判定します(終了コード 0 が正常)。HTTP の確認用の script check-http が RPM に入っています。連続の失敗・成功の回数で異常と回復を判定します。異常の時の動作は warn(警告のみ)、restart(ローカルで再起動)、failover(相手への切替)から選べます(restart/failover は 2 ノード構成のみ)。
  • fencing:相手を止めるコマンド(fence)と、止まったことを確かめるコマンド(verify)を設定します。自動の引き継ぎは、verify が相手の停止を確かめた後だけです。
  • 状態の確認:mikagami two-node status(2 ノード構成)、mikagami status(補助ノード付き構成)、journalctl -u mikagami。
  • 2 台が同時に Active にならないことを最優先にします。
  • 通信が切れただけでは、相手が止まったとはみなしません。 通信断は「相手が見えない」ことであって「相手が止まった」証拠ではないためです。
  • 相手の喪失で自動に引き継ぐのは、fencing の装置で相手の OS の停止を確かめた後だけです。装置が無い構成では、運用者が相手の停止を確かめてから手動で切り替えます。
  • 計画停止と冷起動(2 ノード構成)は、両ノードが接続している時に、相手が資源を持っていないこと(サービス停止・VIP なし)を確かめた上で、相手の合意(grant)を得て行います。補助ノード付き構成では、補助ノードの lease がこの役を担います。
  • 資源の停止を確かめられない時は、そのノードは資源を持っているとみなされ、所有を手放しません。
  • 自動の failback(優先ノードへの自動の戻し)はしません。

対象外(実装していないもの)

Section titled “対象外(実装していないもの)”
  • 3 台以上のノード、複数のリソースグループ、資源ごとの配置の制約。
  • BGP による経路の広告(AWS BGP 構成は設計・検証予定です)。
  • rolling upgrade(更新は両ノードを止めて行います)。