コンテンツにスキップ

Nginx と VIP の管理

Nginx と PHP-FPM をリソースグループで管理し、VIP の位置と起動の順を決める例です。2 ノード・2 セグメント構成と fencing の装置を前提にします。

検証状況:リソースグループの順序・health の failover は Linux 上の模擬試験済み(1 台の Rocky Linux 10.2 の上の実 systemd と、network namespace の 2 ノード)。Nginx・PHP-FPM そのものを使った試験は 未検証。

ターミナルウィンドウ
dnf install nginx php-fpm
systemctl disable --now nginx php-fpm
echo ok > /usr/share/nginx/html/healthz

nginx.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
# /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 = 7946
address = { 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 = 7946
address = { 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 = 5
on_failure = "failover"
[security]
psk_file = "/etc/mikagami/cluster.psk"
[failover]
auto = true
cycle_timeout_sec = 180
[fencing]
backend = "command"
verify_polls = 60
段階 順序
起動 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=running

3. 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 分の間、所有を取り戻しません(往復の防止)。

  • failover で解放した後に相手が引き継がなかった場合、サービスは止まったままになりえます。two-node status とログを確かめてください。
  • グループのサービスを Mikagami 以外から起動しないでください。