Skip to content

RHACS 4.11: Document image name change in upgrade docs#113995

Merged
kcarmichael08 merged 1 commit into
openshift:rhacs-docs-mainfrom
davdhacs:davdhacs/rhel9-image-name-change
Jun 29, 2026
Merged

RHACS 4.11: Document image name change in upgrade docs#113995
kcarmichael08 merged 1 commit into
openshift:rhacs-docs-mainfrom
davdhacs:davdhacs/rhel9-image-name-change

Conversation

@davdhacs

@davdhacs davdhacs commented Jun 23, 2026

Copy link
Copy Markdown

Release: 4.11

Jira: none

Previews:

https://113995--ocpdocs-pr.netlify.app/openshift-acs/latest/upgrading/upgrade-helm.html
https://113995--ocpdocs-pr.netlify.app/openshift-acs/latest/upgrading/upgrade-operator.html
https://113995--ocpdocs-pr.netlify.app/openshift-acs/latest/upgrading/upgrade-roxctl.html

Additional information:

Summary

Adds an IMPORTANT admonition to all three upgrade guides (Operator, Helm, roxctl) noting that RHACS 4.11 container image names changed from -rhel8 to -rhel9 as part of the UBI 9 migration.

Users with image mirrors, allowlists, or firewall rules referencing specific image names need to update them before upgrading. This follows the same pattern as the existing PostgreSQL 15 disk space note in the upgrade docs.

Files changed

  • upgrading/upgrade-operator.adoc — added [IMPORTANT] block
  • upgrading/upgrade-helm.adoc — added [IMPORTANT] block
  • upgrading/upgrade-roxctl.adoc — added [IMPORTANT] block

@openshift-ci

openshift-ci Bot commented Jun 23, 2026

Copy link
Copy Markdown

Skipping CI for Draft Pull Request.
If you want CI signal for your change, please convert it to an actual PR.
You can still manually trigger a test run with /test all

@openshift-ci openshift-ci Bot added do-not-merge/work-in-progress Indicates that a PR should not merge because it is a work in progress. size/XS Denotes a PR that changes 0-9 lines, ignoring generated files. size/S Denotes a PR that changes 10-29 lines, ignoring generated files. and removed size/XS Denotes a PR that changes 0-9 lines, ignoring generated files. labels Jun 23, 2026
@davdhacs davdhacs changed the title RHACS 4.11: Add image name change note to UBI 9 migration docs RHACS 4.11: Document image name change in upgrade docs Jun 23, 2026
@davdhacs davdhacs force-pushed the davdhacs/rhel9-image-name-change branch from 6526b96 to 1622538 Compare June 23, 2026 21:11
@davdhacs

Copy link
Copy Markdown
Author

@kcarmichael08 I'm suggesting adding this warning about the rhel8->rhel9 image suffix change because although it was noted it may be a surprise for customers (probably those slower to upgrade) with mirroring or in offline mode.

@davdhacs davdhacs marked this pull request as ready for review June 23, 2026 21:18
@openshift-ci openshift-ci Bot removed the do-not-merge/work-in-progress Indicates that a PR should not merge because it is a work in progress. label Jun 23, 2026
@ocpdocs-previewbot

ocpdocs-previewbot commented Jun 23, 2026

Copy link
Copy Markdown

@davdhacs davdhacs force-pushed the davdhacs/rhel9-image-name-change branch from 1622538 to 4bdcb27 Compare June 24, 2026 16:49
@davdhacs

Copy link
Copy Markdown
Author

/cc @kcarmichael08

@openshift-ci openshift-ci Bot requested a review from kcarmichael08 June 24, 2026 16:50
@kcarmichael08 kcarmichael08 added RHACS Label for RHACS related PRs that go in the rhacs-docs branch rhacs-docs-4.11 Label for PRs that apply to RHACS 4.11 labels Jun 24, 2026

@kcarmichael08 kcarmichael08 left a comment

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.

couple of suggestions but otherwise looks great!

Comment thread upgrading/upgrade-operator.adoc Outdated

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.

We generally can't have 2 admonitions in a row. Since this one applies to 4.8 and Postgres 15, I'm going to say we should remove it as everyone in 4.11+ should already be on this version.

Suggestion: remove lines 12 - 16

Comment thread upgrading/upgrade-roxctl.adoc Outdated

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.

I think we can remove lines 12-18 since it's old (and will remain in prior versions for people who need these instructions - in 4.11 they should not be looking for upgrade info for 4.8). This would solve the problem of having 2 admonitions in a row, as well.

All RHACS container image names changed from -rhel8 to -rhel9 in 4.11
as part of the UBI 9 Minimal migration. Add an IMPORTANT admonition to
the Operator, Helm, and roxctl upgrade guides noting that users with
image mirrors, allowlists, or firewall rules must update them before
upgrading.

Also removes stale PostgreSQL 15 / 4.8 upgrade notes per reviewer
feedback.
@davdhacs davdhacs force-pushed the davdhacs/rhel9-image-name-change branch from 4bdcb27 to 375931e Compare June 26, 2026 22:07
@davdhacs

Copy link
Copy Markdown
Author

/retest

@openshift-ci

openshift-ci Bot commented Jun 26, 2026

Copy link
Copy Markdown

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

@davdhacs davdhacs requested a review from kcarmichael08 June 26, 2026 22:55
@kcarmichael08 kcarmichael08 added the peer-review-done Signifies that the peer review team has reviewed this PR label Jun 29, 2026
@kcarmichael08 kcarmichael08 merged commit e04b9b2 into openshift:rhacs-docs-main Jun 29, 2026
2 checks passed
@kcarmichael08

Copy link
Copy Markdown
Contributor

/cherrypick rhacs-docs-4.11

@openshift-cherrypick-robot

Copy link
Copy Markdown

@kcarmichael08: new pull request created: #114285

Details

In response to this:

/cherrypick rhacs-docs-4.11

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

peer-review-done Signifies that the peer review team has reviewed this PR RHACS Label for RHACS related PRs that go in the rhacs-docs branch rhacs-docs-4.11 Label for PRs that apply to RHACS 4.11 size/S Denotes a PR that changes 10-29 lines, ignoring generated files.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants