Skip to content

OSDOCS 18143 Document how the boot image skew enforcement feature works#108103

Merged
mburke5678 merged 1 commit intoopenshift:mainfrom
mburke5678:mco-skew-mgmt
Apr 30, 2026
Merged

OSDOCS 18143 Document how the boot image skew enforcement feature works#108103
mburke5678 merged 1 commit intoopenshift:mainfrom
mburke5678:mco-skew-mgmt

Conversation

@mburke5678
Copy link
Copy Markdown
Contributor

@mburke5678 mburke5678 commented Mar 9, 2026

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

Link to docs preview:
Boot image skew enforcement -- New module and assemblies
Boot image management -> Enabling boot image management -- Added 4th paragraph, updated TP prereq (for some reason), updated the call out text (for some other reason).
Boot image management -> Disabling boot image management -- Added 4th paragraph.

QE review:

  • QE has approved this change.

@mburke5678 mburke5678 added this to the Planned for 4.22 GA milestone Mar 9, 2026
@openshift-ci openshift-ci Bot added the size/L Denotes a PR that changes 100-499 lines, ignoring generated files. label Mar 9, 2026
Comment thread modules/mco-update-boot-images-manual.adoc Outdated
Comment thread modules/mco-update-boot-images-manual.adoc Outdated
@openshift openshift deleted a comment from ocpdocs-vale-bot Mar 13, 2026
Comment thread machine_configuration/mco-update-boot-images.adoc Outdated
@openshift openshift deleted a comment from ocpdocs-vale-bot Mar 14, 2026
@openshift-ci openshift-ci Bot added needs-rebase Indicates a PR cannot be merged because it has merge conflicts with HEAD. and removed needs-rebase Indicates a PR cannot be merged because it has merge conflicts with HEAD. labels Mar 20, 2026
Comment thread modules/mco-update-boot-skew-mgmt-configuring.adoc Outdated
@mburke5678
Copy link
Copy Markdown
Contributor Author

@djoshy Can you PTAL

Comment thread modules/mco-update-boot-images-configuring.adoc Outdated
Comment thread machine_configuration/mco-update-boot-skew-mgmt.adoc Outdated
Comment thread modules/mco-update-boot-images-configuring.adoc Outdated
Comment thread machine_configuration/mco-update-boot-skew-mgmt.adoc Outdated
Comment thread modules/mco-update-boot-skew-mgmt-about.adoc Outdated
Comment thread modules/mco-update-boot-skew-mgmt-configuring.adoc Outdated
Comment thread modules/mco-update-boot-skew-mgmt-configuring.adoc
Comment thread modules/mco-update-boot-skew-mgmt-configuring.adoc Outdated
Comment thread modules/mco-update-boot-skew-mgmt-updating.adoc Outdated
Comment thread modules/mco-update-boot-skew-mgmt-updating.adoc Outdated
Comment thread modules/mco-update-boot-skew-mgmt-about.adoc Outdated
Comment thread modules/mco-update-boot-skew-mgmt-about.adoc Outdated
Comment thread modules/mco-update-boot-skew-mgmt-about.adoc Outdated
Comment thread modules/mco-update-boot-skew-mgmt-about.adoc Outdated
Comment thread modules/mco-update-boot-skew-mgmt-about.adoc Outdated
Comment thread modules/mco-update-boot-skew-mgmt-about.adoc Outdated
@mburke5678
Copy link
Copy Markdown
Contributor Author

@ptalgulk01

Comment thread modules/mco-update-boot-skew-mgmt-about.adoc Outdated
Comment thread modules/mco-update-boot-skew-mgmt-configuring.adoc Outdated
Comment thread modules/mco-update-boot-skew-mgmt-configuring.adoc Outdated
Comment thread modules/mco-update-boot-skew-mgmt-about.adoc Outdated
Comment thread modules/mco-update-boot-skew-mgmt-updating.adoc Outdated
Comment thread modules/mco-update-boot-skew-mgmt-updating.adoc Outdated
+
[source,terminal]
----
$ openshift-install version
Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Could we do like a note here:

Please use the same openshift-install binary that provided the updated boot image during the manual update process.

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.

outdated

Comment thread modules/mco-update-boot-skew-mgmt-about.adoc Outdated
@mburke5678 mburke5678 changed the title OSDOCS 18143 Document how the boot image skew management feature works OSDOCS 18143 Document how the boot image skew enforcement feature works Apr 1, 2026
@openshift-ci openshift-ci Bot added the needs-rebase Indicates a PR cannot be merged because it has merge conflicts with HEAD. label Apr 1, 2026
@openshift-ci openshift-ci Bot removed the needs-rebase Indicates a PR cannot be merged because it has merge conflicts with HEAD. label Apr 1, 2026
@mburke5678 mburke5678 added the merge-review-needed Signifies that the merge review team needs to review this PR label Apr 1, 2026
Comment thread modules/mco-update-boot-skew-mgmt-updating.adoc Outdated
@maxwelldb maxwelldb added the merge-review-in-progress Signifies that the merge review team is reviewing this PR label Apr 6, 2026
@maxwelldb maxwelldb self-requested a review April 6, 2026 14:45
Copy link
Copy Markdown
Contributor

@maxwelldb maxwelldb left a comment

Choose a reason for hiding this comment

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

/lgtm

Comment thread modules/mco-update-boot-images-disable.adoc Outdated
Comment thread modules/mco-update-boot-skew-mgmt-about.adoc Outdated
@openshift-ci openshift-ci Bot added the lgtm Indicates that a PR is ready to be merged. label Apr 6, 2026
@maxwelldb maxwelldb added ok-to-merge and removed lgtm Indicates that a PR is ready to be merged. 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 Apr 6, 2026
@mburke5678 mburke5678 force-pushed the mco-skew-mgmt branch 2 times, most recently from 3437092 to fe9f114 Compare April 6, 2026 18:30
@openshift-ci openshift-ci Bot added the needs-rebase Indicates a PR cannot be merged because it has merge conflicts with HEAD. label Apr 6, 2026
@openshift-ci openshift-ci Bot removed the needs-rebase Indicates a PR cannot be merged because it has merge conflicts with HEAD. label Apr 6, 2026
@openshift-ci
Copy link
Copy Markdown

openshift-ci Bot commented Apr 6, 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 b12bdc0 into openshift:main Apr 30, 2026
2 checks passed
@mburke5678 mburke5678 deleted the mco-skew-mgmt branch April 30, 2026 11:53
@mburke5678
Copy link
Copy Markdown
Contributor Author

/cherrypick enterprise-4.22

@openshift-cherrypick-robot
Copy link
Copy Markdown

@mburke5678: #108103 failed to apply on top of branch "enterprise-4.22":

Applying: OSDOCS 18143 Document how the boot image skew management feature works
.git/rebase-apply/patch:104: trailing whitespace.
When boot image skew enforcement is active in a cluster, the Machine Config Operator (MCO) examines the boot image version reported in the `MachineConfiguration` object to determine if that boot image is appropriate for the cluster. If the boot image version is too old, the Operator reports that _boot image version skew_ is detected and blocks cluster updates until you manually update the boot image or disable boot image skew enforcement by setting the `None` mode, as described in this section. 
.git/rebase-apply/patch:124: trailing whitespace.
You can configure the current boot image skew enforcement mode that the Machine Config Operator (MCO) uses. By configuring the boot image skew enforcement mode, you can determine if the boot image version in the `MachineConfiguration` object is updated automatically or manually. 
.git/rebase-apply/patch:130: trailing whitespace.
All other platforms default to manual mode with the {product-title} version set as the boot image version in the `MachineConfiguration` object. In manual mode, you are expected to manually update the `MachineConfiguration` object with new boot image version whenever you update the boot image. 
.git/rebase-apply/patch:198: trailing whitespace.
Review the following information to learn about the boot image skew enforcement modes. Use the information to determine the best method for your cluster. 
.git/rebase-apply/patch:202: trailing whitespace.
Automatic:: 
warning: squelched 6 whitespace errors
warning: 11 lines add whitespace errors.
Using index info to reconstruct a base tree...
M	_topic_maps/_topic_map.yml
M	modules/mco-update-boot-images-configuring.adoc
Falling back to patching base and 3-way merge...
Auto-merging modules/mco-update-boot-images-configuring.adoc
CONFLICT (content): Merge conflict in modules/mco-update-boot-images-configuring.adoc
Auto-merging _topic_maps/_topic_map.yml
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 set advice.mergeConflict false"
Patch failed at 0001 OSDOCS 18143 Document how the boot image skew management feature works

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 ok-to-merge 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