Aspire.Hosting.Azure.Provisioning.ContainerService
13.6.1-preview.1.26506.6
Prefix Reserved
dotnet add package Aspire.Hosting.Azure.Provisioning.ContainerService --version 13.6.1-preview.1.26506.6
NuGet\Install-Package Aspire.Hosting.Azure.Provisioning.ContainerService -Version 13.6.1-preview.1.26506.6
<PackageReference Include="Aspire.Hosting.Azure.Provisioning.ContainerService" Version="13.6.1-preview.1.26506.6" />
<PackageVersion Include="Aspire.Hosting.Azure.Provisioning.ContainerService" Version="13.6.1-preview.1.26506.6" />
<PackageReference Include="Aspire.Hosting.Azure.Provisioning.ContainerService" />
paket add Aspire.Hosting.Azure.Provisioning.ContainerService --version 13.6.1-preview.1.26506.6
#r "nuget: Aspire.Hosting.Azure.Provisioning.ContainerService, 13.6.1-preview.1.26506.6"
#:package Aspire.Hosting.Azure.Provisioning.ContainerService@13.6.1-preview.1.26506.6
#addin nuget:?package=Aspire.Hosting.Azure.Provisioning.ContainerService&version=13.6.1-preview.1.26506.6&prerelease
#tool nuget:?package=Aspire.Hosting.Azure.Provisioning.ContainerService&version=13.6.1-preview.1.26506.6&prerelease
Azure Provisioning Kubernetes hosting integration
This package is experimental and emits ASPIREAZUREPROVISIONING001.
Use this integration to customize Azure Kubernetes Service (AKS) infrastructure from a polyglot Aspire AppHost. It references Aspire.Hosting.Azure.Kubernetes; the ContainerService suffix follows the underlying Azure.Provisioning.ContainerService SDK.
Getting started
Prerequisites
An Azure subscription when provisioning resources.
Add the integration
From your AppHost directory, add the Aspire.Hosting.Azure.Provisioning.ContainerService integration with the Aspire CLI:
aspire add Aspire.Hosting.Azure.Provisioning.ContainerService
Usage example
Then, in a TypeScript AppHost, customize the managed cluster created by Aspire:
import { createBuilder } from "./.aspire/modules/aspire.mjs";
const builder = await createBuilder();
const kubernetes = await builder.addAzureKubernetesEnvironment("aks");
await kubernetes.configureInfrastructure(async infrastructure => {
const cluster = await infrastructure.getContainerServiceManagedCluster();
const tags = await cluster.tags.get();
await tags.set("environment", "production");
});
Scope and limitations
ContainerServiceManagedCluster is the selected infrastructure root. Compatible models from that SDK assembly are also projected, not every member. Supported BicepValue<T> properties accept the corresponding language value or a shared Bicep expression. The overlay configures Azure infrastructure; it does not replace the hosting integration's Helm deployment or local run behavior.
CustomCATrustCertificates is explicitly excluded because BicepList<BinaryData> has no type-safe ATS element representation.
To customize supporting registry, network, DNS, and workspace resources, opt into Aspire.Hosting.Azure.Provisioning.ContainerRegistry, .Network, .PrivateDns, and .OperationalInsights as needed. Shared secret infrastructure uses .KeyVault. The Kubernetes hosting dependencies do not automatically opt into those SDK proxies.
Additional documentation
- Hosting integration
- Provisioning inventory and shared expressions
- https://aspire.dev/integrations/gallery/
- https://learn.microsoft.com/azure/aks/
- https://learn.microsoft.com/dotnet/azure/sdk/provisioning/
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.Kubernetes (>= 13.6.1-preview.1.26506.6)
- Aspire.Hosting.Azure.Provisioning (>= 13.6.1-preview.1.26506.6)
- AspNetCore.HealthChecks.Uris (>= 9.0.0)
- Azure.Core (>= 1.62.0)
- Azure.Identity (>= 1.21.0)
- Azure.Provisioning (>= 1.6.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.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.302)
- Microsoft.Extensions.Configuration.Abstractions (>= 10.0.12)
- Microsoft.Extensions.Configuration.Binder (>= 10.0.12)
- Microsoft.Extensions.Configuration.EnvironmentVariables (>= 10.0.12)
- Microsoft.Extensions.DependencyInjection.Abstractions (>= 10.0.12)
- Microsoft.Extensions.Diagnostics.HealthChecks (>= 8.0.31)
- Microsoft.Extensions.FileSystemGlobbing (>= 10.0.12)
- Microsoft.Extensions.Hosting (>= 10.0.12)
- Microsoft.Extensions.Hosting.Abstractions (>= 10.0.12)
- Microsoft.Extensions.Http (>= 10.0.12)
- Microsoft.Extensions.Logging (>= 10.0.12)
- Microsoft.Extensions.Logging.Abstractions (>= 10.0.12)
- Microsoft.Extensions.Options (>= 10.0.12)
- Microsoft.Extensions.Primitives (>= 10.0.12)
- ModelContextProtocol (>= 1.4.1)
- NCrontab.Signed (>= 3.4.0)
- 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.12)
- System.Text.Json (>= 10.0.12)
- YamlDotNet (>= 18.1.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.6.1-preview.1.26506.6 | 63 | 10/7/2026 |
| 13.6.0-preview.1.26479.8 | 73 | 9/29/2026 |