Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

openstack: document external LB #6920

Merged
merged 1 commit into from Jun 19, 2023

Conversation

EmilienM
Copy link
Member

@EmilienM EmilienM commented Mar 1, 2023

First iteration to document external LB, when deploying OCP on OSP.

@openshift-ci openshift-ci bot requested review from gryf and stephenfin March 1, 2023 19:46
@EmilienM
Copy link
Member Author

EmilienM commented Mar 1, 2023

/skip
this is a doc only change, don't waste CI

@EmilienM
Copy link
Member Author

EmilienM commented Mar 1, 2023

/cc mandre

@openshift-ci openshift-ci bot requested a review from mandre March 1, 2023 19:49
docs/user/openstack/external_load_balancer.md Outdated Show resolved Hide resolved
docs/user/openstack/external_load_balancer.md Outdated Show resolved Hide resolved

## Common prerequisites

* When deploying OpenShift with an external load balancer, it's required to bring your own network(s) before
Copy link
Member

Choose a reason for hiding this comment

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

I don't think that's technically correct. As long as the LB has a route to get to the subnets where the nodes are deployed, it should be fine, right? In my understanding these subnets don't have to exist beforehand and we can let the IPI installer create the machineSubnet.

Copy link
Member Author

Choose a reason for hiding this comment

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

This is questionable. With terraform-created networks, we don't have the control on the allocation pool for example, so this makes the LB config a bit more difficult I think.
I think we should recommend BYON for simplicity. Also because that's what we have been testing so far.

docs/user/openstack/external_load_balancer.md Outdated Show resolved Hide resolved
@EmilienM
Copy link
Member Author

/skip

@EmilienM EmilienM requested review from mandre and removed request for gryf and stephenfin March 15, 2023 14:44
@EmilienM
Copy link
Member Author

/skip

@rlobillo
Copy link

rlobillo commented Apr 3, 2023

/lgtm

@openshift-ci openshift-ci bot added the lgtm Indicates that a PR is ready to be merged. label Apr 3, 2023
@openshift-ci openshift-ci bot removed the lgtm Indicates that a PR is ready to be merged. label Jun 1, 2023
Copy link
Contributor

@stephenfin stephenfin left a comment

Choose a reason for hiding this comment

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

Loads of grammar nits. I would also move the configuration info for that POC external load balancer role out of this README. Content is otherwise good though. Nice work 👍

docs/user/openstack/external_load_balancer.md Outdated Show resolved Hide resolved
docs/user/openstack/external_load_balancer.md Outdated Show resolved Hide resolved
docs/user/openstack/external_load_balancer.md Outdated Show resolved Hide resolved
docs/user/openstack/external_load_balancer.md Outdated Show resolved Hide resolved
docs/user/openstack/external_load_balancer.md Outdated Show resolved Hide resolved

* `loadBalancer` is a new stanza created in OCP 4.13. The default type is `OpenShiftManagedDefault` (which will deploy HAproxy and Keepalived in OCP, known as the OpenShift managed load balancer). Setting it to `UserManaged` will allow an user managed load balancer to replace the OpenShift managed one.
* `machinesSubnet` is the subnet ID where both the OpenShift cluster and the user managed load balancer are deployed.
* `TechPreviewNoUpgrade` featureSet has to be enabled in OCP 4.13, since the feature was on TechPreview. To do that, just add `featureSet: TechPreviewNoUpgrade` into the install-config.yaml.
Copy link
Contributor

Choose a reason for hiding this comment

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

"was on TechPreview" sounds weird. Can we just say "is a Technology Preview feature in this version". I assume we'll update this when it's GA?

Also, format install-config.yaml as a literal

Copy link
Member

Choose a reason for hiding this comment

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

Or alternatively:

In OCP 4.13 the feature had to be enabled as Technology Preview. This can be done by adding featureSet: TechPreviewNoUpgrade into the install-config.yaml.

And link to https://github.com/openshift/installer/blob/master/docs/user/customization.md#platform-customization

docs/user/openstack/external_load_balancer.md Outdated Show resolved Hide resolved
docs/user/openstack/external_load_balancer.md Outdated Show resolved Hide resolved
docs/user/openstack/external_load_balancer.md Outdated Show resolved Hide resolved
docs/user/openstack/external_load_balancer.md Outdated Show resolved Hide resolved
@openshift-ci
Copy link
Contributor

openshift-ci bot commented Jun 6, 2023

[APPROVALNOTIFIER] This PR is APPROVED

This pull-request has been approved by: stephenfin

The full list of commands accepted by this bot can be found here.

The pull request process is described here

Needs approval from an approver in each of these files:

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

@openshift-ci openshift-ci bot added the approved Indicates a PR has been approved by an approver from all required OWNERS files. label Jun 6, 2023
@rlobillo
Copy link

rlobillo commented Jun 6, 2023

/lgtm

@openshift-ci openshift-ci bot added the lgtm Indicates that a PR is ready to be merged. label Jun 6, 2023
docs/user/openstack/external_load_balancer.md Outdated Show resolved Hide resolved
docs/user/openstack/external_load_balancer.md Outdated Show resolved Hide resolved
docs/user/openstack/external_load_balancer.md Outdated Show resolved Hide resolved

* `loadBalancer` is a new stanza created in OCP 4.13. The default type is `OpenShiftManagedDefault` (which will deploy HAproxy and Keepalived in OCP, known as the OpenShift managed load balancer). Setting it to `UserManaged` will allow an user managed load balancer to replace the OpenShift managed one.
* `machinesSubnet` is the subnet ID where both the OpenShift cluster and the user managed load balancer are deployed.
* `TechPreviewNoUpgrade` featureSet has to be enabled in OCP 4.13, since the feature was on TechPreview. To do that, just add `featureSet: TechPreviewNoUpgrade` into the install-config.yaml.
Copy link
Member

Choose a reason for hiding this comment

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

Or alternatively:

In OCP 4.13 the feature had to be enabled as Technology Preview. This can be done by adding featureSet: TechPreviewNoUpgrade into the install-config.yaml.

And link to https://github.com/openshift/installer/blob/master/docs/user/customization.md#platform-customization

@openshift-ci openshift-ci bot removed the lgtm Indicates that a PR is ready to be merged. label Jun 6, 2023
@EmilienM EmilienM force-pushed the externallb-doc branch 2 times, most recently from 85e7402 to 582c124 Compare June 12, 2023 14:21
Co-authored-by: Martin André <martin.andre@gmail.com>
Copy link
Member

@mandre mandre left a comment

Choose a reason for hiding this comment

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

/lgtm

@openshift-ci openshift-ci bot added the lgtm Indicates that a PR is ready to be merged. label Jun 12, 2023
@openshift-ci
Copy link
Contributor

openshift-ci bot commented Jun 12, 2023

@EmilienM: The following tests failed, say /retest to rerun all failed tests or /retest-required to rerun all mandatory failed tests:

Test name Commit Details Required Rerun command
ci/prow/e2e-aws-ovn-public-subnets 5938bdb link false /test e2e-aws-ovn-public-subnets
ci/prow/e2e-aws-ovn-upgrade cf8059c link false /test e2e-aws-ovn-upgrade
ci/prow/e2e-aws-ovn-workers-rhel8 cf8059c link false /test e2e-aws-ovn-workers-rhel8

Full PR test history. Your PR dashboard.

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/test-infra repository. I understand the commands that are listed here.

@openshift-ci-robot
Copy link
Contributor

/retest-required

Remaining retests: 0 against base HEAD 659b863 and 2 for PR HEAD a115c7c in total

@openshift-merge-robot openshift-merge-robot merged commit 74d48f8 into openshift:master Jun 19, 2023
11 checks passed
@stephenfin stephenfin deleted the externallb-doc branch October 26, 2023 16:17
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
approved Indicates a PR has been approved by an approver from all required OWNERS files. lgtm Indicates that a PR is ready to be merged.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

7 participants