[docs] Add external Helm charts documentation (AddHelmChart)

[aspire-repo-bot]

Documents changes from microsoft/aspire#16589

Authored by @mitchdenny.

Targeting main because release/13.4 does not yet exist on microsoft/aspire.dev (the milestone 13.4 resolved to release/13.4, but that branch was not found in this repo).

Why this PR is needed

PR #16589 adds a significant new user-facing API — AddHelmChart — that lets AppHost authors install external Helm charts (cert-manager, NGINX ingress, monitoring tools, etc.) as post-deploy pipeline steps alongside the application's own generated Helm chart. This capability has no prior documentation on aspire.dev.

What was changed

New page

• src/frontend/src/content/docs/deployment/kubernetes/helm-charts.mdx — Full guide covering:
  • AddHelmChart(name, chartReference, chartVersion) for Kubernetes and AKS environments
  • WithHelmValue(key, value) for --set arguments
  • WithNamespace and WithReleaseName for overriding defaults
  • WithDestroy() opt-in uninstall on aspire destroy
  • Supported chart reference formats (OCI, HTTP, local path, .tgz, repo/chart)
  • Complete example and see-also links

Updated pages

• src/frontend/src/content/docs/deployment/kubernetes/kubernetes.mdx — Added "Install external Helm charts" section with cross-reference
• src/frontend/src/content/docs/deployment/kubernetes/aks.mdx — Added "Install external Helm charts" section with cross-reference
• src/frontend/src/content/docs/deployment/kubernetes/index.mdx — Added LinkCard for new page
• src/frontend/config/sidebar/deployment.topics.ts — Added "External Helm charts" sidebar entry under Kubernetes

Generated by PR Documentation Check for issue #16589 · ● 19.1M · ◷

[IEvangelist]

CI has been rerun multiple times for this PR and continues to fail (ci-gate). This looks more like a PR-specific issue than a flaky run, so the changes likely need to be updated before CI will pass consistently.

[IEvangelist]

⚠️ CI has failed multiple times on this PR. The failures appear to be related to content changes in this PR rather than transient infrastructure issues. Please review the CI logs and fix the underlying issue before this can be merged.

[IEvangelist]

👋 This PR's CI has been failing consistently across multiple runs (4 attempts since May 11). The frontend-build job keeps failing/being cancelled, which causes the ci-gate check to fail.

The failure pattern suggests the issue may be related to changes in this PR itself (specifically frontend/docs changes that cause the build to fail). Could someone please investigate and fix the underlying issue?

Runs:

• Run 25649212324: failure
• Run 25669936593: failure
• Run 25683695200: failure
• Run 25707101574: cancelled/failure

I've retriggered the last run — if it fails again, the PR content likely needs to be updated.

[IEvangelist]

Some CI checks have been retriggered multiple times and are still failing. This may be due to changes in this PR and may need to be fixed manually.

[Copilot]

Pull request overview

Adds end-user documentation for the new AddHelmChart API so Aspire AppHost authors can install external Helm charts (e.g., cert-manager) as post-deploy steps alongside the app’s generated Helm chart.

Changes:

• Adds a new “Install external Helm charts” guide under Kubernetes deployment docs.
• Cross-links the new guide from the Kubernetes and AKS deployment pages and the Kubernetes landing page.
• Adds a Kubernetes sidebar entry for the new page.

Reviewed changes

Copilot reviewed 5 out of 5 changed files in this pull request and generated 11 comments.

Show a summary per file

File	Description
src/frontend/src/content/docs/deployment/kubernetes/helm-charts.mdx	New end-to-end guide for installing/configuring external Helm charts with Aspire Kubernetes/AKS environments.
src/frontend/src/content/docs/deployment/kubernetes/kubernetes.mdx	Adds a section linking to the new external Helm charts guide.
src/frontend/src/content/docs/deployment/kubernetes/aks.mdx	Adds a section linking to the new external Helm charts guide.
src/frontend/src/content/docs/deployment/kubernetes/index.mdx	Adds a LinkCard entry to surface the new guide on the Kubernetes landing page.
src/frontend/config/sidebar/deployment.topics.ts	Adds a sidebar entry for the new guide under Kubernetes.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.