Aspire.Hosting.Azure.EventHubs
9.0.0
Prefix Reserved
dotnet add package Aspire.Hosting.Azure.EventHubs --version 9.0.0
NuGet\Install-Package Aspire.Hosting.Azure.EventHubs -Version 9.0.0
<PackageReference Include="Aspire.Hosting.Azure.EventHubs" Version="9.0.0" />
paket add Aspire.Hosting.Azure.EventHubs --version 9.0.0
#r "nuget: Aspire.Hosting.Azure.EventHubs, 9.0.0"
// Install Aspire.Hosting.Azure.EventHubs as a Cake Addin #addin nuget:?package=Aspire.Hosting.Azure.EventHubs&version=9.0.0 // Install Aspire.Hosting.Azure.EventHubs as a Cake Tool #tool nuget:?package=Aspire.Hosting.Azure.EventHubs&version=9.0.0
Aspire.Hosting.Azure.EventHubs library
Provides extension methods and resource definitions for a .NET Aspire AppHost to configure Azure Event Hubs.
Getting started
Prerequisites
- Azure subscription - create one for free
Install the package
Install the .NET Aspire Azure Event Hubs Hosting library with NuGet:
dotnet add package Aspire.Hosting.Azure.EventHubs
Configure Azure Provisioning for local development
Adding Azure resources to the .NET 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 Program.cs file of AppHost
, add an Event Hubs connection and consume the connection using the following methods:
var eventHubs = builder.AddAzureEventHubs("eh");
var myService = builder.AddProject<Projects.MyService>()
.WithReference(eventHubs);
The WithReference
method passes that connection information into a connection string named eh
in the MyService
project. In the Program.cs file of MyService
, the connection can be consumed using the client library Aspire.Azure.Messaging.EventHubs:
builder.AddAzureEventProcessorClient("eh");
Additional documentation
- https://github.com/Azure/azure-sdk-for-net/blob/main/sdk/eventhub/Microsoft.Azure.EventHubs/README.md
- https://github.com/dotnet/aspire/tree/main/src/Components/README.md
Feedback & contributing
Product | Versions Compatible and additional computed target framework versions. |
---|---|
.NET | net8.0 is compatible. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. |
-
net8.0
- Aspire.Hosting.Azure (>= 9.0.0)
- Aspire.Hosting.Azure.Storage (>= 9.0.0)
- AspNetCore.HealthChecks.Azure.Messaging.EventHubs (>= 8.0.1)
- AspNetCore.HealthChecks.Azure.Storage.Blobs (>= 8.0.1)
- AspNetCore.HealthChecks.Uris (>= 8.0.1)
- Azure.Core (>= 1.44.1)
- Azure.Identity (>= 1.13.1)
- Azure.Messaging.EventHubs (>= 5.11.5)
- Azure.Provisioning (>= 1.0.0)
- Azure.Provisioning.EventHubs (>= 1.0.0)
- Azure.Provisioning.KeyVault (>= 1.0.0)
- Azure.Provisioning.Storage (>= 1.0.0)
- Azure.ResourceManager.Authorization (>= 1.1.3)
- Azure.ResourceManager.KeyVault (>= 1.3.0)
- Azure.ResourceManager.Resources (>= 1.9.0)
- Azure.Security.KeyVault.Secrets (>= 4.7.0)
- Azure.Storage.Blobs (>= 12.22.2)
- Google.Protobuf (>= 3.28.2)
- Grpc.AspNetCore (>= 2.66.0)
- Grpc.Net.ClientFactory (>= 2.66.0)
- Grpc.Tools (>= 2.67.0)
- Humanizer.Core (>= 2.14.1)
- JsonPatch.Net (>= 3.1.1)
- KubernetesClient (>= 15.0.1)
- Microsoft.Extensions.Configuration.Abstractions (>= 8.0.0)
- Microsoft.Extensions.Configuration.Binder (>= 8.0.2)
- Microsoft.Extensions.DependencyInjection.Abstractions (>= 8.0.2)
- Microsoft.Extensions.Diagnostics.HealthChecks (>= 8.0.11)
- Microsoft.Extensions.Hosting (>= 8.0.1)
- Microsoft.Extensions.Hosting.Abstractions (>= 8.0.1)
- Microsoft.Extensions.Http (>= 8.0.1)
- Microsoft.Extensions.Logging.Abstractions (>= 8.0.2)
- Microsoft.Extensions.Options (>= 8.0.2)
- Microsoft.Extensions.Primitives (>= 8.0.0)
- Polly.Core (>= 8.4.2)
- System.IO.Hashing (>= 8.0.0)
- System.Text.Json (>= 8.0.5)
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.
Version | Downloads | Last updated |
---|---|---|
9.0.0 | 2,725 | 11/12/2024 |
9.0.0-rc.1.24511.1 | 274 | 10/15/2024 |
8.2.2 | 789 | 10/24/2024 |
8.2.1 | 744 | 9/26/2024 |
8.2.0 | 1,675 | 8/29/2024 |
8.1.0 | 512 | 7/23/2024 |
8.0.2 | 750 | 6/28/2024 |
8.0.1 | 425 | 5/21/2024 |
8.0.0 | 147 | 5/21/2024 |
8.0.0-preview.7.24251.11 | 93 | 5/7/2024 |
8.0.0-preview.6.24214.1 | 91 | 4/23/2024 |
8.0.0-preview.5.24201.12 | 100 | 4/9/2024 |