Aspire.Hosting.Azure.Kubernetes
13.5.3-preview.1.26425.3
Prefix Reserved
dotnet add package Aspire.Hosting.Azure.Kubernetes --version 13.5.3-preview.1.26425.3
NuGet\Install-Package Aspire.Hosting.Azure.Kubernetes -Version 13.5.3-preview.1.26425.3
<PackageReference Include="Aspire.Hosting.Azure.Kubernetes" Version="13.5.3-preview.1.26425.3" />
<PackageVersion Include="Aspire.Hosting.Azure.Kubernetes" Version="13.5.3-preview.1.26425.3" />
<PackageReference Include="Aspire.Hosting.Azure.Kubernetes" />
paket add Aspire.Hosting.Azure.Kubernetes --version 13.5.3-preview.1.26425.3
#r "nuget: Aspire.Hosting.Azure.Kubernetes, 13.5.3-preview.1.26425.3"
#:package Aspire.Hosting.Azure.Kubernetes@13.5.3-preview.1.26425.3
#addin nuget:?package=Aspire.Hosting.Azure.Kubernetes&version=13.5.3-preview.1.26425.3&prerelease
#tool nuget:?package=Aspire.Hosting.Azure.Kubernetes&version=13.5.3-preview.1.26425.3&prerelease
Azure Kubernetes Service hosting integration
Use this integration to model, configure, and orchestrate an Azure Kubernetes Service (AKS) environment in an Aspire solution.
Getting started
Prerequisites
- An Azure subscription - create one for free
- Helm v4.2.0 or later on your
PATH.
Aspire shells out to helm upgrade --install to deploy the generated chart and any AddHelmChart(...) releases, and validates the Helm version up front so missing or older installs produce a clear actionable error instead of cryptic flag failures.
Add the integration
From your AppHost directory, add the Aspire.Hosting.Azure.Kubernetes integration with the Aspire CLI:
aspire add Aspire.Hosting.Azure.Kubernetes
Usage example
In the AppHost, add an AKS environment and deploy services to it:
C#
var aks = builder.AddAzureKubernetesEnvironment("aks");
var myService = builder.AddProject<Projects.MyService>()
.WithComputeEnvironment(aks);
TypeScript
const aks = await builder.addAzureKubernetesEnvironment("aks");
const myService = await builder.addNodeApp("myService", "../my-service", "server.js")
.withComputeEnvironment(aks);
Persistent volumes
Add a persistent volume to the AKS environment and mount it into a workload:
C#
var data = aks.AddPersistentVolume("data")
.WithCapacity("20Gi");
myService.WithPersistentVolume(data, "/data");
TypeScript
const data = await aks.addPersistentVolume("data");
await data.withCapacity("20Gi");
await myService.withKubernetesPersistentVolumeMount(data, "/data");
When no storage class is specified, the generated claim uses the cluster's default storage class. A standard AKS cluster dynamically provisions an Azure managed disk. To request Premium SSD storage explicitly, call WithStorageClass("managed-csi-premium") in C# or withStorageClass("managed-csi-premium") in TypeScript.
Additional documentation
- https://aspire.dev/integrations/gallery/
- https://aspire.dev/integrations/cloud/azure/aks/
- https://learn.microsoft.com/azure/aks/
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. |
-
net8.0
- Aspire.Hosting.Azure (>= 13.5.3)
- Aspire.Hosting.Azure.ContainerRegistry (>= 13.5.3)
- Aspire.Hosting.Azure.Network (>= 13.5.3)
- Aspire.Hosting.Azure.OperationalInsights (>= 13.5.3)
- Aspire.Hosting.Kubernetes (>= 13.5.3-preview.1.26425.3)
- AspNetCore.HealthChecks.Uris (>= 9.0.0)
- Azure.Core (>= 1.57.0)
- Azure.Identity (>= 1.21.0)
- Azure.Provisioning (>= 1.5.0)
- Azure.Provisioning.ContainerRegistry (>= 1.1.0)
- Azure.Provisioning.ContainerService (>= 1.0.0-beta.6)
- Azure.Provisioning.KeyVault (>= 1.1.0)
- Azure.Provisioning.Network (>= 1.1.0)
- Azure.Provisioning.OperationalInsights (>= 1.1.0)
- Azure.Provisioning.PrivateDns (>= 1.0.0)
- Azure.ResourceManager.Authorization (>= 1.1.6)
- Azure.ResourceManager.KeyVault (>= 1.4.0)
- Azure.ResourceManager.Resources (>= 1.11.2)
- Azure.Security.KeyVault.Secrets (>= 4.11.0)
- Google.Protobuf (>= 3.34.1)
- Grpc.AspNetCore (>= 2.80.0)
- Grpc.Net.ClientFactory (>= 2.80.0)
- Grpc.Tools (>= 2.80.0)
- Humanizer.Core (>= 3.0.10)
- JsonPatch.Net (>= 5.0.2)
- KubernetesClient (>= 19.0.2)
- Microsoft.Extensions.Configuration.Abstractions (>= 10.0.11)
- Microsoft.Extensions.Configuration.Binder (>= 10.0.11)
- Microsoft.Extensions.Configuration.EnvironmentVariables (>= 10.0.11)
- Microsoft.Extensions.DependencyInjection.Abstractions (>= 10.0.11)
- Microsoft.Extensions.Diagnostics.HealthChecks (>= 8.0.30)
- Microsoft.Extensions.FileSystemGlobbing (>= 10.0.11)
- Microsoft.Extensions.Hosting (>= 10.0.11)
- Microsoft.Extensions.Hosting.Abstractions (>= 10.0.11)
- Microsoft.Extensions.Http (>= 10.0.11)
- Microsoft.Extensions.Logging (>= 10.0.11)
- Microsoft.Extensions.Logging.Abstractions (>= 10.0.11)
- Microsoft.Extensions.Options (>= 10.0.11)
- Microsoft.Extensions.Primitives (>= 10.0.11)
- ModelContextProtocol (>= 1.3.0)
- NCrontab.Signed (>= 3.4.0)
- Newtonsoft.Json (>= 13.0.4)
- OpenTelemetry.Exporter.OpenTelemetryProtocol (>= 1.15.3)
- OpenTelemetry.Extensions.Hosting (>= 1.15.3)
- Polly.Core (>= 8.6.6)
- Semver (>= 3.0.0)
- StreamJsonRpc (>= 2.25.29)
- System.IO.Hashing (>= 10.0.8)
- System.Text.Json (>= 10.0.11)
- YamlDotNet (>= 16.3.0)
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 |
|---|---|---|
| 13.5.3-preview.1.26425.3 | 50 | 8/25/2026 |
| 13.5.2-preview.1.26421.6 | 164 | 8/21/2026 |
| 13.5.1-preview.1.26420.4 | 59 | 8/20/2026 |
| 13.5.0-preview.1.26417.10 | 59 | 8/18/2026 |
| 13.4.6-preview.1.26319.6 | 1,017 | 6/19/2026 |
| 13.4.5-preview.1.26316.12 | 116 | 6/17/2026 |
| 13.4.4-preview.1.26314.3 | 157 | 6/15/2026 |
| 13.4.3-preview.1.26305.13 | 86 | 6/8/2026 |
| 13.4.2-preview.1.26303.6 | 104 | 6/3/2026 |
| 13.4.1-preview.1.26303.3 | 75 | 6/3/2026 |
| 13.4.0-preview.1.26281.18 | 79 | 6/1/2026 |
| 13.3.5-preview.1.26270.6 | 131 | 5/21/2026 |
| 13.3.4-preview.1.26268.8 | 78 | 5/19/2026 |
| 13.3.3-preview.1.26264.13 | 82 | 5/15/2026 |
| 13.3.2-preview.1.26263.11 | 118 | 5/14/2026 |
| 13.3.1-preview.1.26261.7 | 93 | 5/12/2026 |
| 13.3.0-preview.1.26256.5 | 114 | 5/7/2026 |