feat(host): health endpoints + per-environment appsettings layout

2026-05-26 05:23:01 -04:00
parent e2b357f89a
commit fa1d685ccd
5 changed files with 144 additions and 0 deletions
@@ -0,0 +1,33 @@
+using Microsoft.Extensions.Diagnostics.HealthChecks;
+using ZB.MOM.WW.OtOpcUa.Commons.Interfaces;
+
+namespace ZB.MOM.WW.OtOpcUa.Host.Health;
+
+/// <summary>
+/// Reports Healthy on the admin-role leader, Degraded on a non-leader admin member. Used by
+/// the <c>/health/active</c> endpoint so external load balancers can route admin-singleton
+/// traffic to the current leader (cookie sessions still work on either node — DataProtection
+/// keys are shared).
+/// </summary>
+public sealed class AdminRoleLeaderHealthCheck : IHealthCheck
+{
+    private readonly IClusterRoleInfo _roleInfo;
+
+    public AdminRoleLeaderHealthCheck(IClusterRoleInfo roleInfo)
+    {
+        _roleInfo = roleInfo;
+    }
+
+    public Task<HealthCheckResult> CheckHealthAsync(HealthCheckContext context, CancellationToken cancellationToken = default)
+    {
+        if (!_roleInfo.HasRole("admin"))
+            return Task.FromResult(HealthCheckResult.Healthy("Node does not carry admin role"));
+
+        var leader = _roleInfo.RoleLeader("admin");
+        var isLeader = leader is not null && leader.Value.Equals(_roleInfo.LocalNode);
+
+        return Task.FromResult(isLeader
+            ? HealthCheckResult.Healthy($"Admin leader ({_roleInfo.LocalNode})")
+            : HealthCheckResult.Degraded($"Admin member but not leader (leader={leader?.Value ?? "<unknown>"})"));
+    }
+}