機能紹介
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。
安全の考え方
Section titled “安全の考え方”- 2 台が同時に Active にならないことを最優先にします。
- 通信が切れただけでは、相手が止まったとはみなしません。 通信断は「相手が見えない」ことであって「相手が止まった」証拠ではないためです。
- 相手の喪失で自動に引き継ぐのは、fencing の装置で相手の OS の停止を確かめた後だけです。装置が無い構成では、運用者が相手の停止を確かめてから手動で切り替えます。
- 計画停止と冷起動(2 ノード構成)は、両ノードが接続している時に、相手が資源を持っていないこと(サービス停止・VIP なし)を確かめた上で、相手の合意(grant)を得て行います。補助ノード付き構成では、補助ノードの lease がこの役を担います。
- 資源の停止を確かめられない時は、そのノードは資源を持っているとみなされ、所有を手放しません。
- 自動の failback(優先ノードへの自動の戻し)はしません。
対象外(実装していないもの)
Section titled “対象外(実装していないもの)”- 3 台以上のノード、複数のリソースグループ、資源ごとの配置の制約。
- BGP による経路の広告(AWS BGP 構成は設計・検証予定です)。
- rolling upgrade(更新は両ノードを止めて行います)。