Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/scale-tone/nservicebus-azure-functions-demo
Demonstrates how to build and host NServiceBus-based services with Azure Functions and Azure Service Bus
https://github.com/scale-tone/nservicebus-azure-functions-demo
azure-functions nservicebus serverless
Last synced: 15 days ago
JSON representation
Demonstrates how to build and host NServiceBus-based services with Azure Functions and Azure Service Bus
- Host: GitHub
- URL: https://github.com/scale-tone/nservicebus-azure-functions-demo
- Owner: scale-tone
- License: mit
- Created: 2023-03-19T05:35:22.000Z (almost 2 years ago)
- Default Branch: master
- Last Pushed: 2023-03-28T14:51:42.000Z (almost 2 years ago)
- Last Synced: 2024-10-31T05:11:47.036Z (2 months ago)
- Topics: azure-functions, nservicebus, serverless
- Language: C#
- Homepage:
- Size: 1.33 MB
- Stars: 1
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# NServiceBus + Azure Functions + Azure Service Bus Demo
Demonstrates how to build and host [NServiceBus](https://docs.particular.net/get-started/)-based services with Azure Functions and Azure Service Bus.
[Official NServiceBus quick start solution](https://docs.particular.net/tutorials/quickstart/) migrated to [Azure Functions](https://learn.microsoft.com/en-us/azure/azure-functions/functions-overview) with [Azure Service Bus](https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-messaging-overview) used as messaging transport.
```mermaid
graph LR
Browser[[Browser]] -.-> ClientUI
subgraph Azure Functions
ClientUI -- "#9889; PlaceOrder" --> Sales
Sales -- "#9889; OrderPlaced" --> Billing
Sales -- "#9889; OrderPlaced" --> Shipping
end
```
## How to run
As a prerequisite, you will need [Azure Functions Core Tools installed on your devbox](https://learn.microsoft.com/en-us/azure/azure-functions/functions-run-local#install-the-azure-functions-core-tools).
1. [Create an Azure Service Bus Namespace with Standard or Premium pricing tier](https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-quickstart-portal#create-a-namespace-in-the-azure-portal).
2. Install the [asb-transport](https://docs.particular.net/transports/azure-service-bus/operational-scripting) CLI tool.
3. Use that tool to pre-create required queues/topics:
```
set AzureServiceBus_ConnectionString=
asb-transport endpoint create ClientUI
asb-transport endpoint create Sales
asb-transport endpoint create Billing
asb-transport endpoint create Shipping
```
4. Create another queue named `Wholesale` [manually](https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-quickstart-portal#create-a-queue-in-the-azure-portal), with **message sessions enabled** on it:
5. Put your Azure Service Bus connection string into each project's `local.settings.json` file.
6. Start each Function project by running `func start` in its folder.
7. Navigate to `http://localhost:7071` with your browser.
The `ClientUI` project is an Azure Function, but it also serves static HTML files for the [client-side React-based UI app](https://github.com/scale-tone/nservicebus-azure-functions-demo/tree/master/ClientUI-React), so there is no need to host them anywhere else.
## Concepts demonstrated
1. How to [host NServiceBus endpoints as Azure Functions](https://docs.particular.net/nservicebus/hosting/azure-functions-service-bus/).
2. How to enable and use [cross-entity transactions](https://github.com/Azure/azure-sdk-for-net/blob/main/sdk/servicebus/Azure.Messaging.ServiceBus/samples/Sample06_Transactions.md).
[Sample code is here](https://github.com/scale-tone/nservicebus-azure-functions-demo/blob/master/Sales/TestTransactionsHandler.cs#L14).
To work correctly, it requires `EnableCrossEntityTransactions` [set to `true` in `host.json`](https://github.com/scale-tone/nservicebus-azure-functions-demo/blob/master/Sales/host.json#L6) and `SendsAtomicWithReceive` [set to `true` on `NServiceBusTriggerFunction` attribute](https://github.com/scale-tone/nservicebus-azure-functions-demo/blob/master/Sales/Startup.cs#L9).
3. How to enable and use [message sessions](https://learn.microsoft.com/en-us/azure/service-bus-messaging/message-sessions) (aka ordered delivery).
[Sample code is here](https://github.com/scale-tone/nservicebus-azure-functions-demo/blob/master/ClientUI/Functions.cs#L111). To work correctly it requires [message sessions be enabled](https://learn.microsoft.com/en-us/azure/service-bus-messaging/enable-message-sessions) on the destination queue.
Also check out [Jeff Hollan's very useful post about message sessions](https://dev.to/azure/ordered-queue-processing-in-azure-functions-4h6c).
Also check out [why you don't actually need it ;)](https://particular.net/blog/you-dont-need-ordered-delivery).
4. How to enable and use [message deduplication](https://learn.microsoft.com/en-us/azure/service-bus-messaging/duplicate-detection).
[Sample code is here](https://github.com/scale-tone/nservicebus-azure-functions-demo/blob/master/ClientUI/TestDeduplicationHandler.cs#L14). To work correctly it requires the destination queue (called `dedup`) to be created with `Enable duplicate detection` flag set:
