Skip to content

OSDOCS Document how to perform boot image updates on marketplace clusters AWS#108736

Merged
mburke5678 merged 1 commit intoopenshift:mainfrom
mburke5678:mco-manual-boot-image-aws
May 8, 2026
Merged

OSDOCS Document how to perform boot image updates on marketplace clusters AWS#108736
mburke5678 merged 1 commit intoopenshift:mainfrom
mburke5678:mco-manual-boot-image-aws

Conversation

@mburke5678
Copy link
Copy Markdown
Contributor

@mburke5678 mburke5678 commented Mar 19, 2026

Incorporate https://gist.github.com/djoshy/d7129328cd186471a5c0965b2bddd408

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

Link to docs preview:
Manually updating the boot image on an AWS cluster -- New module. Final location TBD.

Reviewer: The "Updating the boot image skew enforcement version" module is not available yet. Will add link later.

QE review:

  • QE has approved this change.

@mburke5678 mburke5678 added this to the Planned for 4.22 GA milestone Mar 19, 2026
@openshift-ci openshift-ci Bot added the size/L Denotes a PR that changes 100-499 lines, ignoring generated files. label Mar 19, 2026
@ocpdocs-previewbot
Copy link
Copy Markdown

ocpdocs-previewbot commented Mar 19, 2026

Comment thread modules/mco-update-boot-images-aws.adoc Outdated
Comment thread modules/mco-update-boot-images-aws.adoc Outdated
@mburke5678 mburke5678 changed the title OSDOCS Document how to perform boot image updates on marketplace clusters OSDOCS Document how to perform boot image updates on marketplace clusters AWS Mar 19, 2026
@openshift-ci openshift-ci Bot added the needs-rebase Indicates a PR cannot be merged because it has merge conflicts with HEAD. label Mar 20, 2026
@mburke5678 mburke5678 force-pushed the mco-manual-boot-image-aws branch from 4a5fec7 to 0378257 Compare March 20, 2026 15:02
@openshift-ci openshift-ci Bot removed the needs-rebase Indicates a PR cannot be merged because it has merge conflicts with HEAD. label Mar 20, 2026
@mburke5678
Copy link
Copy Markdown
Contributor Author

@djoshy PTAL

Comment thread modules/mco-update-boot-images-aws.adoc
Comment thread modules/mco-update-boot-images-aws.adoc Outdated
@mburke5678
Copy link
Copy Markdown
Contributor Author

@ptalgulk01 @sergiordlr PTAL

@mburke5678 mburke5678 force-pushed the mco-manual-boot-image-aws branch from 7e31627 to 50ba7b1 Compare March 31, 2026 20:10
@mburke5678
Copy link
Copy Markdown
Contributor Author

@HarshwardhanPatil07 PTAL

Comment thread modules/mco-update-boot-images-aws.adoc Outdated
@@ -0,0 +1,292 @@
// Module included in the following assemblies:
//
// * machine_configuration/mco-update-boot-images.adoc
Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Should be: // * machine_configuration/mco-update-boot-images-manual.adoc

Suggested change
// * machine_configuration/mco-update-boot-images.adoc
// * machine_configuration/mco-update-boot-images-manual.adoc

Comment thread modules/mco-update-boot-images-aws.adoc Outdated

* You have installed the link:https://aws.amazon.com/cli/[{aws-short} CLI].

* You configured an AWS account to host the cluster. For information, see "Configuring an AWS account".
Copy link
Copy Markdown

Choose a reason for hiding this comment

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

can we add the link here for "Configuring an AWS account"?

Suggested change
* You configured an AWS account to host the cluster. For information, see "Configuring an AWS account".
* You configured an AWS account to host the cluster. For more information, see "Configuring an AWS account".

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.

Unfortunately, due to the structure of our docs, we cannot add links to documents at the module/ level, only the assembly/ level.

Comment thread modules/mco-update-boot-images-aws.adoc Outdated
Comment thread modules/mco-update-boot-images-aws.adoc Outdated
Comment thread modules/mco-update-boot-images-aws.adoc
Comment thread modules/mco-update-boot-images-aws.adoc Outdated
.Example output
[source,terminal]
----
9.6.20251212-1
Copy link
Copy Markdown

Choose a reason for hiding this comment

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

I think AMI_ID format is different, can you please check it ones

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.

You seem to be correct. I am going to remove this step, as I don't think it adds anything based on the correct output of the command. Good catch!

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Thank you for looking into it. I did some stuff with AWS few months back and i just noticed it.

@mburke5678 mburke5678 force-pushed the mco-manual-boot-image-aws branch 2 times, most recently from 710c60a to ba4ef2a Compare May 6, 2026 13:44
@mburke5678 mburke5678 added the merge-review-needed Signifies that the merge review team needs to review this PR label May 6, 2026
Copy link
Copy Markdown

@HarshwardhanPatil07 HarshwardhanPatil07 left a comment

Choose a reason for hiding this comment

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

/lgtm

@openshift-ci openshift-ci Bot added the lgtm Indicates that a PR is ready to be merged. label May 7, 2026
@jeana-redhat jeana-redhat added the merge-review-in-progress Signifies that the merge review team is reviewing this PR label May 7, 2026
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.

I won't repeat the things in common with #108868 and #109021

Overall good, and has some out-of-scope architecture things to consider at some point.

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

Comment thread modules/mco-update-boot-images-aws.adoc Outdated

The following procedure, which includes steps to create environment variables that facilitate running the required commands, shows how to identify the correct Amazon Machine Image (AMI) to use as the new boot image and how to modify your compute machine sets to use that image.

The process differs for clusters that use a default {op-system-first} image and clusters that use a custom {op-system-first} image from the {aws-short} Marketplace. The following procedure helps determine which type of image you use.
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
The process differs for clusters that use a default {op-system-first} image and clusters that use a custom {op-system-first} image from the {aws-short} Marketplace. The following procedure helps determine which type of image you use.
The process differs for clusters that use a default {op-system-first} image and clusters that use a custom {op-system} image from the {aws-short} Marketplace. The following procedure helps determine which type of image you use.

Comment thread modules/mco-update-boot-images-aws.adoc Outdated

[NOTE]
====
For clusters that use a default {op-system-first} image, you can configure the cluster to automatically update the boot image each time the cluster is updated. If you are using the following procedure, ensure that automatic boot image updates are disabled and skew enforcement is in manual mode. For more information, see "Boot image management" and "Boot image skew enforcement".
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
For clusters that use a default {op-system-first} image, you can configure the cluster to automatically update the boot image each time the cluster is updated. If you are using the following procedure, ensure that automatic boot image updates are disabled and skew enforcement is in manual mode. For more information, see "Boot image management" and "Boot image skew enforcement".
For clusters that use a default {op-system} image, you can configure the cluster to automatically update the boot image each time the cluster is updated. If you are using the following procedure, ensure that automatic boot image updates are disabled and skew enforcement is in manual mode. For more information, see "Boot image management" and "Boot image skew enforcement".

@openshift-ci openshift-ci Bot removed merge-review-in-progress Signifies that the merge review team is reviewing this PR merge-review-needed Signifies that the merge review team needs to review this PR labels May 7, 2026
@mburke5678 mburke5678 force-pushed the mco-manual-boot-image-aws branch from ba4ef2a to c9bda29 Compare May 8, 2026 12:44
@openshift-ci openshift-ci Bot removed the lgtm Indicates that a PR is ready to be merged. label May 8, 2026
@openshift-ci
Copy link
Copy Markdown

openshift-ci Bot commented May 8, 2026

New changes are detected. LGTM label has been removed.

@mburke5678 mburke5678 force-pushed the mco-manual-boot-image-aws branch from c9bda29 to 25dce91 Compare May 8, 2026 13:00
@mburke5678 mburke5678 force-pushed the mco-manual-boot-image-aws branch from 25dce91 to aa4a172 Compare May 8, 2026 13:29
@openshift-ci
Copy link
Copy Markdown

openshift-ci Bot commented May 8, 2026

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

@mburke5678 mburke5678 merged commit 9901b3d into openshift:main May 8, 2026
2 checks passed
@mburke5678 mburke5678 deleted the mco-manual-boot-image-aws branch May 8, 2026 13:45
@mburke5678
Copy link
Copy Markdown
Contributor Author

/cherrypick enterprise-4.22

@openshift-cherrypick-robot
Copy link
Copy Markdown

@mburke5678: new pull request created: #111439

Details

In response to this:

/cherrypick enterprise-4.22

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.22 size/L Denotes a PR that changes 100-499 lines, ignoring generated files.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

7 participants