Aspire.Hosting.Azure
13.6.5
Prefix Reserved
dotnet add package Aspire.Hosting.Azure --version 13.6.5
NuGet\Install-Package Aspire.Hosting.Azure -Version 13.6.5
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="Aspire.Hosting.Azure" Version="13.6.5" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="Aspire.Hosting.Azure" Version="13.6.5" />
<PackageReference Include="Aspire.Hosting.Azure" />
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add Aspire.Hosting.Azure --version 13.6.5
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
#r "nuget: Aspire.Hosting.Azure, 13.6.5"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package Aspire.Hosting.Azure@13.6.5
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=Aspire.Hosting.Azure&version=13.6.5
#tool nuget:?package=Aspire.Hosting.Azure&version=13.6.5
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
Azure provisioning integration
Provides core extensions to the Aspire hosting model for Azure services.
Getting started
Prerequisites
- Azure subscription - create one for free
Add the integration
From your AppHost directory, add the Aspire.Hosting.Azure integration with the Aspire CLI:
aspire add Aspire.Hosting.Azure
Configure Azure Provisioning for local development
Adding Azure resources to the AppHost 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 AppHost configuration. From your AppHost directory, set these values with aspire secret set:
aspire secret set Azure:SubscriptionId "<your subscription id>"
aspire secret set Azure:ResourceGroupPrefix "<prefix for the resource group>"
aspire secret set Azure: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, add a resource based on a Bicep template:
C#
var bicepResource = builder.AddBicepTemplate("bicep", "template.bicep")
.WithParameter("parametername", "parametervalue");
TypeScript
const bicepResource = await builder.addBicepTemplate("bicep", "template.bicep")
.withParameter("parametername", "parametervalue");
Additional documentation
- https://aspire.dev/integrations/gallery/
- https://aspire.dev/integrations/cloud/azure/overview/
- https://learn.microsoft.com/azure/azure-resource-manager/bicep/overview
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. net9.0 was computed. net9.0-android was computed. net9.0-browser was computed. net9.0-ios was computed. net9.0-maccatalyst was computed. net9.0-macos was computed. net9.0-tvos was computed. net9.0-windows was computed. net10.0 was computed. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed. |
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.
-
net8.0
- Aspire.Hosting (>= 13.6.5)
- AspNetCore.HealthChecks.Uris (>= 9.0.0)
- Azure.Core (>= 1.62.0)
- Azure.Identity (>= 1.21.0)
- Azure.Provisioning (>= 1.6.0)
- Azure.Provisioning.KeyVault (>= 1.1.0)
- Azure.ResourceManager.Authorization (>= 1.1.7)
- Azure.ResourceManager.KeyVault (>= 1.4.0)
- Azure.ResourceManager.Resources.Deployments (>= 1.0.0)
- Azure.Security.KeyVault.Secrets (>= 4.11.1)
- Google.Protobuf (>= 3.36.1)
- Grpc.AspNetCore (>= 2.83.0)
- Grpc.Net.ClientFactory (>= 2.83.0)
- Grpc.Tools (>= 2.83.0)
- Hex1b (>= 0.168.0)
- KubernetesClient (>= 19.0.2)
- MessagePack (>= 2.5.307)
- Microsoft.Extensions.Configuration.Abstractions (>= 10.0.14)
- Microsoft.Extensions.Configuration.Binder (>= 10.0.14)
- Microsoft.Extensions.Configuration.EnvironmentVariables (>= 10.0.14)
- Microsoft.Extensions.DependencyInjection.Abstractions (>= 10.0.14)
- Microsoft.Extensions.Diagnostics.HealthChecks (>= 8.0.33)
- Microsoft.Extensions.FileSystemGlobbing (>= 10.0.14)
- Microsoft.Extensions.Hosting (>= 10.0.14)
- Microsoft.Extensions.Hosting.Abstractions (>= 10.0.14)
- Microsoft.Extensions.Http (>= 10.0.14)
- Microsoft.Extensions.Logging (>= 10.0.14)
- Microsoft.Extensions.Logging.Abstractions (>= 10.0.14)
- Microsoft.Extensions.Options (>= 10.0.14)
- Microsoft.Extensions.Primitives (>= 10.0.14)
- ModelContextProtocol (>= 1.4.1)
- Newtonsoft.Json (>= 13.0.4)
- OpenTelemetry.Exporter.OpenTelemetryProtocol (>= 1.17.0)
- OpenTelemetry.Extensions.Hosting (>= 1.17.0)
- Polly.Core (>= 8.7.0)
- Semver (>= 3.0.0)
- StreamJsonRpc (>= 2.25.29)
- System.IO.Hashing (>= 10.0.14)
- System.Text.Json (>= 10.0.14)
- YamlDotNet (>= 18.1.0)
NuGet packages (45)
Showing the top 5 NuGet packages that depend on Aspire.Hosting.Azure:
| Package | Downloads |
|---|---|
|
Aspire.Hosting.Azure.Storage
Azure Storage resource types for Aspire. |
|
|
Aspire.Hosting.Azure.KeyVault
Azure resource types for Aspire. |
|
|
Aspire.Hosting.Azure.ServiceBus
Azure Service Bus resource types for Aspire. |
|
|
Aspire.Hosting.Azure.Functions
Azure Functions resource types for Aspire. |
|
|
Aspire.Hosting.Azure.OperationalInsights
Azure Log Analytics resource types for Aspire. |
GitHub repositories (8)
Showing the top 8 popular GitHub repositories that depend on Aspire.Hosting.Azure:
| Repository | Stars |
|---|---|
|
microsoft/aspire-samples
Browse the sample apps demonstrating Aspire integration across C#, JavaScript, TypeScript, Python, Go, containers, databases, cloud, AI, and observability scenarios.
|
|
|
mehdihadeli/food-delivery-microservices
🍔 A practical and cloud-native food delivery microservices, built with .Net Aspire, .Net 10, Wolverine, Domain-Driven Design, CQRS, Vertical Slice Architecture, Event-Driven Architecture, and the latest technologies.
|
|
|
ProfessionalCSharp/ProfessionalCSharp2021
Source code for Professional C# and .NET 2021 Edition (with updates for C# 11 and .NET 7)
|
|
|
Azure-Samples/eShopOnAzure
A variant of https://github.com/dotnet/eShop that uses Azure services
|
|
|
Azure-Samples/eShopLite
eShopLite is a set of reference .NET applications implementing an eCommerce site with features like Semantic Search, MCP, Reasoning models and more.
|
|
|
Keboo/DotnetTemplates
A repository for my dotnet templates
|
|
|
koralium/flowtide
High-performance streaming SQL query engine designed for real-time data processing. Use cases include event-driven architectures, ETL pipelines, and modern data-intensive applications.
|
|
|
PacktPublishing/Pragmatic-Microservices-with-CSharp-and-Azure
Pragmatic Microservices with C# and Azure, published by Packt
|
| Version | Downloads | Last Updated |
|---|---|---|
| 13.6.5 | 26,059 | 2026/11/10 |
| 13.6.4 | 304,808 | 2026/10/24 |
| 13.6.3 | 70,306 | 2026/10/21 |
| 13.6.2 | 39,411 | 2026/10/20 |
| 13.6.1 | 421,566 | 2026/10/7 |
| 13.6.0 | 277,078 | 2026/9/29 |
| 13.5.4 | 393,056 | 2026/9/15 |
| 13.5.3 | 607,631 | 2026/8/25 |
| 13.5.2 | 142,019 | 2026/8/21 |
| 13.5.1 | 32,852 | 2026/8/20 |
| 13.5.0 | 70,842 | 2026/8/18 |
| 13.4.6 | 1,491,539 | 2026/6/19 |
| 13.4.5 | 195,758 | 2026/6/17 |
| 13.4.4 | 112,986 | 2026/6/15 |
| 13.4.3 | 211,168 | 2026/6/8 |
| 13.4.2 | 178,335 | 2026/6/3 |
| 13.4.1 | 2,593 | 2026/6/3 |
| 13.4.0 | 86,580 | 2026/6/1 |
| 13.3.5 | 323,261 | 2026/5/21 |
| 13.3.4 | 82,365 | 2026/5/19 |
Loading failed