OSDOCS-17042 [CQA] Update infrastructure machine set creation documentation by bscott-rh · Pull Request #105997 · openshift/openshift-docs

bscott-rh · 2026-02-04T19:50:14Z

Update and reorganize the infrastructure machine set documentation per OSDOCS-17042.

Version(s):
4.20+

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

Link to docs preview:
Main assembly

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

ocpdocs-previewbot · 2026-02-04T19:58:56Z

🤖 Fri Jun 12 19:37:54 - Prow CI generated the docs preview:
https://105997--ocpdocs-pr.netlify.app
Complete list of updated preview URLs: artifacts/updated_preview_urls.txt

jeana-redhat

Nice work, generally very sound. There are a few things I noted here that might be out of scope for a CQA, but equally might be easy to touch up while you have it open as an assembly. I leave all of this to your discernment.

/remove-label merge-review-in-progress
/remove-label merge-review-needed

openshift-ci · 2026-02-26T15:00:52Z

@jeana-redhat: Those labels are not set on the issue: merge-review-in-progress, merge-review-needed

Details

In response to this:

Nice work, generally very sound. There are a few things I noted here that might be out of scope for a CQA, but equally might be easy to touch up while you have it open as an assembly. I leave all of this to your discernment.

/remove-label merge-review-in-progress
/remove-label merge-review-needed

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.

jeana-redhat · 2026-06-08T17:07:37Z

The branch/enterprise-5.0 label has been added to this PR.

This is because your PR targets the main branch and is labeled for branch/enterprise-4.22. And any PR going into main must also target the latest version branch (branch/enterprise-5.0).

If the update in your PR does NOT apply to version 5.0 onward, please re-target this PR to go directly into the appropriate enterprise- version branch or branches instead of main.

ocpdocs-vale-bot · 2026-06-10T20:09:50Z

-
-[id="creating-infrastructure-machinesets-clouds"]
-=== Creating infrastructure machine sets for different clouds
+To create an infrastructure node, you can xref:../machine_management/creating-infrastructure-machinesets.adoc#machineset-creating_creating-infrastructure-machinesets[use a machine set], xref:../machine_management/creating-infrastructure-machinesets.adoc#creating-an-infra-node_creating-infrastructure-machinesets[label the node], or xref:../machine_management/creating-infrastructure-machinesets.adoc#creating-infra-machines_creating-infrastructure-machinesets[use a machine config pool]. Use the sample compute machine set for your cloud to deploy an infrastructure machine set. Modify the sample configuration file with the details of your environment.


🤖 [error] AsciiDocDITA.ConceptLink: Move all links and cross references to Additional resources.

ocpdocs-vale-bot · 2026-06-10T20:09:52Z

-
-[id="creating-infrastructure-machinesets-clouds"]
-=== Creating infrastructure machine sets for different clouds
+To create an infrastructure node, you can xref:../machine_management/creating-infrastructure-machinesets.adoc#machineset-creating_creating-infrastructure-machinesets[use a machine set], xref:../machine_management/creating-infrastructure-machinesets.adoc#creating-an-infra-node_creating-infrastructure-machinesets[label the node], or xref:../machine_management/creating-infrastructure-machinesets.adoc#creating-infra-machines_creating-infrastructure-machinesets[use a machine config pool]. Use the sample compute machine set for your cloud to deploy an infrastructure machine set. Modify the sample configuration file with the details of your environment.


🤖 [error] AsciiDocDITA.ConceptLink: Move all links and cross references to Additional resources.

ocpdocs-vale-bot · 2026-06-10T20:09:54Z

-
-[id="creating-infrastructure-machinesets-clouds"]
-=== Creating infrastructure machine sets for different clouds
+To create an infrastructure node, you can xref:../machine_management/creating-infrastructure-machinesets.adoc#machineset-creating_creating-infrastructure-machinesets[use a machine set], xref:../machine_management/creating-infrastructure-machinesets.adoc#creating-an-infra-node_creating-infrastructure-machinesets[label the node], or xref:../machine_management/creating-infrastructure-machinesets.adoc#creating-infra-machines_creating-infrastructure-machinesets[use a machine config pool]. Use the sample compute machine set for your cloud to deploy an infrastructure machine set. Modify the sample configuration file with the details of your environment.


🤖 [error] AsciiDocDITA.ConceptLink: Move all links and cross references to Additional resources.

Update and reorganize the infrastructure machine set documentation per OSDOCS-17042. Key changes: - Add new module infra-machine-sets-moving.adoc for resource movement guidance - Add creating-infra-machine-sets-prod.adoc for production considerations - Update creating-infrastructure-machinesets.adoc assembly structure - Refine procedures in creating-infra-machines.adoc - Update infrastructure component movement modules (monitoring, registry, router) - Improve taints and tolerations documentation - Remove elasticsearch references per 103344 - Fix xrefs and definition list rendering Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

openshift-ci · 2026-06-12T19:46:13Z

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

openshift-ci Bot added the size/L Denotes a PR that changes 100-499 lines, ignoring generated files. label Feb 4, 2026

ocpdocs-vale-bot reviewed Feb 4, 2026

View reviewed changes

Comment thread modules/infra-machine-sets-moving.adoc

bscott-rh changed the title ~~OSDOCS-17042 Update infrastructure machine set creation documentation~~ OSDOCS-17042 [CQA] Update infrastructure machine set creation documentation Feb 23, 2026

This was referenced Feb 23, 2026

OSDOCS-17042 [CQA] Convert callouts to definition lists in MachineSet YAML #105995

Closed

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

Open

bscott-rh force-pushed the OSDOCS-17042-pr3-infra-machinesets branch from 2b6eb3b to fc44fb4 Compare February 23, 2026 19:11

bscott-rh added branch/enterprise-4.16 branch/enterprise-4.17 branch/enterprise-4.18 branch/enterprise-4.19 branch/enterprise-4.20 branch/enterprise-4.21 branch/enterprise-4.22 labels Feb 23, 2026

bscott-rh added this to the Continuous Release milestone Feb 23, 2026

jeana-redhat reviewed Feb 26, 2026

View reviewed changes

Comment thread machine_management/creating-infrastructure-machinesets.adoc

bscott-rh force-pushed the OSDOCS-17042-pr3-infra-machinesets branch from fc44fb4 to 0de68b4 Compare March 2, 2026 20:58

ocpdocs-vale-bot reviewed Mar 2, 2026

View reviewed changes

Comment thread machine_management/creating-infrastructure-machinesets.adoc Outdated

ocpdocs-vale-bot reviewed Mar 2, 2026

View reviewed changes

Comment thread machine_management/creating-infrastructure-machinesets.adoc Outdated

bscott-rh force-pushed the OSDOCS-17042-pr3-infra-machinesets branch from 0de68b4 to eb1506e Compare March 3, 2026 13:36

jeana-redhat added the branch/enterprise-5.0 label Jun 8, 2026

openshift-ci Bot added the needs-rebase Indicates a PR cannot be merged because it has merge conflicts with HEAD. label Jun 8, 2026

bscott-rh force-pushed the OSDOCS-17042-pr3-infra-machinesets branch from eb1506e to a8a5d55 Compare June 10, 2026 19:17

openshift-ci Bot removed the needs-rebase Indicates a PR cannot be merged because it has merge conflicts with HEAD. label Jun 10, 2026

bscott-rh removed branch/enterprise-4.16 branch/enterprise-4.17 branch/enterprise-4.18 labels Jun 10, 2026

bscott-rh removed the branch/enterprise-4.19 label Jun 10, 2026

ocpdocs-vale-bot reviewed Jun 10, 2026

View reviewed changes

Comment thread modules/infrastructure-components.adoc Outdated

bscott-rh force-pushed the OSDOCS-17042-pr3-infra-machinesets branch 2 times, most recently from 0732aa0 to fefcf55 Compare June 11, 2026 19:38

bscott-rh and others added 2 commits June 12, 2026 14:03

Merge review feedback

b6af648

bscott-rh force-pushed the OSDOCS-17042-pr3-infra-machinesets branch from fefcf55 to 6119d4d Compare June 12, 2026 18:05

Fixed rebase error

6f86a45

bscott-rh force-pushed the OSDOCS-17042-pr3-infra-machinesets branch from 6119d4d to 6f86a45 Compare June 12, 2026 18:41

bscott-rh added 2 commits June 12, 2026 15:21

Additional vale fixes

489e048

Moved links to additional resources

3894382

Conversation

bscott-rh commented Feb 4, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

ocpdocs-previewbot commented Feb 4, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Uh oh!

jeana-redhat left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

openshift-ci Bot commented Feb 26, 2026

Uh oh!

Uh oh!

Uh oh!

Uh oh!

jeana-redhat commented Jun 8, 2026

Uh oh!

ocpdocs-vale-bot Jun 10, 2026

Choose a reason for hiding this comment

Uh oh!

ocpdocs-vale-bot Jun 10, 2026

Choose a reason for hiding this comment

Uh oh!

ocpdocs-vale-bot Jun 10, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

openshift-ci Bot commented Jun 12, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

bscott-rh commented Feb 4, 2026 •

edited

Loading

ocpdocs-previewbot commented Feb 4, 2026 •

edited

Loading