Skip to content

[OSDOCS-84105]: Adding details to load balancer docs for HCP on OpenShift Virt - #119606

Merged
lahinson merged 1 commit into
openshift:mainfrom
lahinson:ocpbugs-84105-hcp-virt-loadbalancer
Sep 10, 2026
Merged

lahinson merged 1 commit into
openshift:mainfrom
lahinson:ocpbugs-84105-hcp-virt-loadbalancer

Conversation

@lahinson

@lahinson lahinson commented Sep 9, 2026

Copy link
Copy Markdown
Contributor

@palonsoro palonsoro left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for opening the PR.

Here go some change requests.

Comment thread modules/hcp-virt-load-balancer.adoc Outdated
[role="_abstract"]
Set up the load balancer service that routes ingress traffic to the KubeVirt VMs and assigns a wildcard DNS entry to the load balancer IP address.

When you create a `LoadBalancer` service on an {VirtProductName} hosted cluster, the service is made available through the management cluster by using the same technology that the management cluster has configured for `LoadBalancer` services, such as MetalLB.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

While strictly speaking this is true, it can lead to misunderstanding. Literally reading it gives the impression that hosted cluster just "copies" or "reuses" management cluster's load balancer technology, which is wrong.

What actually happens in detail is:

  • A load balancer service is created in the hosted cluster, let's name it an "inner load balancer service", which gets exposed on the hosted cluster VMs via some node ports.
  • The cloud provider and the hypershift-operator work together to create a "mirror" or "outer" load balancer service on the management cluster that exposes the node ports of the hosted cluster's "inner" load balancer service through whatever technology the management cluster uses for load balancer services.

The explanation above is likely too long to be just included in the docs as is. However, maybe we should go with something similar to:

Suggested change
When you create a `LoadBalancer` service on an {VirtProductName} hosted cluster, the service is made available through the management cluster by using the same technology that the management cluster has configured for `LoadBalancer` services, such as MetalLB.
When you create a `LoadBalancer` service on an {VirtProductName} hosted cluster, a mirror `LoadBalancer` service is automatically created and configured on the management cluster to expose it. Because of this, the hosted cluster `LoadBalancer` services end up exposed through the same technology that the management cluster has configured for its own `LoadBalancer` services, such as MetalLB.

Of course, your writing will be much better than mine.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@palonsoro Thanks for the clarification! I updated the wording to include the details that you mentioned.

@lahinson
lahinson force-pushed the ocpbugs-84105-hcp-virt-loadbalancer branch from 31c8a4e to 761e5e9 Compare September 9, 2026 15:00
@openshift-ci

openshift-ci Bot commented Sep 9, 2026

Copy link
Copy Markdown

@lahinson: all tests passed!

Full PR test history. Your PR dashboard.

Details

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes-sigs/prow repository. I understand the commands that are listed here.

@palonsoro palonsoro left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It looks perfect, thanks!

@palonsoro

Copy link
Copy Markdown
Contributor

/lgtm

@openshift-ci openshift-ci Bot added the lgtm Indicates that a PR is ready to be merged. label Sep 9, 2026
@jiezhao16

Copy link
Copy Markdown

/lgtm

@lahinson
lahinson merged commit cf47b31 into openshift:main Sep 10, 2026
2 checks passed
@lahinson

Copy link
Copy Markdown
Contributor Author

/cherrypick enterprise-5.0
/cherrypick enterprise-4.22
/cherrypick enterprise-4.21
/cherrypick enterprise-4.20
/cherrypick enterprise-4.19
/cherrypick enterprise-4.18

@openshift-cherrypick-robot

Copy link
Copy Markdown

@lahinson: new pull request created: #119673

Details

In response to this:

/cherrypick enterprise-5.0
/cherrypick enterprise-4.22
/cherrypick enterprise-4.21
/cherrypick enterprise-4.20
/cherrypick enterprise-4.19
/cherrypick enterprise-4.18

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes-sigs/prow repository.

@openshift-cherrypick-robot

Copy link
Copy Markdown

@lahinson: new pull request created: #119674

Details

In response to this:

/cherrypick enterprise-5.0
/cherrypick enterprise-4.22
/cherrypick enterprise-4.21
/cherrypick enterprise-4.20
/cherrypick enterprise-4.19
/cherrypick enterprise-4.18

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes-sigs/prow repository.

@openshift-cherrypick-robot

Copy link
Copy Markdown

@lahinson: new pull request created: #119675

Details

In response to this:

/cherrypick enterprise-5.0
/cherrypick enterprise-4.22
/cherrypick enterprise-4.21
/cherrypick enterprise-4.20
/cherrypick enterprise-4.19
/cherrypick enterprise-4.18

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes-sigs/prow repository.

@openshift-cherrypick-robot

Copy link
Copy Markdown

@lahinson: new pull request created: #119676

Details

In response to this:

/cherrypick enterprise-5.0
/cherrypick enterprise-4.22
/cherrypick enterprise-4.21
/cherrypick enterprise-4.20
/cherrypick enterprise-4.19
/cherrypick enterprise-4.18

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes-sigs/prow repository.

@openshift-cherrypick-robot

Copy link
Copy Markdown

@lahinson: new pull request created: #119677

Details

In response to this:

/cherrypick enterprise-5.0
/cherrypick enterprise-4.22
/cherrypick enterprise-4.21
/cherrypick enterprise-4.20
/cherrypick enterprise-4.19
/cherrypick enterprise-4.18

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes-sigs/prow repository.

@openshift-cherrypick-robot

Copy link
Copy Markdown

@lahinson: new pull request created: #119678

Details

In response to this:

/cherrypick enterprise-5.0
/cherrypick enterprise-4.22
/cherrypick enterprise-4.21
/cherrypick enterprise-4.20
/cherrypick enterprise-4.19
/cherrypick enterprise-4.18

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes-sigs/prow repository.

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

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants