Skip to content

Rewrite Kubernetes docs for Aspire 13.3#734

Merged
mitchdenny merged 1 commit intorelease/13.3from
kubernetes-docs-rewrite
Apr 23, 2026
Merged

Rewrite Kubernetes docs for Aspire 13.3#734
mitchdenny merged 1 commit intorelease/13.3from
kubernetes-docs-rewrite

Conversation

@mitchdenny
Copy link
Copy Markdown
Member

@mitchdenny mitchdenny commented Apr 21, 2026

Summary

Comprehensive rewrite of Kubernetes documentation for the 13.3 release, covering the new \�spire deploy\ support for vanilla Kubernetes and the new \Aspire.Hosting.Azure.Kubernetes\ (AKS) integration.

New pages (3)

  • *\deployment/kubernetes/index.mdx* — K8s deployment overview with shared prereqs, resource mapping table, publish vs deploy comparison
  • *\deployment/kubernetes/kubernetes.mdx* — Vanilla K8s walkthrough: container registry config, \�spire publish\ + \�spire deploy, Helm settings, node pools, troubleshooting
  • *\deployment/kubernetes/aks.mdx* — AKS walkthrough: \AddAzureKubernetesEnvironment, node pools with scheduling, full provisioning + deploy

New integration page (1)

  • *\integrations/cloud/azure/aks/index.mdx* — \Aspire.Hosting.Azure.Kubernetes\ package APIs

Updated pages (1)

  • *\integrations/compute/kubernetes.mdx* — Added TypeScript tabs, container registry API, deploy support, \WithHelm\ config

Supporting changes

  • Sidebar: expanded Kubernetes into folder with Overview, Kubernetes clusters, AKS sub-pages
  • Deployment overview: added capabilities table with K8s Deploy and AKS rows
  • Deployment index: updated K8s card description
  • \integration-docs.json: added AKS mapping
  • \integrations.topics.ts: added AKS to Azure sidebar

Validated

  • All APIs verified against \microsoft/aspire\ source (\WithHelm, \WithSystemNodePool, \AddNodePool, \WithNodePool, \PublishAsKubernetesService)
  • End-to-end tested: vanilla K8s deploy to Docker Desktop + AKS deploy to Azure (midenn subscription)
  • All C# and TypeScript examples use idiomatic patterns (C# starter template / Express+React template)
  • Playwright-tested all 5 pages: links, tabs, sidebar, content rendering

@mitchdenny
Rewrite Kubernetes docs for Aspire 13.3
964eb40 
- Add deployment/kubernetes/ folder with overview, vanilla K8s, and AKS pages
- Add aspire deploy support for vanilla Kubernetes (helm install via kubectl context)
- Add Aspire.Hosting.Azure.Kubernetes (AKS) deployment docs with full provisioning
- Add container registry configuration (AddContainerRegistry + WithContainerRegistry)
- Add AKS integration page (integrations/cloud/azure/aks/)
- Update K8s integration page with TypeScript tabs and deploy support
- Update sidebar, deployment overview table, deployment index cards
- Add integration-docs.json mapping for Aspire.Hosting.Azure.Kubernetes
- All code examples include both C# and TypeScript tabs

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@mitchdenny mitchdenny force-pushed the kubernetes-docs-rewrite branch from 71fed6d to 964eb40 Compare April 23, 2026 02:23
@mitchdenny mitchdenny merged commit 9b7c89d into release/13.3 Apr 23, 2026
1 check passed
@mitchdenny mitchdenny deleted the kubernetes-docs-rewrite branch April 23, 2026 02:45
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@IEvangelist IEvangelist Awaiting requested review from IEvangelist IEvangelist is a code owner

@eerhardt eerhardt Awaiting requested review from eerhardt eerhardt is a code owner

@davidfowl davidfowl Awaiting requested review from davidfowl davidfowl is a code owner

@maddymontaquila maddymontaquila Awaiting requested review from maddymontaquila maddymontaquila is a code owner

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

1 participant

@mitchdenny