コンテンツにスキップ

Apache HTTP Server と VIP の管理

Rocky Linux の httpd パッケージの httpd.service を、そのまま Mikagami で管理します。ここでは 2 ノード・1 セグメント構成を例にします。2 セグメント構成でも [service] と [health] は同じです。

検証状況:systemd の unit・command の資源・VIP の組み合わせと restart の動作は、1 台の Rocky Linux 10.2 の上で実際の systemd を使って Linux 上の模擬試験済み。Apache そのものを使った試験は 未検証。

ターミナルウィンドウ
dnf install httpd
systemctl disable --now httpd # Mikagami だけが起動する(OS の起動時に自動で起動しない)
echo ok > /var/www/html/healthz # ヘルスチェック用(両ノードで同じ内容)

httpd.service は、パッケージの unit をそのまま使います。unit に Restart= を足さないでください(Mikagami 以外がサービスを起動すると、Standby の「資源なし」の確認が成り立ちません)。

ターミナルウィンドウ
systemctl cat httpd.service # 内容の確認

/etc/httpd/conf/httpd.conf の Listen を VIP にすると、VIP が付いていない Standby では httpd は起動できません。Mikagami は単一の [service] では VIP を付けてからサービスを起動するので、この設定で動きます。

Listen 192.168.100.50:80

すべてのアドレスで待ち受ける既定の Listen 80 でも動きます。

2. 設定(両ノードで同じファイル)

Section titled “2. 設定(両ノードで同じファイル)”
/etc/mikagami/mikagami.toml
# /etc/mikagami/mikagami.toml — Apache HTTP Server と VIP(2 ノード・1 セグメント、両ノードで同じファイル)
[cluster]
id = "apache-ha"
topology = "two-node"
[nodes.node-a]
preferred = true
[nodes.node-b]
[two_node]
fencing_device = "none"
[[two_node.link]]
segment = "lan"
role = "combined"
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"
[service]
manager = "systemd"
unit = "httpd.service"
start_timeout_sec = 30
stop_timeout_sec = 30
[health]
command = ["/usr/libexec/mikagami/check-http", "http://192.168.100.50/healthz", "--status", "200", "--contains", "ok", "--timeout", "2"]
timeout_sec = 5
failure_threshold = 3
success_threshold = 2
on_failure = "restart"
restart_limit = 2
[security]
psk_file = "/etc/mikagami/cluster.psk"
  • command の終了コード 0 が正常です。同梱の /usr/libexec/mikagami/check-http は、URL に GET を送り、HTTP の status(--status、既定 200)と、本文に含まれる文字列(--contains、固定の文字列)を確かめます。
  • failure_threshold 回続けて失敗すると異常、success_threshold 回続けて成功すると正常に戻ります。Active で約 2 秒ごとに実行します。
  • timeout_sec は 2 ノード構成では 30 秒以下です(daemon の制御のループの中で実行するため、短くしてください)。
  • on_failure:
値 動作
warn(既定) ログと two-node status に出すだけ
restart Active のまま httpd を止めて起動し直す(VIP は付けたまま)。10 分に restart_limit 回まで。上限を超えたら警告のみ。停止または起動を確かめられない時は資源を解放する
failover 相手が接続中で健全な Standby の時だけ、資源を解放して相手に引き継ぐ。fence は使わない

状態の確認:

ターミナルウィンドウ
mikagami two-node status --config /etc/mikagami/mikagami.toml
# health (Active only): healthy (failures 0 successes N in a row), on_failure restart, ...
ターミナルウィンドウ
systemctl enable --now mikagami
curl -s http://192.168.100.50/healthz
ターミナルウィンドウ
# Active で httpd を止めて、restart の動作を見る(試験の時だけ)
systemctl stop httpd
journalctl -u mikagami -o cat -f

WARN health unhealthy after 3 consecutive failures の後、INFO health restart done; healthy が出れば、ローカルの再起動で回復しています。詳しい試験は障害試験・復旧手順にあります。

  • httpd を Mikagami 以外(systemctl enable、他の監視の仕組み)から起動しないでください。
  • ヘルスチェックの URL は、Active の側で応答するものにします(VIP の URL、または 127.0.0.1)。