LiteBus
CatalogHosting

Hosting Capability Catalog

LiteBus hosting capabilities define how modules become running workloads. Runtime modules register service dependencies and host manifest entries during composition. Host adapters map the manifest to Generic Host lifecycles, ASP.NET Core endpoints, and OpenTelemetry registration.

The axis is intentionally split into small packages. Composition (AddLiteBus) stays separate from host bridges, management HTTP endpoints, health checks, and telemetry registration.

Manifest Model

AddLiteBus(...)
  -> module registry resolves build order
  -> modules register dependencies and manifest entries
  -> LiteBusHostManifest snapshot is registered
  -> host bridges resolve startup tasks, background loops, diagnostic checks
  -> optional ASP.NET health and management endpoints consume the same manifest

Manifest entry contracts:

  • IStartupTask: one-shot startup work
  • IBackgroundService: long-running loop work
  • IDiagnosticCheck: framework-neutral readiness probes

Startup tasks run first. Background loops start only after startup tasks complete. Any startup task failure fails host startup.

Capabilities (16)

IDNameMaturityPackage(s)
hosting.add-lite-bus-microsoft-diAddLiteBus for Microsoft DIGALiteBus.Runtime.Extensions.Microsoft.DependencyInjection
hosting.add-lite-bus-autofacAddLiteBus for AutofacGALiteBus.Runtime.Extensions.Autofac
hosting.module-registryModule registry and build orderGALiteBus.Runtime
hosting.host-manifestLiteBus host manifest snapshotGALiteBus.Runtime.Abstractions
hosting.startup-tasksOne-shot startup tasksGALiteBus.Runtime.Abstractions
hosting.background-servicesLong-running background servicesGALiteBus.Runtime.Abstractions
hosting.diagnostic-probesFramework-neutral diagnostic probesGALiteBus.Runtime.Abstractions
hosting.generic-host-orchestratorGeneric host orchestratorGALiteBus.Runtime.Extensions.Hosting
hosting.microsoft-hosting-bridgeMicrosoft hosting bridgeGALiteBus.Runtime.Extensions.Microsoft.Hosting
hosting.autofac-hosting-bridgeAutofac hosting bridgeGALiteBus.Runtime.Extensions.Autofac.Hosting
hosting.manual-host-executionManual startup and loop executionGALiteBus.Runtime.Extensions.Hosting
hosting.aspnet-health-checksASP.NET Core health check bridgeGALiteBus.Extensions.Diagnostics.HealthChecks
hosting.aspnet-management-endpointsASP.NET Core management endpointsGALiteBus.Extensions.AspNetCore
hosting.opentelemetry-inboxInbox OpenTelemetry registrationGALiteBus.Inbox.Extensions.OpenTelemetry
hosting.opentelemetry-outboxOutbox OpenTelemetry registrationGALiteBus.Outbox.Extensions.OpenTelemetry
hosting.opentelemetry-transportTransport OpenTelemetry registrationGALiteBus.Transport.Extensions.OpenTelemetry

Package Boundaries

  • Platform, mediation, durable, core, technology, and feature roles register manifest entries without referencing host frameworks directly.
  • Host-adapter packages bridge the manifest to IHostedService, ASP.NET endpoints, or OpenTelemetry builders.
  • Apps remain responsible for authentication, authorization policy, rate limiting, and exporter setup.

Test Sources

AreaPrimary test projects
Runtime hosting contracts and orchestrationLiteBus.Runtime.UnitTests
Autofac compositionLiteBus.Extensions.UnitTests/Autofac
ASP.NET health checksLiteBus.Extensions.IntegrationTests/HealthChecks
ASP.NET management endpointsLiteBus.Extensions.UnitTests/AspNetCore, LiteBus.Extensions.IntegrationTests/AspNetCore
OpenTelemetry registrationLiteBus.Extensions.IntegrationTests/OpenTelemetry

Deep Docs

On this page