Aspire.Hosting.Azure.ServiceBus library

Provides extension methods and resource definitions for an Aspire AppHost to configure Azure Service Bus.

Getting started

Prerequisites

• Azure subscription - create one for free

Install the package

Install the Aspire Azure Service Bus Hosting library with NuGet:

dotnet add package Aspire.Hosting.Azure.ServiceBus

Configure Azure Provisioning for local development

Adding Azure resources to the Aspire application model will automatically enable development-time provisioning for Azure resources so that you don't need to configure them manually. Provisioning requires a number of settings to be available via .NET configuration. Set these values in user secrets in order to allow resources to be configured automatically.

{ "Azure": { "SubscriptionId": "<your subscription id>", "ResourceGroupPrefix": "<prefix for the resource group>", "Location": "<azure location>" } }

NOTE: Developers must have Owner access to the target subscription so that role assignments can be configured for the provisioned resources.

Usage example

In the AppHost.cs file of AppHost, add a Service Bus connection and consume the connection using the following methods:

var serviceBus = builder.AddAzureServiceBus("sb"); var myService = builder.AddProject<Projects.MyService>() .WithReference(serviceBus);

The WithReference method passes that connection information into a connection string named sb in the MyService project. In the Program.cs file of MyService, the connection can be consumed using the client library Aspire.Azure.Messaging.ServiceBus:

builder.AddAzureServiceBusClient("sb");