Add Azure Kubernetes Service (AKS) hosting support

.github/workflows/update-azure-vm-sizes.yml

@@ -0,0 +1,48 @@
+name: Update Azure VM Sizes
+
+on:
+  workflow_dispatch:
+  schedule:
+    - cron: '0 6 1 * *' # Monthly on the 1st at 06:00 UTC
+
+permissions:
+  contents: write
+  pull-requests: write
+
+jobs:
+  generate-and-pr:
+    runs-on: ubuntu-latest
+    if: ${{ github.repository_owner == 'microsoft' }}
+    steps:
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+
+      - name: Azure Login
+        uses: azure/login@a457da9ea143d694b1b9c7c869ebb04ebe844ef5 # v2.3.0
+        with:
+          creds: ${{ secrets.AZURE_CREDENTIALS }}
+
+      - name: Generate updated Azure VM size descriptors
+        working-directory: src/Aspire.Hosting.Azure.Kubernetes/tools
+        run: |
+          set -e
+          "$GITHUB_WORKSPACE/dotnet.sh" run GenVmSizes.cs
+
+      - name: Generate GitHub App Token
+        id: app-token
+        uses: actions/create-github-app-token@df432ceedc7162793a195dd1713ff69aefc7379e # v2.0.6
+        with:
+          app-id: ${{ secrets.ASPIRE_BOT_APP_ID }}
+          private-key: ${{ secrets.ASPIRE_BOT_PRIVATE_KEY }}
+
+      - name: Create or update pull request
+        uses: ./.github/actions/create-pull-request
+        with:
+          token: ${{ steps.app-token.outputs.token }}
+          branch: update-azure-vm-sizes
+          base: main
+          commit-message: "[Automated] Update Azure VM Sizes"
+          labels: |
+            area-integrations
+            area-engineering-systems
+          title: "[Automated] Update Azure VM Sizes"
+          body: "Auto-generated update of Azure VM size descriptors (AksNodeVmSizes.Generated.cs)."

Aspire.slnx

@@ -93,6 +93,7 @@
     <Project Path="src/Aspire.Hosting.Azure.EventHubs/Aspire.Hosting.Azure.EventHubs.csproj" />
     <Project Path="src/Aspire.Hosting.Azure.Functions/Aspire.Hosting.Azure.Functions.csproj" />
     <Project Path="src/Aspire.Hosting.Azure.KeyVault/Aspire.Hosting.Azure.KeyVault.csproj" />
+    <Project Path="src/Aspire.Hosting.Azure.Kubernetes/Aspire.Hosting.Azure.Kubernetes.csproj" />
     <Project Path="src/Aspire.Hosting.Azure.Kusto/Aspire.Hosting.Azure.Kusto.csproj" />
     <Project Path="src/Aspire.Hosting.Azure.Network/Aspire.Hosting.Azure.Network.csproj" />
     <Project Path="src/Aspire.Hosting.Azure.OperationalInsights/Aspire.Hosting.Azure.OperationalInsights.csproj" />
@@ -467,6 +468,7 @@
     <Project Path="tests/Aspire.Hosting.Analyzers.Tests/Aspire.Hosting.Analyzers.Tests.csproj" />
     <Project Path="tests/Aspire.Hosting.Foundry.Tests/Aspire.Hosting.Foundry.Tests.csproj" />
     <Project Path="tests/Aspire.Hosting.Azure.Kusto.Tests/Aspire.Hosting.Azure.Kusto.Tests.csproj" />
+    <Project Path="tests/Aspire.Hosting.Azure.Kubernetes.Tests/Aspire.Hosting.Azure.Kubernetes.Tests.csproj" />
     <Project Path="tests/Aspire.Hosting.Azure.Tests/Aspire.Hosting.Azure.Tests.csproj" />
     <Project Path="tests/Aspire.Hosting.Containers.Tests/Aspire.Hosting.Containers.Tests.csproj" />
     <Project Path="tests/Aspire.Hosting.DevTunnels.Tests/Aspire.Hosting.DevTunnels.Tests.csproj" />

Directory.Packages.props

@@ -44,6 +44,7 @@
     <PackageVersion Include="Azure.Provisioning.AppService" Version="1.3.1" />
     <PackageVersion Include="Azure.Provisioning.ApplicationInsights" Version="1.1.0" />
     <PackageVersion Include="Azure.Provisioning.ContainerRegistry" Version="1.1.0" />
+    <PackageVersion Include="Azure.Provisioning.ContainerService" Version="1.0.0-beta.3" />
     <PackageVersion Include="Azure.Provisioning.CognitiveServices" Version="1.2.0" />
     <PackageVersion Include="Azure.Provisioning.CosmosDB" Version="1.0.0" />
     <PackageVersion Include="Azure.Provisioning.EventHubs" Version="1.1.0" />

src/Aspire.Hosting.Azure.Kubernetes/AksNetworkProfile.cs

@@ -0,0 +1,30 @@
+// Licensed to the .NET Foundation under one or more agreements.
+// The .NET Foundation licenses this file to you under the MIT license.
+
+namespace Aspire.Hosting.Azure.Kubernetes;
+
+/// <summary>
+/// Network profile configuration for an AKS cluster.
+/// </summary>
+internal sealed class AksNetworkProfile
+{
+    /// <summary>
+    /// Gets or sets the network plugin. Defaults to "azure" for Azure CNI.
+    /// </summary>
+    public string NetworkPlugin { get; set; } = "azure";
+
+    /// <summary>
+    /// Gets or sets the network policy. Defaults to "calico".
+    /// </summary>
+    public string? NetworkPolicy { get; set; } = "calico";
+
+    /// <summary>
+    /// Gets or sets the service CIDR.
+    /// </summary>
+    public string ServiceCidr { get; set; } = "10.0.4.0/22";
+
+    /// <summary>
+    /// Gets or sets the DNS service IP address.
+    /// </summary>
+    public string DnsServiceIP { get; set; } = "10.0.4.10";
+}

src/Aspire.Hosting.Azure.Kubernetes/AksNodePoolConfig.cs

@@ -0,0 +1,35 @@
+// Licensed to the .NET Foundation under one or more agreements.
+// The .NET Foundation licenses this file to you under the MIT license.
+
+namespace Aspire.Hosting.Azure.Kubernetes;
+
+/// <summary>
+/// Configuration for an AKS node pool.
+/// </summary>
+/// <param name="Name">The name of the node pool.</param>
+/// <param name="VmSize">The VM size for nodes in the pool.</param>
+/// <param name="MinCount">The minimum number of nodes.</param>
+/// <param name="MaxCount">The maximum number of nodes.</param>
+/// <param name="Mode">The mode of the node pool.</param>
+public sealed record AksNodePoolConfig(
+    string Name,
+    string VmSize,
+    int MinCount,
+    int MaxCount,
+    AksNodePoolMode Mode);
+
+/// <summary>
+/// Specifies the mode of an AKS node pool.
+/// </summary>
+public enum AksNodePoolMode
+{
+    /// <summary>
+    /// System node pool for hosting system pods.
+    /// </summary>
+    System,
+
+    /// <summary>
+    /// User node pool for hosting application workloads.
+    /// </summary>
+    User
+}

src/Aspire.Hosting.Azure.Kubernetes/AksNodePoolResource.cs

@@ -0,0 +1,30 @@
+// Licensed to the .NET Foundation under one or more agreements.
+// The .NET Foundation licenses this file to you under the MIT license.
+
+using Aspire.Hosting.Kubernetes;
+
+namespace Aspire.Hosting.Azure.Kubernetes;
+
+/// <summary>
+/// Represents an AKS node pool with Azure-specific configuration such as VM size and autoscaling.
+/// Extends the base <see cref="KubernetesNodePoolResource"/> with provisioning configuration
+/// that is used to generate Azure Bicep for the AKS agent pool profile.
+/// </summary>
+/// <param name="name">The name of the node pool resource.</param>
+/// <param name="config">The Azure-specific node pool configuration.</param>
+/// <param name="parent">The parent AKS environment resource.</param>
+public class AksNodePoolResource(
+    string name,
+    AksNodePoolConfig config,
+    AzureKubernetesEnvironmentResource parent) : KubernetesNodePoolResource(name, parent.KubernetesEnvironment)
+{
+    /// <summary>
+    /// Gets the parent AKS environment resource.
+    /// </summary>
+    public AzureKubernetesEnvironmentResource AksParent { get; } = parent ?? throw new ArgumentNullException(nameof(parent));
+
+    /// <summary>
+    /// Gets the Azure-specific node pool configuration.
+    /// </summary>
+    public AksNodePoolConfig Config { get; } = config ?? throw new ArgumentNullException(nameof(config));
+}