Skip to content

OSDOCS-17042 [CQA] Simplify VPA and CRO resource movement documentation#105996

Open
bscott-rh wants to merge 3 commits into
openshift:mainfrom
bscott-rh:OSDOCS-17042-pr2-vpa-cro
Open

OSDOCS-17042 [CQA] Simplify VPA and CRO resource movement documentation#105996
bscott-rh wants to merge 3 commits into
openshift:mainfrom
bscott-rh:OSDOCS-17042-pr2-vpa-cro

Conversation

@bscott-rh
Copy link
Copy Markdown
Contributor

@bscott-rh bscott-rh commented Feb 4, 2026

Refactor and consolidate the documentation for moving Vertical Pod Autoscaler (VPA) and Cluster Resource Override (CRO) resources to infrastructure nodes.

Version(s):
4.16+

Issue:
https://issues.redhat.com/browse/OSDOCS-17042

Link to docs preview:
Moving VPA
Moving CRO

This is 1 of 3 PRs split out from #103488 by Claude. The other two PRs are #105995 and #105997

@openshift-ci openshift-ci Bot added the size/L Denotes a PR that changes 100-499 lines, ignoring generated files. label Feb 4, 2026
@bscott-rh bscott-rh changed the title OSDOCS-17042 Simplify VPA and CRO resource movement documentation OSDOCS-17042 [CQA] Simplify VPA and CRO resource movement documentation Feb 23, 2026
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.

This module was two nearly-identical procedures, one that moved the pod to an arbitrary node, and one that specifically moved it to an infra node. Because both of the assemblies that include this module are dealing with infra nodes, I flattened the module into one simpler procedure that works for both scenarios.

Copy link
Copy Markdown
Contributor

@jeana-redhat jeana-redhat left a comment

Choose a reason for hiding this comment

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

Good fixes imho. Some callout replacement things to look at, and I think this does unfortunately need QA ack if you are changing the YAML in that one step (even though I am sure you are correct and it's just been in there wrong for years)

Comment thread modules/nodes-cluster-resource-override-move-infra.adoc Outdated
.Procedure

.Example node list
. Determine the nodes where the Cluster Resource Override pods are running by running the following command:
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.

Do you think there is value to preserving the example output (the pod list not the node list) here with the explanation that it had?

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 think it would actually be best to remove this step, and add a prerequisite that states that the user has created one or more infrastructure nodes and is ready to move pods to them.

Comment thread modules/nodes-cluster-resource-override-move-infra.adoc Outdated
Comment thread modules/nodes-cluster-resource-override-move-infra.adoc Outdated
nodeSelector:
node-role.kubernetes.io/worker: ""
tolerations: <1>
node-role.kubernetes.io/infra: ""
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.

So, I am sure this is correct, but this should get a QA ✔️

Comment thread modules/nodes-cluster-resource-override-move-infra.adoc Outdated
Comment thread modules/nodes-pods-vertical-autoscaler-moving-vpa.adoc Outdated
Comment on lines +60 to +61
`<node_role>`:: Specifies the node role of the node where you want to move the VPA Operator pod, for example `infra` to move the pod to an infrastructure node.
`<tolerations>`:: Specifies a toleration for a taint on the node where you want to move the VPA Operator pod. This parameter is only necessary if the destination node uses a taint.
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.

<tolerations> is not a variable above. Because the first former callout is referring to part of the param, I think you'd need to do something like this to be able to mention both and use consistent presentation:

Suggested change
`<node_role>`:: Specifies the node role of the node where you want to move the VPA Operator pod, for example `infra` to move the pod to an infrastructure node.
`<tolerations>`:: Specifies a toleration for a taint on the node where you want to move the VPA Operator pod. This parameter is only necessary if the destination node uses a taint.
`spec.config.nodeSelector`:: Specifies the node selector of the node where you want to move the VPA Operator pod and `<node_role>` is the node role. For example, to move the pod to an infrastructure node, this value would be `node-role.kubernetes.io/infra: ""`.
`spec.config.tolerations`:: Specifies a toleration for a taint on the node where you want to move the VPA Operator pod. This parameter is only necessary if the destination node uses a taint.

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.

Good suggestion

Comment on lines +115 to +116
`<node_role>`:: Specifies the node role for the admission, recommender, and updater pods, for example `infra` to move the pod to an infrastructure node..
`<tolerations>`:: Specifies a toleration for a taint on the node where you want to move the admission, recommender, and updater pods. This parameter is only necessary if the destination node uses a taint.
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.

same issue w/callouts here

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.

Resolved by adding specific full path descriptions for admission, recommender, and updater pods.

bscott-rh and others added 3 commits March 3, 2026 08:53
Refactor and consolidate the documentation for moving Vertical Pod Autoscaler (VPA)
and Cluster Resource Override (CRO) resources to infrastructure nodes.

- Reduce nodes-pods-vertical-autoscaler-moving-vpa.adoc by 249 lines
- Reduce nodes-cluster-resource-override-move-infra.adoc by 103 lines
- Streamline procedures and remove redundant content

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
@bscott-rh bscott-rh force-pushed the OSDOCS-17042-pr2-vpa-cro branch from 3776244 to b08de84 Compare March 3, 2026 14:20
@openshift-ci
Copy link
Copy Markdown

openshift-ci Bot commented Mar 3, 2026

@bscott-rh: 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.

@bscott-rh
Copy link
Copy Markdown
Contributor Author

Hi @miyadav - would you PTAL at this PR to make sure the updates I made to the YAML files are accurate? I made the changes as part of our content quality assessments as we are preparing to migrate our codebase to a new content management system. Thanks

@miyadav
Copy link
Copy Markdown
Member

miyadav commented Mar 19, 2026

Hi @bscott-rh , Not certain I’m the right reviewer here—adding @joelsmith in case this falls under their area...

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

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants