OSDOCS Specify that user-created machinesets should use the latest bootimages by mburke5678 · Pull Request #109278 · openshift/openshift-docs

mburke5678 · 2026-03-30T22:08:41Z

https://redhat.atlassian.net/browse/OSDOCS-18752

Link to docs preview:
Overview of machine management -> Compute machine management -- Added note at end of section and link.

Machine configuration -> Manually updating the boot image -> Manually updating the boot image on a Nutanix cluster -- Added boot image skew enforcement wording, as last step in the procedure, right before the verification.
Machine configuration -> Manually updating the boot image -> Manually updating the boot image on an RHOSP cluster -- Added boot image skew enforcement wording, as last step in the procedure, right before the verification.

QE review:

QE has approved this change.

ocpdocs-previewbot · 2026-03-30T22:22:41Z

🤖 Thu Apr 09 17:36:09 - Prow CI generated the docs preview:
https://109278--ocpdocs-pr.netlify.app
Complete list of updated preview URLs: artifacts/updated_preview_urls.txt

mburke5678 · 2026-03-31T15:05:53Z

/retest

modules/machineset-yaml-osp-sr-iov.adoc

djoshy · 2026-03-31T16:56:27Z

modules/machineset-yaml-vsphere.adoc

 `<disk_name>`:: Specifies one or more data disk definitions. For more information, see "Configuring data disks by using machine sets".
+`<image_name>`:: Specifies the image to use as a boot image for your nodes. You should use the use the latest image when adding a new machine set.
 `<vm_network_name>`:: Specifies the vSphere VM network to deploy the compute machine set to. This VM network must be where other compute machines reside in the cluster.
 `<vm_template_name>`:: Specifies the vSphere VM template to use, such as `user-5ddjd-rhcos`.


vsphere uses template field, there is no image field

<vm_template_name>:: Specifies the vSphere VM template to use as a boot image for your nodes, such as user-5ddjd-rhcos. You should use a template with the latest {product-title} image when adding a new machine set.

djoshy · 2026-03-31T16:59:24Z

modules/machineset-yaml-baremetal.adoc

 <3> Specify the node label to add.
-<4> Edit the `checksum` URL to use the API VIP address.
-<5> Edit the `url` URL to use the API VIP address.
+<4> Specify the image details of the boot image for your nodes. You should use the latest image when adding a new machine set.


We should ask them to migrate to the new system for baremetal(#109158) than do this, since it is a one time action. This is referencing the old <4.9, presumably because the docs are out of date?

When creating a bare metal machine set, you do not need to specify a boot image? The CVO takes care of this for new machines?
As for what is outdated, is it the whole stanza or just the <4> and <5>?

image: <4> checksum: http:/172.22.0.3:6181/images/rhcos-<version>.<architecture>.qcow2.<md5sum> <5> url: http://172.22.0.3:6181/images/rhcos-<version>.<architecture>.qcow2 <6>

It appears the example was added around the time when 4.12 was the current release. So it could be dated.

djoshy · 2026-03-31T17:03:47Z

machine_management/index.adoc


+[NOTE]
+====
+When creating a new machine set, you should specify the latest image to use for the boot image. The method to specify the image varies by provider.  


Suggested change

When creating a new machine set, you should specify the latest image to use for the boot image. The method to specify the image varies by provider.

When creating a new machine set, you should specify the latest image to use for the boot image. For more info about updating the bootimage on your cluster, please refer to "Boot image management". The method to update or specify the image varies by provider.

I did not see the preview for this, but perhaps it would be helpful to provide a reference about boot image updates here, so they can figure out if their cluster is even updated, and if it is, they can just copy of an existing machineset.

Link to preview: Managing compute machines

…otimages

djoshy · 2026-04-09T17:22:34Z

modules/machine-managing-compute-machines.adoc

+
+[NOTE]
+====
+When creating a new machine set, you should specify the latest image to use for the boot image. For more information about updating the boot image on your cluster, see "Manually updating the boot image". The method to update or specify the image varies by platform.  


Suggested change

When creating a new machine set, you should specify the latest image to use for the boot image. For more information about updating the boot image on your cluster, see "Manually updating the boot image". The method to update or specify the image varies by platform.

When creating a new machine set, you should specify the latest image to use for the boot image. For more information about updating the boot image on your cluster, see "Manually updating the boot image" and "Boot image management". The method to update or specify the image varies by platform.

just adding a ref here

djoshy · 2026-04-09T17:29:41Z

lgtm!

openshift-ci · 2026-04-09T17:37:24Z

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

djoshy · 2026-04-10T12:54:31Z

snippets/mco-update-boot-images-intro.adoc

 |===

-For all other platforms, the MCO does not update the boot image with each cluster update.
+For all other platforms, the MCO does not automatically update the boot image with each cluster update. For clusters where automatic updates are disabled or not supported, you can manually update the boot image on your cluster. See "Manually updating the boot image" for information. The method to update or specify the image varies by platform.  


Is there already a link to "Manually updating the boot image" in additional resources?

mburke5678 added the branch/enterprise-4.22 label Mar 30, 2026

mburke5678 added this to the Planned for 4.22 GA milestone Mar 30, 2026

openshift-ci bot added the size/M Denotes a PR that changes 30-99 lines, ignoring generated files. label Mar 30, 2026

openshift-ci bot added size/L Denotes a PR that changes 100-499 lines, ignoring generated files. and removed size/M Denotes a PR that changes 30-99 lines, ignoring generated files. labels Mar 31, 2026

ocpdocs-vale-bot reviewed Mar 31, 2026

View reviewed changes

modules/machineset-yaml-osp-sr-iov.adoc Show resolved Hide resolved

djoshy reviewed Mar 31, 2026

View reviewed changes

mburke5678 force-pushed the mco-boot-image-use-latest branch from 366ddc9 to ba4b183 Compare April 3, 2026 18:20

Michael Burke added 9 commits April 9, 2026 08:12

OSDOCS Specify that user-created machinesets should use the latest bo…

4ae9ce0

…otimages

edit

ea97441

typo

be5936c

typo

a88bc20

edits

575dc10

Fix build error

e5d75c3

edit per djoshy

b565e17

Fix typo

48c44cc

Fix merge error

72611dd

mburke5678 force-pushed the mco-boot-image-use-latest branch from ba4b183 to 72611dd Compare April 9, 2026 13:02

Michael Burke added 2 commits April 9, 2026 09:43

Fix build/merge errors

287ce8e

edits per djoshy

674c8e5

djoshy reviewed Apr 9, 2026

View reviewed changes

edit

bc288b2

djoshy reviewed Apr 10, 2026

View reviewed changes

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

OSDOCS Specify that user-created machinesets should use the latest bootimages#109278

OSDOCS Specify that user-created machinesets should use the latest bootimages#109278
mburke5678 wants to merge 12 commits intoopenshift:mainfrom
mburke5678:mco-boot-image-use-latest

mburke5678 commented Mar 30, 2026 •

edited

Loading

Uh oh!

ocpdocs-previewbot commented Mar 30, 2026 •

edited

Loading

Uh oh!

mburke5678 commented Mar 31, 2026

Uh oh!

Uh oh!

djoshy Mar 31, 2026

Uh oh!

mburke5678 Mar 31, 2026

Uh oh!

djoshy Mar 31, 2026

Uh oh!

mburke5678 Mar 31, 2026

Uh oh!

djoshy Mar 31, 2026

Uh oh!

mburke5678 Mar 31, 2026

Uh oh!

djoshy Apr 9, 2026

Uh oh!

djoshy commented Apr 9, 2026

Uh oh!

openshift-ci bot commented Apr 9, 2026

Uh oh!

djoshy Apr 10, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

	When creating a new machine set, you should specify the latest image to use for the boot image. The method to specify the image varies by provider.
	When creating a new machine set, you should specify the latest image to use for the boot image. For more info about updating the bootimage on your cluster, please refer to "Boot image management". The method to update or specify the image varies by provider.

Conversation

mburke5678 commented Mar 30, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

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

Uh oh!

Uh oh!

mburke5678 commented Mar 31, 2026

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

djoshy commented Apr 9, 2026

Uh oh!

openshift-ci bot commented Apr 9, 2026

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

mburke5678 commented Mar 30, 2026 •

edited

Loading

ocpdocs-previewbot commented Mar 30, 2026 •

edited

Loading