feat(health.akka): cluster health check with configurable status policy

2026-06-01 06:47:29 -04:00
parent 1ab2f32e8e
commit 25dd328280
4 changed files with 315 additions and 0 deletions
@@ -0,0 +1,75 @@
+using Akka.Cluster;
+using Microsoft.Extensions.DependencyInjection;
+using Microsoft.Extensions.Diagnostics.HealthChecks;
+using ZB.MOM.WW.Health.Akka;
+
+namespace ZB.MOM.WW.Health.Akka.Tests;
+
+/// <summary>
+/// Table-driven tests for the pure status-mapping function inside <see cref="AkkaClusterStatusPolicy"/>.
+/// The two presets (<see cref="AkkaClusterStatusPolicy.Default"/> and
+/// <see cref="AkkaClusterStatusPolicy.OtOpcUaCompat"/>) are the convergence targets for ScadaBridge
+/// and OtOpcUa respectively; every <see cref="MemberStatus"/> is exercised so a drift in either
+/// preset fails loudly. Also covers the startup-safety null-guard on <see cref="AkkaClusterHealthCheck"/>.
+/// </summary>
+public sealed class AkkaClusterStatusPolicyTests
+{
+    public static IEnumerable<object[]> DefaultCases() => new[]
+    {
+        new object[] { MemberStatus.Up, HealthStatus.Healthy },
+        new object[] { MemberStatus.Joining, HealthStatus.Healthy },
+        new object[] { MemberStatus.Leaving, HealthStatus.Degraded },
+        new object[] { MemberStatus.Exiting, HealthStatus.Degraded },
+        new object[] { MemberStatus.WeaklyUp, HealthStatus.Unhealthy },
+        new object[] { MemberStatus.Down, HealthStatus.Unhealthy },
+        new object[] { MemberStatus.Removed, HealthStatus.Unhealthy },
+    };
+
+    [Theory]
+    [MemberData(nameof(DefaultCases))]
+    public void Default_MapsEveryStatus(MemberStatus status, HealthStatus expected)
+    {
+        Assert.Equal(expected, AkkaClusterStatusPolicy.Default.Evaluate(status));
+    }
+
+    public static IEnumerable<object[]> OtOpcUaCompatCases() => new[]
+    {
+        new object[] { MemberStatus.Up, HealthStatus.Healthy },
+        new object[] { MemberStatus.Joining, HealthStatus.Degraded },
+        new object[] { MemberStatus.Leaving, HealthStatus.Degraded },
+        new object[] { MemberStatus.Exiting, HealthStatus.Degraded },
+        new object[] { MemberStatus.WeaklyUp, HealthStatus.Degraded },
+        new object[] { MemberStatus.Down, HealthStatus.Degraded },
+        new object[] { MemberStatus.Removed, HealthStatus.Degraded },
+    };
+
+    [Theory]
+    [MemberData(nameof(OtOpcUaCompatCases))]
+    public void OtOpcUaCompat_OnlyUpIsHealthy(MemberStatus status, HealthStatus expected)
+    {
+        Assert.Equal(expected, AkkaClusterStatusPolicy.OtOpcUaCompat.Evaluate(status));
+    }
+
+    [Fact]
+    public void CustomPolicy_UsesSuppliedFunc()
+    {
+        var policy = new AkkaClusterStatusPolicy(_ => HealthStatus.Unhealthy);
+        Assert.Equal(HealthStatus.Unhealthy, policy.Evaluate(MemberStatus.Up));
+    }
+
+    [Fact]
+    public async Task HealthCheck_NoActorSystem_ReturnsDegraded()
+    {
+        var provider = new ServiceCollection().BuildServiceProvider();
+        var check = new AkkaClusterHealthCheck(provider, AkkaClusterStatusPolicy.Default);
+
+        var result = await check.CheckHealthAsync(NewContext(check));
+
+        Assert.Equal(HealthStatus.Degraded, result.Status);
+    }
+
+    private static HealthCheckContext NewContext(IHealthCheck check) => new()
+    {
+        Registration = new HealthCheckRegistration("akka-cluster", check, HealthStatus.Unhealthy, tags: null),
+    };
+}