Hi everyone,
We’ve just released NServiceBus.AzureFunctions.AzureServiceBus 1.0.0.
This package replaces NServiceBus.AzureFunctions.Worker.ServiceBus, which is now considered feature complete. We’ll continue providing support and critical fixes, but we won’t add new features to the worker package. New projects should use NServiceBus.AzureFunctions.AzureServiceBus instead.
The old worker package supported only a single NServiceBus endpoint per Azure Functions app. Processing messages from multiple queues required a separate function app for each one. With the new package, one function app using the isolated worker model can host multiple NServiceBus endpoints.
What’s new
- Multi-endpoint hosting: Run multiple message-processing endpoints in a single function app, each triggered from a different Service Bus trigger.
- Source-generator-driven configuration: Declare endpoints using the
[NServiceBusFunction]attribute on partial methods. A source generator handles the wiring at build time. - Dead-letter queue support: Failed messages are moved to the error queue through native Azure Service Bus dead-lettering, with automatic forwarding to the configured error queue.
- Send-only endpoints: Use
[NServiceBusSendOnlyFunction]with any Azure Functions trigger, for example HTTP or timer triggers, to send messages without processing incoming ones. - Explicit handler registration: Handlers and sagas are registered explicitly in each endpoint’s configuration method. Avoiding assembly scanning helps reduce cold start times.
[!NOTE]
Message-processing endpoints currently receive messages via Azure Service Bus triggers only. If another trigger type matters for your scenario, please comment on this GitHub issue.
Migration path
Existing users of NServiceBus.AzureFunctions.Worker.ServiceBus should migrate to NServiceBus.AzureFunctions.AzureServiceBus. Follow the migration guide for instructions.
See the Azure Functions documentation, or try the Azure Functions with NServiceBus sample.
Where to get it
You can install NServiceBus.AzureFunctions.AzureServiceBus from NuGet.
With thanks,
The team in Particular
Please read our release policy for more details.