Skip to content

[docs] Document AddLoadBalancer, WithLoadBalancer, and WithForceConflicts for AKS Gateway API / AGC#945

Draft
aspire-repo-bot[bot] wants to merge 1 commit into
release/13.4from
docs/pr-16990-aks-gateway-agc-09bc1688b75753af
Draft

[docs] Document AddLoadBalancer, WithLoadBalancer, and WithForceConflicts for AKS Gateway API / AGC#945
aspire-repo-bot[bot] wants to merge 1 commit into
release/13.4from
docs/pr-16990-aks-gateway-agc-09bc1688b75753af

Conversation

@aspire-repo-bot
Copy link
Copy Markdown
Contributor

Documents changes from microsoft/aspire#16990 (@mitchdenny).

Targeting release/13.4 based on the source PR milestone 13.4 (exact match on microsoft/aspire.dev).

Why this PR is needed

PR microsoft/aspire#16990 wired up Azure Application Gateway for Containers (AGC) end-to-end in AddAzureKubernetesEnvironment, enabling a fully automatic ingress story on AKS in a single aspire deploy. Three new user-facing APIs were added that have no prior documentation:

  • AddLoadBalancer(name, subnet) — provisions an AGC ApplicationLoadBalancer, injects the AKS preview ingressProfile, and grants the AGC managed identity Network Contributor on the delegated subnet.
  • WithLoadBalancer(lb) — attaches a AddGateway or AddIngress resource to a specific AGC ALB by stamping the required alb.networking.azure.io annotations and defaulting gatewayClassName to azure-alb-external.
  • WithForceConflicts() — passes --force-conflicts to helm upgrade --install to resolve SSA field-manager conflicts that occur on AKS clusters with Azure Policy / Deployment Safeguards.

What was changed

Updated: src/frontend/src/content/docs/deployment/kubernetes/aks.mdx

Added two new sections to the existing AKS deployment page:

  1. "Expose services with Application Gateway for Containers (AGC)" — covers subscription feature registration, VNet/subnet layout, AddLoadBalancer, WithLoadBalancer, and TLS with cert-manager.
  2. "Resolve Helm SSA field-manager conflicts" — covers WithForceConflicts() and the Helm 4 requirement.

Also updated the "See also" section with links to the bring-your-own-cluster gateway/ingress guides and the AGC documentation.

Files modified

  • src/frontend/src/content/docs/deployment/kubernetes/aks.mdx (updated)

Generated by PR Documentation Check for issue #16990 · ● 22M ·

…cts for AKS Gateway API / AGC

Documents the new APIs introduced in microsoft/aspire#16990:
- AddLoadBalancer() on AzureKubernetesEnvironmentResource to provision AGC + Gateway API
- WithLoadBalancer() on gateways/ingresses to attach to an AGC ApplicationLoadBalancer
- WithForceConflicts() on Helm charts to resolve SSA field-manager conflicts

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@aspire-repo-bot aspire-repo-bot Bot added the docs-from-code Copilot initiated issue from dotnet/aspire repo label May 14, 2026
@aspire-repo-bot aspire-repo-bot Bot requested a review from IEvangelist May 14, 2026 00:23
@davidfowl davidfowl requested a review from mitchdenny May 14, 2026 02:40
@davidfowl
Copy link
Copy Markdown
Contributor

@mitchdenny this is yours

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

docs-from-code Copilot initiated issue from dotnet/aspire repo

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant