Files
sor/Server/src/SOR.Host/Program.cs
T

213 lines
11 KiB
C#

// SOR.Host — Multi-service runner
//
// This is the entry point for the entire SOR server. It reads the ENABLED_SERVICES
// environment variable and starts exactly those service modules in a single process.
//
// This is also the ONLY file in the codebase where concrete networking implementations
// (WebSocket, NATS, Redis) are wired to their abstractions. All other code depends on
// interfaces only. To swap a transport or broker, change this file — nothing else.
//
// Examples:
// ENABLED_SERVICES=all → run everything (development)
// ENABLED_SERVICES=gateway,auth → run only Gateway + Auth (small VM)
// ENABLED_SERVICES=gateway → run only Gateway (dedicated gateway pod)
using SOR.Auth;
using SOR.Bazaar;
using SOR.Chat;
using SOR.Collection;
using SOR.Content;
using SOR.Game;
using SOR.Gateway;
using SOR.Matchmaking;
using SOR.Versioning;
using SOR.Networking.Nats;
using SOR.Networking.Redis;
using SOR.Networking.WebSocket;
using SOR.Shared;
using Serilog;
using StackExchange.Redis;
using NATS.Client.Core;
using NATS.Client.Hosting;
using Microsoft.AspNetCore.WebSockets;
using Microsoft.AspNetCore.Server.Kestrel.Core;
using SOR.Auth.Handlers;
// ── ENABLED_SERVICES ──────────────────────────────────────────────────────────
// Read which services this instance should run.
// Environment variable format: comma-separated service names.
// Special value "all" runs every registered service (convenient for development).
//
// Example Kubernetes env:
// - name: ENABLED_SERVICES
// value: "gateway,auth"
var rawServices = Environment.GetEnvironmentVariable("ENABLED_SERVICES") ?? "all";
var enabledServices = rawServices
.Split(',', StringSplitOptions.RemoveEmptyEntries | StringSplitOptions.TrimEntries)
.ToHashSet(StringComparer.OrdinalIgnoreCase);
// Local function: returns true if the named service should start on this instance.
bool IsEnabled(string name) =>
enabledServices.Contains("all") || enabledServices.Contains(name);
// ── BUILDER ───────────────────────────────────────────────────────────────────
var builder = WebApplication.CreateBuilder(args);
// Auth gRPC calls are internal-only and should not share the public WebSocket listener.
// When auth is co-located with gateway and Services:Auth points at a loopback HTTP URL,
// explicitly bind the public HTTP/WebSocket port and add a dedicated HTTP/2 loopback
// listener for gRPC on the configured auth port.
if (IsEnabled("auth") &&
Uri.TryCreate(builder.Configuration["Services:Auth"], UriKind.Absolute, out var authServiceUri) &&
string.Equals(authServiceUri.Scheme, Uri.UriSchemeHttp, StringComparison.OrdinalIgnoreCase) &&
authServiceUri.IsLoopback)
{
builder.WebHost.ConfigureKestrel(options =>
{
options.ListenAnyIP(8080, listenOptions =>
{
listenOptions.Protocols = HttpProtocols.Http1;
});
options.ListenLocalhost(authServiceUri.Port, listenOptions =>
{
listenOptions.Protocols = HttpProtocols.Http2;
});
});
}
// ── Logging ───────────────────────────────────────────────────────────────────
// Replace .NET's default logger with Serilog.
// Configuration comes from the "Serilog" section of appsettings.json.
// ReadFrom.Configuration automatically picks up sinks, minimum levels, and enrichers.
builder.Host.UseSerilog((context, config) =>
config.ReadFrom.Configuration(context.Configuration));
// ── Shared services ───────────────────────────────────────────────────────────
// Registers IMessageSerializer (SystemTextJsonSerializer by default).
// To swap to MessagePack: after this call, add:
// builder.Services.AddSingleton<IMessageSerializer, MessagePackSerializer>()
// which overrides the default registration.
builder.Services.AddSharedServices();
// ── Shared infrastructure (Singleton per process) ─────────────────────────────
// Redis connection multiplexer: one connection pool for the entire process.
// All services that need Redis inject IConnectionMultiplexer from DI.
// GetConnectionString("Redis") reads from ConnectionStrings:Redis in appsettings.json
// or the ConnectionStrings__Redis environment variable.
builder.Services.AddSingleton<IConnectionMultiplexer>(
ConnectionMultiplexer.Connect(
builder.Configuration.GetConnectionString("Redis")
?? throw new InvalidOperationException(
"Missing configuration: ConnectionStrings:Redis. " +
"Set this to your Redis connection string (e.g., 'localhost:6379').")));
// NATS client: one connection for the entire process.
// AddNats is from NATS.Client.Hosting and registers NatsConnection as Singleton,
// exposed as both NatsConnection and INatsConnection.
// The 'opts with { Url = ... }' syntax uses a C# record 'with' expression to clone the
// default options and set only the URL — all other defaults remain unchanged.
builder.Services.AddNats(configureOpts: opts =>
opts with
{
Url = builder.Configuration["Nats:Url"]
?? throw new InvalidOperationException(
"Missing configuration: Nats:Url. " +
"Set this to your NATS server URL (e.g., 'nats://localhost:4222').")
});
// ── Health checks ─────────────────────────────────────────────────────────────
// Minimal health check for Kubernetes liveness/readiness probes.
// Returns 200 OK at /health if the process is running.
// TODO: add dependency health checks (Redis, NATS, Postgres) per service.
builder.Services.AddHealthChecks();
// ── Networking transports ─────────────────────────────────────────────────────
// These are the CONCRETE implementations of the networking abstractions.
// This section is the "wiring" point. To swap a transport, change only here.
// AddWebSockets must be called here (from the Web SDK host project) rather than
// inside SOR.Networking.WebSocket.ServiceRegistration, because the AddWebSockets
// extension method resolves correctly only from a Microsoft.NET.Sdk.Web project.
// Without this call, context.WebSockets.IsWebSocketRequest is always false.
if (IsEnabled("gateway"))
builder.Services.AddWebSockets(opts =>
{
// ASP.NET Core's built-in keep-alive interval (protocol-level ping/pong).
// Our WebSocketClientConnection also sends application-level pings independently.
opts.KeepAliveInterval = TimeSpan.FromSeconds(30);
});
// WebSocket transport: ITransport → WebSocketTransport
// Reads options from "WebSocket" config section.
if (IsEnabled("gateway"))
builder.Services.AddWebSocketTransport(builder.Configuration);
// NATS event bus: IEventBus → NatsEventBus (wraps the INatsClient registered above)
builder.Services.AddNatsEventBus(builder.Configuration);
// Redis client push: IClientPush → RedisClientPush (write side of push delivery)
// The Gateway's read side (RedisPushSubscriber) is internal to SOR.Gateway.
builder.Services.AddRedisClientPush();
// ── Service modules ───────────────────────────────────────────────────────────
// Each service registers its own handlers, options, DbContext, repositories, etc.
// Only services listed in ENABLED_SERVICES are started.
if (IsEnabled("auth")) builder.Services.AddAuthService(builder.Configuration);
if (IsEnabled("chat")) builder.Services.AddChatService(builder.Configuration);
if (IsEnabled("collection")) builder.Services.AddCollectionService(builder.Configuration);
if (IsEnabled("gateway")) builder.Services.AddGatewayService(builder.Configuration);
if (IsEnabled("bazaar")) builder.Services.AddBazaarService(builder.Configuration);
if (IsEnabled("content")) builder.Services.AddContentService(builder.Configuration);
if (IsEnabled("versioning")) builder.Services.AddVersioningService(builder.Configuration);
if (IsEnabled("matchmaking")) builder.Services.AddMatchmakingService(builder.Configuration);
if (IsEnabled("game")) builder.Services.AddGameService(builder.Configuration);
// TODO: Uncomment as each service is implemented:
// if (IsEnabled("leaderboard")) builder.Services.AddLeaderboardService(builder.Configuration);
// if (IsEnabled("admin")) builder.Services.AddAdminService(builder.Configuration);
// ── BUILD ─────────────────────────────────────────────────────────────────────
var app = builder.Build();
// ── Middleware pipeline ───────────────────────────────────────────────────────
// Middleware runs in the order it's added. Order matters.
// WebSocket upgrade support: MUST come before UseRouting and UseWebSocketTransport.
// This activates the protocol-level WebSocket upgrade handler in Kestrel.
if (IsEnabled("gateway"))
app.UseWebSockets();
// WebSocket upgrade interceptor: MUST come before UseRouting.
// Intercepts HTTP upgrade requests to "/ws" and hands them to WebSocketTransport.
if (IsEnabled("gateway"))
app.UseWebSocketTransport();
// Routing: maps URL paths to gRPC service routes.
app.UseRouting();
// ── Endpoints ─────────────────────────────────────────────────────────────────
// gRPC service routes: map each handler to its Protobuf-defined URL.
if (IsEnabled("auth"))
app.MapGrpcService<AuthGrpcHandler>();
// Health check endpoint: Kubernetes probes GET /health to check liveness.
app.MapHealthChecks("/health");
// ── RUN ───────────────────────────────────────────────────────────────────────
Log.Information("SOR Host starting. Services: {Services}", rawServices);
// RunAsync blocks until the process receives a shutdown signal (SIGTERM, Ctrl+C).
// On shutdown, ASP.NET Core calls StopAsync on all IHostedService implementations
// (including GatewayHostedService) in reverse registration order.
await app.RunAsync();