Skip to content

Latest commit

 

History

History
69 lines (45 loc) · 3.63 KB

extensions-hosting.md

File metadata and controls

69 lines (45 loc) · 3.63 KB
title summary component reviewed related
NServiceBus.Extensions.Hosting
NServiceBus integration with Microsoft.Extensions.Hosting
Extensions.Hosting
2023-11-23
samples/hosting/generic-host
samples/dependency-injection/aspnetcore

Configuration

An NServiceBus endpoint can be hosted within the generic host with the UseNServiceBus extension method:

snippet: extensions-host-configuration

This code will register the endpoint with the hosting infrastructure and automatically start and stop it based on the host's application lifetime.

Warning

Specify UseNServiceBus before any other service (e.g. ConfigureWebHostDefaults) which requires access to the IMessageSession. Incorrect usage results in a System.InvalidOperationException with the following message:

The message session can't be used before NServiceBus is started. Place UseNServiceBus() on the host builder before registering any hosted service (e.g. services.AddHostedService<HostedServiceAccessingTheSession>()) or the web host configuration (e.g. builder.ConfigureWebHostDefaults) if hosted services or controllers require access to the session.

Logging integration

NServiceBus logging is automatically configured to use the logging configured for the generic host; no NServiceBus specific logging configuration is needed.

Warning

NServiceBus.Extensions.Logging or NServiceBus.MicrosoftLogging.Hosting should not be used.

Dependency injection integration

NServiceBus endpoints hosted as part of the generic host automatically use the provided IServiceCollection and IServiceProvider dependency injection infrastructure. Message handlers can resolve dependencies which are registered in the IServiceCollection.

UseNServiceBus automatically registers an IMessageSession with the container which can be resolved from the IServiceProvider or via dependency injection during runtime.

Configure custom containers

Custom dependency injection containers may be configured using IWebHostBuilder.UseServiceProviderFactory. NServiceBus automatically uses the host's dependency injection container. Refer to the container's documentation for further details.

partial: shutdown-timeout

Stopping the endpoint

When using the generic host, the IEndpointInstance interface to stop the endpoint is not directly exposed. To stop the endpoint, use the IApplicationLifetime interface to gracefully stop the NServiceBus endpoint and other hosted services. See the generic host application lifetime documentation for further information.

Installers

It is not recommended to always run the NServiceBus installers by invoking .EnableInstallers() as this delays startup time and might require more permissions.

Instead of invoking host.

Example:

var isSetup = args.Contains("-s") || args.Contains("/s");

if (isSetup)
{
    // Installers are useful in development. Consider disabling in production.
    // https://docs.particular.net/nservicebus/operations/installers
    // endpointConfiguration.EnableInstallers();

    await Installer.Setup(endpointConfiguration);
    return;
}

// Continue and eventually invoke:
// await host.RunAsync();