docs(blog): add internal load balancer example for approuting-istio Gateway API#5751
Open
rkasture wants to merge 6 commits into
Open
docs(blog): add internal load balancer example for approuting-istio Gateway API#5751rkasture wants to merge 6 commits into
rkasture wants to merge 6 commits into
Conversation
…ateway API Add a new 'Internal load balancer' section to the app routing Gateway API blog post showing how to configure an internal (private) Gateway using spec.infrastructure.annotations with Azure load balancer annotations. Includes: - Complete Gateway YAML with internal LB and subnet annotations - Commands to verify the internal IP assignment - Links to networking prerequisites and annotation reference docs Closes Azure#5748 Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Contributor
There was a problem hiding this comment.
Pull request overview
Adds documentation to the existing app routing Gateway API blog post to help readers configure an internal (private) Azure Load Balancer for an approuting-istio Gateway by using spec.infrastructure.annotations.
Changes:
- Adds an Internal load balancer subsection with a Gateway YAML example that sets internal LB annotations.
- Adds verification commands to confirm the Gateway is programmed and returns a private IP in
status.addresses. - Adds links to AKS internal load balancer prerequisites and the Azure Load Balancer annotations reference.
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Author
|
@copilot apply changes based on the comments in this thread |
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Author
|
@KenKilty Can you please review this PR? |
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
jaiveerk
reviewed
Jun 30, 2026
| gatewayClassName: approuting-istio | ||
| infrastructure: | ||
| annotations: | ||
| service.beta.kubernetes.io/azure-load-balancer-internal: "true" |
Contributor
There was a problem hiding this comment.
this isn't exactlyyyy best practice, as it results in the annotations being propagated to ALL resources provisioned for the gateway, including the deployment, hpa, etc..
However, I'm realizing that this is also the approach advised by our documentation, so I'm fine with it. May just be worth adding a disclaimer though, and that if users want to apply the annotation ONLY to the LB, they can use the approach described here: https://learn.microsoft.com/en-us/azure/aks/istio-gateway-api#configmap-customizations
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Adds a new Internal load balancer section to the app routing Gateway API blog post showing how to configure a private (internal) Gateway using \spec.infrastructure.annotations.
What's included
Motivation
Closes #5748 — users migrating from NGINX app routing to \�pprouting-istio\ need documented examples for creating internal load balancers on dedicated subnets. The existing blog post only shows the external (public) Gateway pattern.
Validation
pm run build\ succeeds (broken anchors in output are pre-existing, unrelated to this change)