[docs] Require Helm v4.2.0+ for Kubernetes deployment#1097
[docs] Require Helm v4.2.0+ for Kubernetes deployment#1097aspire-repo-bot[bot] wants to merge 2 commits into
Conversation
Aspire now validates the Helm CLI version (>= 4.2.0) upfront before deploying to Kubernetes. Missing or older Helm versions produce a clear actionable error instead of cryptic flag failures like 'unknown flag: --force-conflicts'. Update Prerequisites in both Kubernetes and AKS deployment docs to reflect this minimum version requirement. Documents changes from microsoft/aspire#17542. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
aspire-repo-bot
Bot
added
the
docs-from-code
There was a problem hiding this comment.
Pull request overview
Updates Aspire’s Kubernetes deployment documentation to reflect the new minimum Helm CLI requirement introduced by the Kubernetes deployment pipeline validation.
Changes:
- Update Kubernetes deployment prerequisites to require Helm v4.2.0 or later
- Update AKS deployment prerequisites to require Helm v4.2.0 or later
Reviewed changes
Copilot reviewed 2 out of 2 changed files in this pull request and generated 1 comment.
| File | Description |
|---|---|
| src/frontend/src/content/docs/deployment/kubernetes/kubernetes.mdx | Updates the Helm prerequisite to v4.2.0+ for Kubernetes deployments. |
| src/frontend/src/content/docs/deployment/kubernetes/aks.mdx | Updates the Helm prerequisite to v4.2.0+ for AKS deployments. |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
IEvangelist
left a comment
IEvangelist
left a comment
There was a problem hiding this comment.
Docs accuracy review
Source of truth: microsoft/aspire@cc4b7eaf (release/13.4, fetched 2026-05-29)
PR head: 5dffc557cb4bc3c08e4b22898e66c67d8b027111
| Verdict | Count |
|---|---|
| verified | 1 |
| verified-with-nuance | 0 |
| unverifiable | 0 |
| contradicted | 0 |
Verdict: APPROVE. The added v4.2.0 or later constraint matches MinimumHelmVersion at release/13.4.
Doc-tester (UX) notes
Both prerequisite lists now match the version the runtime actually enforces; a user installing Helm from helm.sh/docs/intro/install/ will land on the right release. The phrasing is consistent across aks.mdx, kubernetes.mdx, and the version floor that HelmVersionValidator throws against.
Verified claims (with evidence)
| # | Claim | Evidence |
|---|---|---|
| 1 | Helm "v4.2.0 or later". | src/Aspire.Hosting.Kubernetes/Deployment/HelmVersionValidator.cs:28 — public static readonly Version MinimumHelmVersion = new(4, 2, 0);. Enforced at deploy time via HelmDeploymentEngine.cs:135-155 (check-helm-prereqs-{env} pipeline step) calling HelmVersionValidator.EnsureMinimumVersionAsync(...). |
- Update shared Kubernetes prerequisites with Helm v4.2.0+ requirement (PRRT_kwDOQK_VN86FKpia) Verified against microsoft/aspire@dfd226a on branch release/13.4. Edited per the doc-writer skill. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Documents changes from microsoft/aspire#17542 (
@aspire-repo-bot/ original author:@mitchdenny).Targeting
release/13.4based on the source PR milestone13.4.Why this PR is needed
Aspire's Kubernetes deployment pipeline shells out to
helm upgrade --installand now validates the Helm CLI version upfront before deploying. The minimum required version is Helm 4.2.0. Helm 3.x and older 4.x builds produce cryptic failures such asunknown flag: --force-conflictsorFlag --force has been deprecated; the new validation turns these into a single clear, actionable error that includes the detected version, the required version, and a link to the Helm install docs.This was documented in both the
Aspire.Hosting.KubernetesandAspire.Hosting.Azure.KubernetesREADMEs in the source PR — the docs site prerequisites sections need to match.Changes
Updated the Prerequisites section in both Kubernetes deployment pages to specify
Helm v4.2.0 or later:src/frontend/src/content/docs/deployment/kubernetes/kubernetes.mdx— Helm prerequisite updatedsrc/frontend/src/content/docs/deployment/kubernetes/aks.mdx— Helm prerequisite updated