OSDOCS 15615 Clarity on bootimage changes on AWS and GCP by mburke5678 · Pull Request #97038 · openshift/openshift-docs

mburke5678 · 2025-08-01T16:28:15Z

https://issues.redhat.com/browse/OSDOCS-15615

Link to docs preview:
About boot image management -- New note; new AWS machine set example.

No QE review needed of the following changes:
Enabling boot image management -- Moved verification bullet 2 to snippet.
Disabling boot image management -- Moved verification bullet 2 to snippet.

QE review:

QE has approved this change.

ocpdocs-previewbot · 2025-08-01T16:44:00Z

🤖 Thu Aug 07 12:33:43 - Prow CI generated the docs preview:

https://97038--ocpdocs-pr.netlify.app/
https://97038--ocpdocs-pr.netlify.app/openshift-enterprise/latest/machine_configuration/mco-update-boot-images.html
https://97038--ocpdocs-pr.netlify.app/openshift-enterprise/latest/nodes/nodes/nodes-update-boot-images.html

djoshy · 2025-08-04T19:10:48Z

modules/mco-update-boot-images-about.adoc

 ====

-To view the current boot image used in your cluster, examine a machine set:
+To view the current boot image used in your cluster, examine a machine set. The location and format of the boot image within the machine set differs, based on the platform. However, the boot image is always listed in the `spec.template.spec.providerSpec.` parameter. 


I wonder if we can put this in one of those fancy "warning" boxes? So it is a bit more easy to notice than a regular paragraph. Content sounds good to me!

mburke5678 · 2025-08-05T19:10:57Z

@ptalgulk01 Can you PTAL?

ptalgulk01 · 2025-08-06T06:57:03Z

looks good

djoshy · 2025-08-06T20:52:33Z

/lgtm from MCO POV!

openshift-ci · 2025-08-07T12:35:52Z

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

dfitzmau · 2025-08-07T15:38:12Z

modules/mco-update-boot-images-about.adoc

-.Example machine set with the boot image reference
+[NOTE]
+====
+The location and format of the boot image within the machine set differs, based on the platform. However, the boot image is always listed in the `spec.template.spec.providerSpec.` parameter. 


Suggested change

The location and format of the boot image within the machine set differs, based on the platform. However, the boot image is always listed in the `spec.template.spec.providerSpec.` parameter.

The location and format of the boot image within the machine set differs, based on the platform. However, the boot image is always listed in the `spec.template.spec.providerSpec` parameter.

Visually might look better. If this is possible? Maybe a follow-up PR if the change is valid. I won't hold up PR merging.

dfitzmau · 2025-08-07T15:41:46Z

/cherrypick enterprise-4.20

dfitzmau · 2025-08-07T15:41:49Z

/cherrypick enterprise-4.19

dfitzmau · 2025-08-07T15:41:53Z

/cherrypick enterprise-4.18

dfitzmau · 2025-08-07T15:41:58Z

/cherrypick enterprise-4.17

openshift-cherrypick-robot · 2025-08-07T15:42:36Z

@dfitzmau: #97038 failed to apply on top of branch "enterprise-4.18":

Applying: OSDOCS 15615 Clarity on bootimage changes on AWS and GCP
.git/rebase-apply/patch:17: trailing whitespace.
To view the current boot image used in your cluster, examine a machine set. 
.git/rebase-apply/patch:22: trailing whitespace.
The location and format of the boot image within the machine set differs, based on the platform. However, the boot image is always listed in the `spec.template.spec.providerSpec.` parameter. 
.git/rebase-apply/patch:155: trailing whitespace.
* Get the boot image version by running the following command. The location and format of the boot image within the machine set differs, based on the platform. However, the boot image is always listed in the `spec.template.spec.providerSpec.` parameter. 
warning: 3 lines add whitespace errors.
Using index info to reconstruct a base tree...
A	modules/mco-update-boot-images-about.adoc
M	modules/mco-update-boot-images-configuring.adoc
M	modules/mco-update-boot-images-disable.adoc
A	snippets/mco-update-boot-images-verification.adoc
Falling back to patching base and 3-way merge...
CONFLICT (modify/delete): snippets/mco-update-boot-images-verification.adoc deleted in HEAD and modified in OSDOCS 15615 Clarity on bootimage changes on AWS and GCP. Version OSDOCS 15615 Clarity on bootimage changes on AWS and GCP of snippets/mco-update-boot-images-verification.adoc left in tree.
Auto-merging modules/mco-update-boot-images-disable.adoc
CONFLICT (content): Merge conflict in modules/mco-update-boot-images-disable.adoc
Auto-merging modules/mco-update-boot-images-configuring.adoc
CONFLICT (content): Merge conflict in modules/mco-update-boot-images-configuring.adoc
CONFLICT (modify/delete): modules/mco-update-boot-images-about.adoc deleted in HEAD and modified in OSDOCS 15615 Clarity on bootimage changes on AWS and GCP. Version OSDOCS 15615 Clarity on bootimage changes on AWS and GCP of modules/mco-update-boot-images-about.adoc left in tree.
error: Failed to merge in the changes.
hint: Use 'git am --show-current-patch=diff' to see the failed patch
hint: When you have resolved this problem, run "git am --continue".
hint: If you prefer to skip this patch, run "git am --skip" instead.
hint: To restore the original branch and stop patching, run "git am --abort".
hint: Disable this message with "git config advice.mergeConflict false"
Patch failed at 0001 OSDOCS 15615 Clarity on bootimage changes on AWS and GCP

Details

In response to this:

/cherrypick enterprise-4.18

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.

openshift-cherrypick-robot · 2025-08-07T15:42:41Z

@dfitzmau: #97038 failed to apply on top of branch "enterprise-4.17":

Applying: OSDOCS 15615 Clarity on bootimage changes on AWS and GCP
.git/rebase-apply/patch:17: trailing whitespace.
To view the current boot image used in your cluster, examine a machine set. 
.git/rebase-apply/patch:22: trailing whitespace.
The location and format of the boot image within the machine set differs, based on the platform. However, the boot image is always listed in the `spec.template.spec.providerSpec.` parameter. 
.git/rebase-apply/patch:155: trailing whitespace.
* Get the boot image version by running the following command. The location and format of the boot image within the machine set differs, based on the platform. However, the boot image is always listed in the `spec.template.spec.providerSpec.` parameter. 
warning: 3 lines add whitespace errors.
Using index info to reconstruct a base tree...
A	modules/mco-update-boot-images-about.adoc
M	modules/mco-update-boot-images-configuring.adoc
M	modules/mco-update-boot-images-disable.adoc
A	snippets/mco-update-boot-images-verification.adoc
Falling back to patching base and 3-way merge...
CONFLICT (modify/delete): snippets/mco-update-boot-images-verification.adoc deleted in HEAD and modified in OSDOCS 15615 Clarity on bootimage changes on AWS and GCP. Version OSDOCS 15615 Clarity on bootimage changes on AWS and GCP of snippets/mco-update-boot-images-verification.adoc left in tree.
Auto-merging modules/mco-update-boot-images-disable.adoc
CONFLICT (content): Merge conflict in modules/mco-update-boot-images-disable.adoc
Auto-merging modules/mco-update-boot-images-configuring.adoc
CONFLICT (content): Merge conflict in modules/mco-update-boot-images-configuring.adoc
CONFLICT (modify/delete): modules/mco-update-boot-images-about.adoc deleted in HEAD and modified in OSDOCS 15615 Clarity on bootimage changes on AWS and GCP. Version OSDOCS 15615 Clarity on bootimage changes on AWS and GCP of modules/mco-update-boot-images-about.adoc left in tree.
error: Failed to merge in the changes.
hint: Use 'git am --show-current-patch=diff' to see the failed patch
hint: When you have resolved this problem, run "git am --continue".
hint: If you prefer to skip this patch, run "git am --skip" instead.
hint: To restore the original branch and stop patching, run "git am --abort".
hint: Disable this message with "git config advice.mergeConflict false"
Patch failed at 0001 OSDOCS 15615 Clarity on bootimage changes on AWS and GCP

Details

In response to this:

/cherrypick enterprise-4.17

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.

openshift-cherrypick-robot · 2025-08-07T15:42:43Z

@dfitzmau: new pull request created: #97314

Details

In response to this:

/cherrypick enterprise-4.20

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.

openshift-cherrypick-robot · 2025-08-07T15:42:46Z

@dfitzmau: new pull request created: #97315

Details

In response to this:

/cherrypick enterprise-4.19

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.

mburke5678 added this to the Continuous Release milestone Aug 1, 2025

mburke5678 added branch/enterprise-4.17 branch/enterprise-4.18 branch/enterprise-4.19 branch/enterprise-4.20 labels Aug 1, 2025

openshift-ci bot added the size/L Denotes a PR that changes 100-499 lines, ignoring generated files. label Aug 1, 2025

djoshy reviewed Aug 4, 2025

View reviewed changes

OSDOCS 15615 Clarity on bootimage changes on AWS and GCP

7faca38

mburke5678 force-pushed the mco-boot-image-aws-example branch from 835b836 to 7faca38 Compare August 7, 2025 12:15

mburke5678 added the merge-review-needed Signifies that the merge review team needs to review this PR label Aug 7, 2025

dfitzmau removed the merge-review-needed Signifies that the merge review team needs to review this PR label Aug 7, 2025

dfitzmau reviewed Aug 7, 2025

View reviewed changes

dfitzmau added the merge-review-in-progress Signifies that the merge review team is reviewing this PR label Aug 7, 2025

dfitzmau merged commit 7f527a5 into openshift:main Aug 7, 2025
2 checks passed

openshift-cherrypick-robot mentioned this pull request Aug 7, 2025

[enterprise-4.20] OSDOCS 15615 Clarity on bootimage changes on AWS and GCP #97314

Merged

openshift-cherrypick-robot mentioned this pull request Aug 7, 2025

[enterprise-4.19] OSDOCS 15615 Clarity on bootimage changes on AWS and GCP #97315

Merged

mburke5678 mentioned this pull request Aug 7, 2025

[enterprise-4.17] OSDOCS 15615 Clarity on bootimage changes on AWS and GCP #97326

Merged

mburke5678 mentioned this pull request Aug 7, 2025

[enterprise-4.18] OSDOCS 15615 Clarity on bootimage changes on AWS and GCP #97327

Merged

mburke5678 deleted the mco-boot-image-aws-example branch August 8, 2025 13:19

dfitzmau mentioned this pull request Aug 19, 2025

Update mco-update-boot-images-configuring.adoc to add correct label with "=" instead of ":" #96719

Merged

1 task

	The location and format of the boot image within the machine set differs, based on the platform. However, the boot image is always listed in the `spec.template.spec.providerSpec.` parameter.
	The location and format of the boot image within the machine set differs, based on the platform. However, the boot image is always listed in the `spec.template.spec.providerSpec` parameter.

Conversation

mburke5678 commented Aug 1, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

ocpdocs-previewbot commented Aug 1, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

djoshy Aug 4, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

mburke5678 commented Aug 5, 2025

Uh oh!

ptalgulk01 commented Aug 6, 2025

Uh oh!

djoshy commented Aug 6, 2025

Uh oh!

openshift-ci bot commented Aug 7, 2025

Uh oh!

dfitzmau Aug 7, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

dfitzmau commented Aug 7, 2025

Uh oh!

dfitzmau commented Aug 7, 2025

Uh oh!

dfitzmau commented Aug 7, 2025

Uh oh!

dfitzmau commented Aug 7, 2025

Uh oh!

openshift-cherrypick-robot commented Aug 7, 2025

Uh oh!

openshift-cherrypick-robot commented Aug 7, 2025

Uh oh!

openshift-cherrypick-robot commented Aug 7, 2025

Uh oh!

openshift-cherrypick-robot commented Aug 7, 2025

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

6 participants

mburke5678 commented Aug 1, 2025 •

edited

Loading

ocpdocs-previewbot commented Aug 1, 2025 •

edited

Loading

djoshy Aug 4, 2025 •

edited

Loading

dfitzmau Aug 7, 2025 •

edited

Loading