Nginx と VIP の管理
Nginx と PHP-FPM をリソースグループで管理し、VIP の位置と起動の順を決める例です。2 ノード・2 セグメント構成と fencing の装置を前提にします。
検証状況:リソースグループの順序・health の failover は Linux 上の模擬試験済み(1 台の Rocky Linux 10.2 の上の実 systemd と、network namespace の 2 ノード)。Nginx・PHP-FPM そのものを使った試験は 未検証。
1. 準備(両ノード)
Section titled “1. 準備(両ノード)”dnf install nginx php-fpmsystemctl disable --now nginx php-fpmecho ok > /usr/share/nginx/html/healthznginx.service、php-fpm.service はパッケージの unit をそのまま使います。Restart= を足さないでください。
Nginx を VIP で待ち受けさせる場合:
server { listen 192.168.100.50:80; root /usr/share/nginx/html;}2. 設定(両ノードで同じファイル)
Section titled “2. 設定(両ノードで同じファイル)”# /etc/mikagami/mikagami.toml — Nginx+PHP-FPM と VIP のグループ(2 ノード・2 セグメント、両ノードで同じファイル)[cluster]id = "nginx-ha"topology = "two-node"
[nodes.node-a]preferred = true[nodes.node-a.fencing]fence = ["/usr/local/sbin/fence-node", "node-a"]verify = ["/usr/local/sbin/verify-node-fenced", "node-a"]
[nodes.node-b][nodes.node-b.fencing]fence = ["/usr/local/sbin/fence-node", "node-b"]verify = ["/usr/local/sbin/verify-node-fenced", "node-b"]
[two_node]fencing_device = "independent"fencing_path = "separate"
[[two_node.link]]segment = "ha-net"role = "ha"port = 7946address = { node-a = "10.0.1.11", node-b = "10.0.1.12" }interface = { node-a = "eth1", node-b = "eth1" }
[[two_node.link]]segment = "service-net"role = "service"port = 7946address = { node-a = "192.168.100.11", node-b = "192.168.100.12" }interface = { node-a = "eth0", node-b = "eth0" }
[vip]address = "192.168.100.50/24"interface = "eth0"
# 書いた順に起動し、逆の順に停止する。nginx が VIP で待ち受けるので VIP を nginx の前に置く。[[group.resource]]name = "php-fpm"type = "systemd"unit = "php-fpm.service"
[[group.resource]]name = "vip"type = "vip"
[[group.resource]]name = "nginx"type = "systemd"unit = "nginx.service"
[health]command = ["/usr/libexec/mikagami/check-http", "http://192.168.100.50/healthz", "--status", "200", "--timeout", "2"]timeout_sec = 5on_failure = "failover"
[security]psk_file = "/etc/mikagami/cluster.psk"
[failover]auto = truecycle_timeout_sec = 180
[fencing]backend = "command"verify_polls = 60リソースグループの動作
Section titled “リソースグループの動作”| 段階 | 順序 |
|---|---|
| 起動 | php-fpm を起動して running を確認 → VIP を付けて確認 → nginx を起動して確認 → health が成功 → gratuitous ARP で VIP を公開 |
| 停止 | 逆順:nginx を停止して確認 → VIP を外して確認 → php-fpm を停止して確認 |
| 起動の途中の失敗 | その先は起動せず、全体を逆順に止めて所有を手放す |
| 停止の途中の失敗 | そこで止め、それより前(先に起動した資源)は止めない。資源を持っているとみなし、所有を保つ(相手は fencing の確認なしに引き継がない) |
type = "vip"はちょうど 1 つ、systemd/commandは 1 つ以上、資源は 8 個までです。- VIP に bind するサービスは VIP の後に置きます。どの位置でも、VIP の公開(gratuitous ARP)は health の成功の後です。
mikagami two-node status --config /etc/mikagami/mikagami.toml# resources (as last observed, start order): php-fpm=running vip=present nginx=running3. health による切替(on_failure = "failover")
Section titled “3. health による切替(on_failure = "failover")”Active の health が failure_threshold 回続けて失敗すると、次の条件をすべて満たす時だけ、Active は自分のグループを逆順に止めて VIP を外し、その解放を確かめた後に相手が引き継ぎます。
- 相手が接続中で、資源を持たない Standby で、所有の資格がある。
- 相手の側に grant や claim が残っておらず、相手が停止の途中でない。
failover.auto = true。
条件を満たさない時は警告だけで、unhealthy の間は 30 秒ごとに再び試します。health の失敗だけで相手を昇格させることはなく、fence も使いません。 解放したノードは 10 分の間、所有を取り戻しません(往復の防止)。
安全上の注意
Section titled “安全上の注意”failoverで解放した後に相手が引き継がなかった場合、サービスは止まったままになりえます。two-node statusとログを確かめてください。- グループのサービスを Mikagami 以外から起動しないでください。