Skip to content

OSDOCS-16614: Documented VIP optional with user-managed LB feature#104065

Merged
JoeAldinger merged 1 commit intoopenshift:mainfrom
dfitzmau:OSDOCS-16614
Feb 2, 2026
Merged

OSDOCS-16614: Documented VIP optional with user-managed LB feature#104065
JoeAldinger merged 1 commit intoopenshift:mainfrom
dfitzmau:OSDOCS-16614

Conversation

@openshift-ci-robot openshift-ci-robot added the jira/valid-reference Indicates that this PR references a valid Jira ticket of any type. label Dec 17, 2025
@openshift-ci-robot
Copy link
Copy Markdown

openshift-ci-robot commented Dec 17, 2025

@dfitzmau: This pull request references OSDOCS-16614 which is a valid jira issue.

Warning: The referenced jira issue has an invalid target version for the target branch this PR targets: expected the epic to target either version "4.22." or "openshift-4.22.", but it targets "openshift-4.21" instead.

Details

In response to this:

Version(s):
4.20+

Issue:
OSDOCS-16614

Link to docs preview:

  • SME has approved this change.
  • QE has approved this change.

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 openshift-eng/jira-lifecycle-plugin repository.

@openshift-ci openshift-ci Bot added the size/XS Denotes a PR that changes 0-9 lines, ignoring generated files. label Dec 17, 2025
@dfitzmau dfitzmau force-pushed the OSDOCS-16614 branch 2 times, most recently from ed2f3c4 to d58bc86 Compare December 17, 2025 12:53
@openshift-ci openshift-ci Bot added size/S Denotes a PR that changes 10-29 lines, ignoring generated files. and removed size/XS Denotes a PR that changes 0-9 lines, ignoring generated files. labels Dec 17, 2025
@openshift-ci openshift-ci Bot added size/M Denotes a PR that changes 30-99 lines, ignoring generated files. and removed size/S Denotes a PR that changes 10-29 lines, ignoring generated files. labels Dec 17, 2025
Comment thread modules/installation-bare-metal-dns-record-type.adoc
Comment thread modules/installation-bare-metal-dns-record-type.adoc
@openshift-ci-robot
Copy link
Copy Markdown

openshift-ci-robot commented Dec 17, 2025

@dfitzmau: This pull request references OSDOCS-16614 which is a valid jira issue.

Warning: The referenced jira issue has an invalid target version for the target branch this PR targets: expected the epic to target either version "4.22." or "openshift-4.22.", but it targets "openshift-4.21" instead.

Details

In response to this:

Version(s):
4.20+

Issue:
OSDOCS-16614

Link to docs preview:

  • SME has approved this change.
  • QE has approved this change.

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 openshift-eng/jira-lifecycle-plugin repository.

@openshift-ci-robot
Copy link
Copy Markdown

openshift-ci-robot commented Dec 17, 2025

@dfitzmau: This pull request references OSDOCS-16614 which is a valid jira issue.

Warning: The referenced jira issue has an invalid target version for the target branch this PR targets: expected the epic to target either version "4.22." or "openshift-4.22.", but it targets "openshift-4.21" instead.

Details

In response to this:

Version(s):
4.20+

Issue:
OSDOCS-16614

Link to docs preview:

  • SME has approved this change.
  • QE has approved this change.

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 openshift-eng/jira-lifecycle-plugin repository.

@dfitzmau dfitzmau force-pushed the OSDOCS-16614 branch 2 times, most recently from fc1d2ac to f261856 Compare December 18, 2025 12:26
Copy link
Copy Markdown
Member

@cybertron cybertron left a comment

Choose a reason for hiding this comment

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

This can't be set via the CR, it needs to be done in install-config at initial deployment.

Comment thread modules/installation-bare-metal-dns-record-type.adoc Outdated
Comment thread modules/installation-bare-metal-dns-record-type.adoc Outdated
@openshift-ci-robot
Copy link
Copy Markdown

openshift-ci-robot commented Dec 22, 2025

@dfitzmau: This pull request references OSDOCS-16614 which is a valid jira issue.

Warning: The referenced jira issue has an invalid target version for the target branch this PR targets: expected the epic to target either version "4.22." or "openshift-4.22.", but it targets "openshift-4.21" instead.

Details

In response to this:

Version(s):
4.20+

Issue:
OSDOCS-16614

Link to docs preview:

  • SME has approved this change.
  • QE has approved this change.

openshift/api#2460

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 openshift-eng/jira-lifecycle-plugin repository.

@dfitzmau dfitzmau force-pushed the OSDOCS-16614 branch 2 times, most recently from ff2b2e6 to e9b97d8 Compare December 22, 2025 14:29
Comment thread modules/nw-dns-forward.adoc
Copy link
Copy Markdown
Member

@cybertron cybertron left a comment

Choose a reason for hiding this comment

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

A couple of small suggestions inline, but overall lgtm.

Comment thread modules/installation-bare-metal-dns-record-type.adoc Outdated
Comment thread modules/installation-bare-metal-dns-record-type.adoc Outdated
Comment thread modules/installation-bare-metal-dns-record-type.adoc Outdated
loadBalancer:
type: UserManaged
# ...
spec:
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Oops, I didn't catch this before, but this is the wrong syntax for install-config. The example should look something like this:

platform:
  baremetal:
# ...
    loadBalancer:
      type: UserManaged
    dnsRecordsType: External
# ...

There's no spec in install-config because it's not an API in the Kubernetes sense.

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.

Thanks. I've updated the config to:

apiVersion: v1
baseDomain: example.com
metadata:
  name: dev-cluster
# ...
platform:
  baremetal:
# ...
    loadBalancer:
      type: UserManaged
    dnsRecordsType: External
# ...
featureSet: TechPreviewNoUpgrade
pullSecret: '{"auths":{"<local_registry>": {"auth": "<credentials>","email": "you@example.com"}}}'
sshKey: 'ssh-ed25519 AAAA...'
# ...

Where # ... hides hidden YAML lines that are not in the main scope for this document.

@openshift-ci-robot
Copy link
Copy Markdown

openshift-ci-robot commented Jan 12, 2026

@dfitzmau: This pull request references OSDOCS-16614 which is a valid jira issue.

Warning: The referenced jira issue has an invalid target version for the target branch this PR targets: expected the epic to target either version "4.22." or "openshift-4.22.", but it targets "openshift-4.21" instead.

Details

In response to this:

Version(s):
4.21

Issue:
OSDOCS-16614

Link to docs preview:

  • SME has approved this change.
  • QE has approved this change.

openshift/api#2460

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 openshift-eng/jira-lifecycle-plugin repository.

@openshift-ci
Copy link
Copy Markdown

openshift-ci Bot commented Jan 12, 2026

@dfitzmau: 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.

@openshift-ci-robot
Copy link
Copy Markdown

openshift-ci-robot commented Jan 12, 2026

@dfitzmau: This pull request references OSDOCS-16614 which is a valid jira issue.

Warning: The referenced jira issue has an invalid target version for the target branch this PR targets: expected the epic to target either version "4.22." or "openshift-4.22.", but it targets "openshift-4.21" instead.

Details

In response to this:

Version(s):
4.21

Issue:
OSDOCS-16614

Link to docs preview:

  • SME has approved this change.
  • QE has approved this change.

openshift/api#2460

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 openshift-eng/jira-lifecycle-plugin repository.

Copy link
Copy Markdown
Member

@cybertron cybertron left a comment

Choose a reason for hiding this comment

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

/lgtm

Thanks!

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

.Prerequisites

* You created DNS records, such as `api`, `api-int`, or `\*.apps`.
Copy link
Copy Markdown

Choose a reason for hiding this comment

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

\*.apps the backslash is for shell usage, is it normal style usage? I guess it's a style question.

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.

I'll remove. I sometimes need to add the escape character () to prevent build errors.

@rbbratta
Copy link
Copy Markdown

rbbratta commented Feb 2, 2026

/lgtm

@kalexand-rh kalexand-rh added the merge-review-needed Signifies that the merge review team needs to review this PR label Feb 2, 2026
@openshift-ci-robot
Copy link
Copy Markdown

openshift-ci-robot commented Feb 2, 2026

@dfitzmau: This pull request references OSDOCS-16614 which is a valid jira issue.

Warning: The referenced jira issue has an invalid target version for the target branch this PR targets: expected the epic to target either version "4.22." or "openshift-4.22.", but it targets "openshift-4.21" instead.

Details

In response to this:

Version(s):
4.21

Issue:
OSDOCS-16614

Link to docs preview:

  • SME has approved this change.
  • QE has approved this change.

openshift/api#2460

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 openshift-eng/jira-lifecycle-plugin repository.

@lahinson lahinson added merge-review-in-progress Signifies that the merge review team is reviewing this PR and removed merge-review-needed Signifies that the merge review team needs to review this PR labels Feb 2, 2026
Copy link
Copy Markdown
Contributor

@lahinson lahinson left a comment

Choose a reason for hiding this comment

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

@dfitzmau I commented on a couple of things for you to check, but nothing is a stop-ship issue. Feel free to merge this one when you're ready.


[IMPORTANT]
====
During pod creation, Kubernetes uses the `/etc/resolv.conf` file that exists on a node. If you modify the `/etc/resolv.conf` file on a host node, the changes do not propagate to the `/etc/resolv.conf` file that exists in a container. You must recreate the container for changes to take effect.
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.

Suggested change
During pod creation, Kubernetes uses the `/etc/resolv.conf` file that exists on a node. If you modify the `/etc/resolv.conf` file on a host node, the changes do not propagate to the `/etc/resolv.conf` file that exists in a container. You must recreate the container for changes to take effect.
During pod creation, Kubernetes uses the `/etc/resolv.conf` file that exists on a node. If you modify the `/etc/resolv.conf` file on a host node, the changes do not propagate to the `/etc/resolv.conf` file that exists in a container. You must re-create the container for changes to take effect.

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.

✔️

+
[IMPORTANT]
====
During pod creation, Kubernetes uses the `/etc/resolv.conf` file that exists on a node. If you modify the `/etc/resolv.conf` file on a host node, the changes do not propagate to the `/etc/resolv.conf` file that exists in a container. You must recreate the container for changes to take effect.
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.

Suggested change
During pod creation, Kubernetes uses the `/etc/resolv.conf` file that exists on a node. If you modify the `/etc/resolv.conf` file on a host node, the changes do not propagate to the `/etc/resolv.conf` file that exists in a container. You must recreate the container for changes to take effect.
During pod creation, Kubernetes uses the `/etc/resolv.conf` file that exists on a node. If you modify the `/etc/resolv.conf` file on a host node, the changes do not propagate to the `/etc/resolv.conf` file that exists in a container. You must re-create the container for changes to take effect.

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.

✔️


.Procedure

* During cluster installation, specify `TechPreviewNoUpgrade` for the `featureSet` parameter and specify `External` for the `dnsRecordsType` parameter in the `install-config.yaml` file:
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.

Suggested change
* During cluster installation, specify `TechPreviewNoUpgrade` for the `featureSet` parameter and specify `External` for the `dnsRecordsType` parameter in the `install-config.yaml` file:
* During cluster installation, in the `install-config.yaml` file, specify `TechPreviewNoUpgrade` for the `featureSet` parameter and specify `External` for the `dnsRecordsType` parameter:

Just a suggestion. It's a good practice to tell the user where they need to do something before you tell them what they need to do.

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.

✔️


.Prerequisites

* You created DNS records, such as `api`, `api-int`, or `\*.apps`.
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.

I'm also curious about this line. Do you want the backslash to be visible?

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.

✔️

@lahinson lahinson added ok-to-merge and removed merge-review-in-progress Signifies that the merge review team is reviewing this PR labels Feb 2, 2026
Copy link
Copy Markdown
Contributor

@JoeAldinger JoeAldinger left a comment

Choose a reason for hiding this comment

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

/lgtm Laura, agree no stop ships but things to consider.

// * installing/installing_bare_metal/upi/installing-bare-metal.adoc
// * installing/installing_bare_metal/upi/installing-restricted-networks-bare-metal.adoc

:_mod-docs-content-type: CONCEPT
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.

This needs to be changed to PROCEDURE

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.

Good catch, Joe!

Copy link
Copy Markdown
Contributor

@kalexand-rh kalexand-rh left a comment

Choose a reason for hiding this comment

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

@dfitzmau, please open a follow-up PR to address the review feedback on https://issues.redhat.com/browse/OSDOCS-18118 for us to merge after GA.

@JoeAldinger JoeAldinger merged commit 32f0df5 into openshift:main Feb 2, 2026
2 checks passed
@JoeAldinger
Copy link
Copy Markdown
Contributor

/cherrypick enterprise-4.21

@openshift-cherrypick-robot
Copy link
Copy Markdown

@JoeAldinger: new pull request created: #105829

Details

In response to this:

/cherrypick enterprise-4.21

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

branch/enterprise-4.21 jira/valid-reference Indicates that this PR references a valid Jira ticket of any type. lgtm Indicates that a PR is ready to be merged. ok-to-merge size/M Denotes a PR that changes 30-99 lines, ignoring generated files.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

10 participants