From 862a1f849b3b13aa43dd868e72f926020ef9cd76 Mon Sep 17 00:00:00 2001 From: David Fowler Date: Fri, 12 Jun 2026 00:01:53 -0700 Subject: [PATCH 1/2] Add AKS to Azure deployment docs Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --- src/frontend/config/sidebar/deployment.topics.ts | 4 ++++ .../src/content/docs/deployment/azure/index.mdx | 10 ++++++++-- 2 files changed, 12 insertions(+), 2 deletions(-) diff --git a/src/frontend/config/sidebar/deployment.topics.ts b/src/frontend/config/sidebar/deployment.topics.ts index 04e14e1b7..fbd8ed126 100644 --- a/src/frontend/config/sidebar/deployment.topics.ts +++ b/src/frontend/config/sidebar/deployment.topics.ts @@ -180,6 +180,10 @@ export const deploymentTopics: StarlightSidebarTopicsUserConfig = { label: 'Azure Container Apps', slug: 'deployment/azure/container-apps', }, + { + label: 'Azure Kubernetes Service', + slug: 'deployment/kubernetes/aks', + }, { label: 'Azure App Service', slug: 'deployment/azure/app-service', diff --git a/src/frontend/src/content/docs/deployment/azure/index.mdx b/src/frontend/src/content/docs/deployment/azure/index.mdx index 0182a367b..b4a43bb1a 100644 --- a/src/frontend/src/content/docs/deployment/azure/index.mdx +++ b/src/frontend/src/content/docs/deployment/azure/index.mdx @@ -1,6 +1,6 @@ --- title: Deploy to Azure -seoTitle: Deploy Aspire apps to Azure with the Azure Developer CLI +seoTitle: Deploy Aspire apps to Azure targets with aspire deploy description: Learn how Azure deployment works in Aspire, the shared prerequisites, and how to choose between Azure App Service, Container Apps, and AKS for production workloads. --- @@ -105,7 +105,7 @@ Azure deployment starts from the compute environments in your AppHost. Each comp -Both Azure Container Apps and Azure App Service provision or attach an Azure Container Registry by default. Aspire uses the active deployment credential to log the local container runtime in for image push, and the deployed resources later pull those images with managed identity and `AcrPull` permissions instead of stored registry usernames or passwords. +Azure Container Apps, Azure App Service, and AKS provision or attach an Azure Container Registry by default. Aspire uses the active deployment credential to log the local container runtime in for image push, and the deployed resources later pull those images with managed identity and `AcrPull` permissions instead of stored registry usernames or passwords. ## Resource naming @@ -122,6 +122,7 @@ For ACA naming details, see [Configure Azure Container Apps environments](/integ | Target | Endpoint model | Best fit | | --- | --- | --- | | [Azure Container Apps](/deployment/azure/container-apps/) | Public or internal endpoints, with one primary HTTP ingress per app. | Distributed apps and containerized services that fit the Container Apps environment model. | +| [Azure Kubernetes Service](/deployment/kubernetes/aks/) | Internal Kubernetes services by default, with public ingress or Gateway API when configured. | Teams that need Kubernetes control, cluster-level add-ons, node pools, and Azure-managed cluster provisioning. | | [Azure App Service](/deployment/azure/app-service/) | Public website model with external `http`/`https` endpoints only. | Web apps and APIs that fit the App Service website and deployment slot model and use managed services for backing infrastructure such as databases and caches. | :::note @@ -136,6 +137,11 @@ Azure Container Apps can also host supporting service containers such as databas description="Understand ingress, registry, identity, and optional dashboard settings for Container Apps deployments." href="/deployment/azure/container-apps/" /> + Date: Fri, 12 Jun 2026 00:50:53 -0700 Subject: [PATCH 2/2] Include AKS acronym in Azure deployment docs Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --- src/frontend/config/sidebar/deployment.topics.ts | 2 +- src/frontend/src/content/docs/deployment/azure/index.mdx | 6 +++--- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/src/frontend/config/sidebar/deployment.topics.ts b/src/frontend/config/sidebar/deployment.topics.ts index fbd8ed126..27afe313b 100644 --- a/src/frontend/config/sidebar/deployment.topics.ts +++ b/src/frontend/config/sidebar/deployment.topics.ts @@ -181,7 +181,7 @@ export const deploymentTopics: StarlightSidebarTopicsUserConfig = { slug: 'deployment/azure/container-apps', }, { - label: 'Azure Kubernetes Service', + label: 'Azure Kubernetes Service (AKS)', slug: 'deployment/kubernetes/aks', }, { diff --git a/src/frontend/src/content/docs/deployment/azure/index.mdx b/src/frontend/src/content/docs/deployment/azure/index.mdx index b4a43bb1a..0d4295922 100644 --- a/src/frontend/src/content/docs/deployment/azure/index.mdx +++ b/src/frontend/src/content/docs/deployment/azure/index.mdx @@ -105,7 +105,7 @@ Azure deployment starts from the compute environments in your AppHost. Each comp -Azure Container Apps, Azure App Service, and AKS provision or attach an Azure Container Registry by default. Aspire uses the active deployment credential to log the local container runtime in for image push, and the deployed resources later pull those images with managed identity and `AcrPull` permissions instead of stored registry usernames or passwords. +Azure Container Apps, Azure App Service, and Azure Kubernetes Service (AKS) provision or attach an Azure Container Registry by default. Aspire uses the active deployment credential to log the local container runtime in for image push, and the deployed resources later pull those images with managed identity and `AcrPull` permissions instead of stored registry usernames or passwords. ## Resource naming @@ -122,7 +122,7 @@ For ACA naming details, see [Configure Azure Container Apps environments](/integ | Target | Endpoint model | Best fit | | --- | --- | --- | | [Azure Container Apps](/deployment/azure/container-apps/) | Public or internal endpoints, with one primary HTTP ingress per app. | Distributed apps and containerized services that fit the Container Apps environment model. | -| [Azure Kubernetes Service](/deployment/kubernetes/aks/) | Internal Kubernetes services by default, with public ingress or Gateway API when configured. | Teams that need Kubernetes control, cluster-level add-ons, node pools, and Azure-managed cluster provisioning. | +| [Azure Kubernetes Service (AKS)](/deployment/kubernetes/aks/) | Internal Kubernetes services by default, with public ingress or Gateway API when configured. | Teams that need Kubernetes control, cluster-level add-ons, node pools, and Azure-managed cluster provisioning. | | [Azure App Service](/deployment/azure/app-service/) | Public website model with external `http`/`https` endpoints only. | Web apps and APIs that fit the App Service website and deployment slot model and use managed services for backing infrastructure such as databases and caches. | :::note @@ -138,7 +138,7 @@ Azure Container Apps can also host supporting service containers such as databas href="/deployment/azure/container-apps/" />