From 0a92ed8b194a295b6a792567d6d118bb50a62996 Mon Sep 17 00:00:00 2001 From: "aspire-repo-bot[bot]" <268009190+aspire-repo-bot[bot]@users.noreply.github.com> Date: Wed, 12 Aug 2026 02:29:03 +0000 Subject: [PATCH] docs: document AddPersistentVolume on AKS environments Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --- .../kubernetes/persistent-volumes.mdx | 5 +++ .../integrations/cloud/azure/aks/index.mdx | 43 +++++++++++++++++++ 2 files changed, 48 insertions(+) diff --git a/src/frontend/src/content/docs/deployment/kubernetes/persistent-volumes.mdx b/src/frontend/src/content/docs/deployment/kubernetes/persistent-volumes.mdx index fb1ef176b..129b2161d 100644 --- a/src/frontend/src/content/docs/deployment/kubernetes/persistent-volumes.mdx +++ b/src/frontend/src/content/docs/deployment/kubernetes/persistent-volumes.mdx @@ -234,10 +234,15 @@ spec: To generate and inspect the Helm chart for yourself, see [Deploy to Kubernetes clusters](/deployment/kubernetes/clusters/). +## Persistent volumes on AKS + +`AddPersistentVolume` is also available directly on an [Azure Kubernetes Service (AKS) environment](/integrations/cloud/azure/aks/#add-a-persistent-volume), so you don't need to reach through to the underlying Kubernetes environment when targeting AKS. The AKS overload forwards to the same publisher described on this page, and uses the same configuration and binding APIs. + ## See also - [Kubernetes integration](/integrations/compute/kubernetes/) - [Deploy to Kubernetes clusters](/deployment/kubernetes/clusters/) - [Deploy to AKS](/deployment/kubernetes/aks/) +- [Azure Kubernetes Service (AKS) integration](/integrations/cloud/azure/aks/) - [Persist data with volumes](/fundamentals/persist-data-volumes/) - [Kubernetes persistent volumes documentation](https://kubernetes.io/docs/concepts/storage/persistent-volumes/) diff --git a/src/frontend/src/content/docs/integrations/cloud/azure/aks/index.mdx b/src/frontend/src/content/docs/integrations/cloud/azure/aks/index.mdx index 84364cc9a..42863aa00 100644 --- a/src/frontend/src/content/docs/integrations/cloud/azure/aks/index.mdx +++ b/src/frontend/src/content/docs/integrations/cloud/azure/aks/index.mdx @@ -108,6 +108,48 @@ await worker.withNodePool(gpuPool); +## Add a persistent volume + + + +Call `AddPersistentVolume` directly on the AKS environment to model durable storage without reaching through to the underlying Kubernetes integration. The call forwards to the AKS environment's Kubernetes publisher, so the same configuration methods and workload-binding APIs described in [Persistent volumes on Kubernetes](/deployment/kubernetes/persistent-volumes/) apply: + + + +```csharp title="AppHost.cs" +var aks = builder.AddAzureKubernetesEnvironment("aks"); + +var data = aks.AddPersistentVolume("data") + .WithCapacity("20Gi"); + +builder.AddProject("api") + .WithPersistentVolume(data, "/data"); +``` + + +```typescript title="apphost.mts" +const aks = await builder.addAzureKubernetesEnvironment("aks"); + +const data = await aks.addPersistentVolume("data"); +await data.withCapacity("20Gi"); + +await api.withKubernetesPersistentVolumeMount(data, "/data"); +``` + + + +When you don't set a storage class, the generated claim omits `spec.storageClassName` so the cluster's default storage class provisions the disk. A standard AKS cluster dynamically provisions an Azure managed disk for such claims — to request Premium SSD storage explicitly, call `WithStorageClass("managed-csi-premium")` in C# or `withStorageClass('managed-csi-premium')` in TypeScript. + + + + + For the full set of configuration methods (storage class, capacity, access modes, annotations) and how to bind volumes to workloads, see [Persistent volumes on Kubernetes](/deployment/kubernetes/persistent-volumes/). + + ## Publishing and deployment The AKS integration supports both [`aspire publish`](/reference/cli/commands/aspire-publish/) (generate Helm chart and Bicep artifacts) and [`aspire deploy`](/reference/cli/commands/aspire-deploy/) (provision Azure infrastructure and deploy in a single command). @@ -119,6 +161,7 @@ For a complete end-to-end walkthrough, see [Deploy to AKS](/deployment/kubernete - [Deploy to AKS](/deployment/kubernetes/aks/) - [Deploy to Kubernetes](/deployment/kubernetes/) - [Kubernetes integration](/integrations/compute/kubernetes/) +- [Persistent volumes on Kubernetes](/deployment/kubernetes/persistent-volumes/) - [Azure Container Apps integration](/integrations/cloud/azure/configure-container-apps/) - [Deploy to Azure](/deployment/azure/) - [Azure compute integrations overview](/integrations/cloud/azure/overview/)