Skip to content

Add AKS to Azure deployment docs #1249

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
davidfowl merged 2 commits into from
Jun 12, 2026
+12 −2
Merged

Add AKS to Azure deployment docs #1249

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
862a1f8
Add AKS to Azure deployment docs
davidfowl Jun 12, 2026
4a0cbdb
Include AKS acronym in Azure deployment docs
davidfowl Jun 12, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 4 additions & 0 deletions src/frontend/config/sidebar/deployment.topics.ts
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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',
Expand Down
10 changes: 8 additions & 2 deletions src/frontend/src/content/docs/deployment/azure/index.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -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.
---

Expand Down Expand Up @@ -105,7 +105,7 @@ Azure deployment starts from the compute environments in your AppHost. Each comp

</Steps>

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

Expand All @@ -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
Expand All @@ -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/"
/>
<LinkCard
title="Azure Kubernetes Service (AKS)"
description="Provision AKS clusters, container registries, ingress, identity, and observability with Aspire."
href="/deployment/kubernetes/aks/"
/>
<LinkCard
title="Azure App Service"
description="Understand the App Service website model, slots, dashboard, and Application Insights for deployment."
Expand Down
Loading