Core-hosting with AddNServiceBusEndpoint#8206
Merged
Merged
Conversation
mattmercurio
force-pushed
the
docs-addnservicebusendpoint-multi
branch
2 times, most recently
from
547cd44 to
c36de1a
Compare
DavidBoike
reviewed
Apr 27, 2026
Contributor
|
This is already pretty good! |
DavidBoike
reviewed
Apr 28, 2026
mattmercurio
force-pushed
the
docs-addnservicebusendpoint-multi
branch
from
da40563 to
def7801
Compare
DavidBoike
force-pushed
the
docs-addnservicebusendpoint-multi
branch
from
a3a216a to
fa9a639
Compare
DavidBoike
reviewed
May 1, 2026
| --- | ||
|
|
||
| > [!NOTE] | ||
| > For new development, prefer [hosting with Microsoft.Extensions.Hosting](/nservicebus/hosting/core-hosting.md) using the built-in `AddNServiceBusEndpoint` integration on `IServiceCollection`. This page describes the existing package-based `NServiceBus.Extensions.Hosting` and `UseNServiceBus` integration path. |
Member
There was a problem hiding this comment.
Thinking add "which is deprecated starting in NServiceBus version 10.2.0" and also a link to the upgrade guide.
| The [Microsoft Generic Host](https://docs.microsoft.com/en-us/aspnet/core/fundamentals/host/generic-host) is the most common way to host NServiceBus on .NET Core. NServiceBus can be integrated with the generic host using the [NServiceBus.Extensions.Hosting package](/nservicebus/hosting/extensions-hosting.md). | ||
| partial: generic-host | ||
|
|
||
| ## Self-hosting |
Member
There was a problem hiding this comment.
When I preview this, I still get Endpoint.Create() snippets. Andreas marked those as ignore the obsolete, so we need to track down where else they're being used to see what we need to do here.
…r section as comparison table
Co-authored-by: David Boike <david.boike@gmail.com>
mattmercurio
force-pushed
the
docs-addnservicebusendpoint-multi
branch
from
bab51de to
6fd3be6
Compare
danielmarbach
approved these changes
May 6, 2026
Co-authored-by: Daniel Marbach <daniel.marbach@openplace.net>
…m/Particular/docs.particular.net into docs-addnservicebusendpoint-multi
DavidBoike
reviewed
May 6, 2026
Co-authored-by: David Boike <david.boike@gmail.com>
DavidBoike
added a commit
that referenced
this pull request
May 20, 2026
* Add AddNServiceBusEndpoint hosting page * Core hosting guidance * Core hosting guidance * Modern hosting language changes * Core-hosting and snippets * 'Recommended' hosting wording * Update nservicebus/hosting/core-hosting.md Co-authored-by: Daniel Marbach <daniel.marbach@openplace.net> * Apply suggestions from code review Co-authored-by: Daniel Marbach <daniel.marbach@openplace.net> * Update nservicebus/hosting/core-hosting.md Co-authored-by: David Boike <david.boike@gmail.com> * Per-tenant hosting scenario * Reframe core-hosting opening and rewrite endpoint name / DI identifier section as comparison table * Clarify IMessageSession resolution and add explicit DI examples * revert critical-errors.md changes * Drop upgrade-guide content from core-hosting.md * Use partials for hosting/index.md generic-host section * Rename hosting title to Microsoft.Extensions.Hosting instead of 'recommended' * Tighten multi-endpoint section * Clarify DI identifier and rework per-tenant example * Use partials for web-application hosting * Took out note on NServiceBus.Extensions.Hosting * Apply suggestions from code review Co-authored-by: David Boike <david.boike@gmail.com> * Rename MyService to MyGlobalService * Note that NServiceBus.Extensions.Hosting is deprecated in 10.2 * Use endpoint identifier terminology instead of "DI indentifier" * Scope per-tenant identifier with endpoint name to avoid collision * Show host construction inline for IMessageSession resolution * Version-gate self-hosting on hosting/index * Applying PR suggestions with minor edits * Apply suggestions from code review Co-authored-by: Daniel Marbach <daniel.marbach@openplace.net> * Fix Core snippets for extension method alignment * Apply suggestions from code review Co-authored-by: David Boike <david.boike@gmail.com> --------- Co-authored-by: Daniel Marbach <daniel.marbach@openplace.net> Co-authored-by: David Boike <david.boike@gmail.com>
DavidBoike
added a commit
that referenced
this pull request
May 21, 2026
* Core8 transitive reference fix * Core 10.2 alpha 5 * Restore modern logging info * Swap out a bunch of IEndpointInstance for IMessageSession (or burn IEndpointIntance) * A bunch of weird Writer tests (disabled TreatWarningsAsErrors locally to run tests) * Suppress obsoletes for selfhosting snippets still supported in v10 * Suppress obsoletes for snippets that should still exist in v10 * One more suppression * Fix general installer snippet * Guide towards the new installer API * Suppress log obsoletes * Slight change to installer snippet * Convention-based handlers (#8224) * Convention-based handlers * Apply suggestions from code review Co-authored-by: Daniel Marbach <daniel.marbach@openplace.net> Co-authored-by: Andreas Öhlund <andreas.ohlund@particular.net> * Make a TLDR snippet * Whoopsie --------- Co-authored-by: Daniel Marbach <daniel.marbach@openplace.net> Co-authored-by: Andreas Öhlund <andreas.ohlund@particular.net> * Handler saga registration (#8214) * Registration page first version while keeping some redundancy * Fix missing index problem * Better page split and wording tweaks * Refactor handler registration example in documentation Updated the registration code example to reflect new API usage. * Small tweaks * Fix version boundary to use integer majors * Apply suggestions from code review Co-authored-by: Andreas Öhlund <andreas.ohlund@particular.net> * Switch order * Better documentation around the conventions * Explain better the conventions --------- Co-authored-by: Daniel Marbach <danielmarbach@users.noreply.github.com> Co-authored-by: Andreas Öhlund <andreas.ohlund@particular.net> * Address deprecated Endpoint APIs in samples (#8236) * 2 projects needed a Core reference * Change affected samples to Core 10 alphas * Easy NSB.Extensions.Hosting removals * Rest of NSB.Extensions.Hosting * Delete "Passing user identity between endpoints using a custom header" sample that uses mutators * Remove "Startup and Shutdown Sequence" sample * Fix deprecated APIs in 4 samples * Updated more samples * Bunch more samples * Fix bad cancellation token usage * Couple more * Need to review this Kafka-Functions sample separately * Kinda big SqlP sample * Bunch more * Version-scope the externally managed mode sample and add a warning * Remaining samples * Fix links and related * Another fix * Core-hosting with AddNServiceBusEndpoint (#8206) * Add AddNServiceBusEndpoint hosting page * Core hosting guidance * Core hosting guidance * Modern hosting language changes * Core-hosting and snippets * 'Recommended' hosting wording * Update nservicebus/hosting/core-hosting.md Co-authored-by: Daniel Marbach <daniel.marbach@openplace.net> * Apply suggestions from code review Co-authored-by: Daniel Marbach <daniel.marbach@openplace.net> * Update nservicebus/hosting/core-hosting.md Co-authored-by: David Boike <david.boike@gmail.com> * Per-tenant hosting scenario * Reframe core-hosting opening and rewrite endpoint name / DI identifier section as comparison table * Clarify IMessageSession resolution and add explicit DI examples * revert critical-errors.md changes * Drop upgrade-guide content from core-hosting.md * Use partials for hosting/index.md generic-host section * Rename hosting title to Microsoft.Extensions.Hosting instead of 'recommended' * Tighten multi-endpoint section * Clarify DI identifier and rework per-tenant example * Use partials for web-application hosting * Took out note on NServiceBus.Extensions.Hosting * Apply suggestions from code review Co-authored-by: David Boike <david.boike@gmail.com> * Rename MyService to MyGlobalService * Note that NServiceBus.Extensions.Hosting is deprecated in 10.2 * Use endpoint identifier terminology instead of "DI indentifier" * Scope per-tenant identifier with endpoint name to avoid collision * Show host construction inline for IMessageSession resolution * Version-gate self-hosting on hosting/index * Applying PR suggestions with minor edits * Apply suggestions from code review Co-authored-by: Daniel Marbach <daniel.marbach@openplace.net> * Fix Core snippets for extension method alignment * Apply suggestions from code review Co-authored-by: David Boike <david.boike@gmail.com> --------- Co-authored-by: Daniel Marbach <daniel.marbach@openplace.net> Co-authored-by: David Boike <david.boike@gmail.com> * Add links to Externally Managed Mode sample * Update hosting index page (#8243) * The self-hosting section stops with v9 * Fix header hierarchy and fix resulting links * No point defining a term we say nothing useful about * Don't need a whole H2 section for a footnote * This just doesn't make sense to have anymore (and people using Endpoint.Start() will figure that out) * WriteDiagnosticsToLog * Host ID (#8246) * Host id override * Improve the guidance because SHA1 was only FIPS compliance on .NET Framework * Apply suggestions from code review Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com> * Make the message consistent in regards to non-crypto hashing * Less absolute * Apply suggestions from code review Co-authored-by: David Boike <david.boike@gmail.com> --------- Co-authored-by: Daniel Marbach <danielmarbach@users.noreply.github.com> Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com> Co-authored-by: David Boike <david.boike@gmail.com> * Add EndpointLoggingScope documentation for NServiceBus 10.2 (#8261) - Add 'Enriching logs outside the message pipeline' section to logging docs - Add MyBackgroundService snippet demonstrating BeginEndpointScope usage - Update NServiceBus to 10.2.0-alpha.12 for EndpointLoggingScope type - Refactor Recoverability/Pipeline.cs to use context.MessageId/context.Body instead of obsolete context.FailedMessage Co-authored-by: Daniel Marbach <danielmarbach@users.noreply.github.com> * Update stable * Fix links (fingers crossed) --------- Co-authored-by: Andreas Öhlund <andreas.ohlund@particular.net> Co-authored-by: Daniel Marbach <daniel.marbach@openplace.net> Co-authored-by: Daniel Marbach <danielmarbach@users.noreply.github.com> Co-authored-by: Matt Mercurio <mattmercurio@users.noreply.github.com> Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
4 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
No description provided.