diff --git a/src/frontend/config/sidebar/deployment.topics.ts b/src/frontend/config/sidebar/deployment.topics.ts
index 04e14e1b7..27afe313b 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 (AKS)',
+ 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..0d4295922 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 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,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 (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
@@ -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/"
/>
+