Skip to content

OSDOCS-19006: Add Azure procedure for migrating x86 control plane to arm64#112335

Open
bshaw7 wants to merge 1 commit into
openshift:enterprise-4.20from
bshaw7:azure-x86-to-arm64-cp-migration-4.20
Open

OSDOCS-19006: Add Azure procedure for migrating x86 control plane to arm64#112335
bshaw7 wants to merge 1 commit into
openshift:enterprise-4.20from
bshaw7:azure-x86-to-arm64-cp-migration-4.20

Conversation

@bshaw7
Copy link
Copy Markdown
Contributor

@bshaw7 bshaw7 commented May 27, 2026

Version(s):
4.20 only

Issue:
OSDOCS-19006

Link to docs preview:
Migrating the x86 control plane to arm64 architecture on Microsoft Azure

QE review:

  • QE has approved this change.

Additional information:
Template added above by @jeana-redhat, original comment 0 below.


OSDOCS-19006

Adds documentation for migrating the control plane from x86 to arm64 architecture on Microsoft Azure.

Azure requires manually creating a shared image gallery image from the arm64 RHCOS VHD before updating the control plane machine set.

Parent feature: OCPSTRAT-3088

Changes

  • New module: modules/migrating-from-x86-to-arm-cp-azure.adoc
  • Updated assembly: updating/updating_a_cluster/migrating-to-multi-payload.adoc

Testing

Procedure verified on OCP 4.20.22 IPI cluster in eastus region (SUPPORTEX-30140).

  • 3 masters migrated from Standard_D8s_v3 (x86) to Standard_D8ps_v6 (arm64)
  • CPMS rollout completed in ~45 minutes
  • All cluster operators Available/Not Degraded after migration

Related

Replaces #112154 (retargeted from main to enterprise-4.20 per guidance)

…arm64

Adds documentation for migrating the control plane from x86 to arm64
architecture on Microsoft Azure. Azure requires manually creating a
shared image gallery image from the arm64 RHCOS VHD before updating
the control plane machine set.

Procedure verified on OCP 4.20.22 IPI cluster.
@openshift-ci-robot openshift-ci-robot added the jira/valid-reference Indicates that this PR references a valid Jira ticket of any type. label May 27, 2026
@openshift-ci openshift-ci Bot added the do-not-merge/work-in-progress Indicates that a PR should not merge because it is a work in progress. label May 27, 2026
@openshift-ci-robot
Copy link
Copy Markdown

openshift-ci-robot commented May 27, 2026

@bshaw7: This pull request references OSDOCS-19006 which is a valid jira issue.

Details

In response to this:

OSDOCS-19006

Adds documentation for migrating the control plane from x86 to arm64 architecture on Microsoft Azure.

Azure requires manually creating a shared image gallery image from the arm64 RHCOS VHD before updating the control plane machine set.

Parent feature: OCPSTRAT-3088

Changes

  • New module: modules/migrating-from-x86-to-arm-cp-azure.adoc
  • Updated assembly: updating/updating_a_cluster/migrating-to-multi-payload.adoc

Testing

Procedure verified on OCP 4.20.22 IPI cluster in eastus region (SUPPORTEX-30140).

  • 3 masters migrated from Standard_D8s_v3 (x86) to Standard_D8ps_v6 (arm64)
  • CPMS rollout completed in ~45 minutes
  • All cluster operators Available/Not Degraded after migration

Related

Replaces #112154 (retargeted from main to enterprise-4.20 per guidance)

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 openshift-eng/jira-lifecycle-plugin repository.

@openshift-ci
Copy link
Copy Markdown

openshift-ci Bot commented May 27, 2026

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 the size/L Denotes a PR that changes 100-499 lines, ignoring generated files. label May 27, 2026
@bshaw7 bshaw7 marked this pull request as ready for review May 27, 2026 15:38
@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 May 27, 2026
@ocpdocs-previewbot
Copy link
Copy Markdown

. Update your image stream from single-architecture to multi-architecture by running the following command:
+
--
include::snippets/update-image-stream-to-multi-arch.adoc[]
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

🤖 [error] AsciiDocDITA.TaskInclude: The included file may introduce content that cannot be mapped to DITA steps.

@openshift-ci
Copy link
Copy Markdown

openshift-ci Bot commented May 27, 2026

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

@jeana-redhat jeana-redhat added merge-review-needed Signifies that the merge review team needs to review this PR branch/enterprise-4.20 and removed merge-review-needed Signifies that the merge review team needs to review this PR labels May 27, 2026
@jeana-redhat jeana-redhat added this to the Continuous Release milestone May 27, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

branch/enterprise-4.20 jira/valid-reference Indicates that this PR references a valid Jira ticket of any type. merge-review-needed Signifies that the merge review team needs to review this PR 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.

5 participants