이 콘텐츠는 선택한 언어로 제공되지 않습니다.

Chapter 8. Windows node updates


You can ensure your Windows nodes have the latest updates by updating the Windows Machine Config Operator (WMCO).

You can update the WMCO in any of the following scenarios:

  • Within the current version. for example, from <10.y.z> to <10.y.z+1>.
  • To a new, contiguous version. For example, from <10.y> to <10.y+1>.
  • From an EUS version to another EUS version by using a Control Plane Only update. For example, from <10.y> to <10.y+2>.

8.1. Windows Machine Config Operator updates

When a new version of the Windows Machine Config Operator (WMCO) is released that is compatible with the current cluster version, the Operator is updated based on the update channel and subscription approval strategy it was installed with when using the Operator Lifecycle Manager (OLM). The WMCO update results in the Kubernetes components in the Windows machine being updated.

Note

If you are updating to a new version of the WMCO and want to use cluster monitoring, you must have the openshift.io/cluster-monitoring=true label present in the WMCO namespace. If you add the label to a pre-existing WMCO namespace, and there are already Windows nodes configured, restart the WMCO pod to allow monitoring graphs to display.

For a non-disruptive update, the WMCO terminates the Windows machines configured by the previous version of the WMCO and recreates them using the current version. This is done by deleting the Machine object, which results in the drain and deletion of the Windows node. To facilitate an update, the WMCO adds a version annotation to all the configured nodes. During an update, a mismatch in version annotation results in the deletion and recreation of a Windows machine. To have minimal service disruptions during an update, the WMCO only updates one Windows machine at a time.

After the update, it is recommended that you set the spec.os.name.windows parameter in your workload pods. The WMCO uses this field to authoritatively identify the pod operating system for validation and is used to enforce Windows-specific pod security context constraints (SCCs).

Important

The WMCO is only responsible for updating Kubernetes components, not for Windows operating system updates. You provide the Windows image when creating the VMs; therefore, you are responsible for providing an updated image. You can provide an updated Windows image by changing the image configuration in the MachineSet spec.

Additional resources

8.2. Windows Machine Config Operator Control Plane Only update

OpenShift Container Platform and Windows Machine Config Operator (WMCO) support updating from one EUS version to another EUS version of OpenShift Container Platform, in a process called a Control Plane Only update. After upgrading the cluster, the Windows nodes are updated from the starting EUS version to the new EUS version while keeping the Windows workloads in a healthy state with no disruptions.

Important

This update was previously known as an EUS-to-EUS update and is now referred to as a Control Plane Only update. These updates are only viable between even-numbered minor versions of OpenShift Container Platform.

8.2.1. WMCO Control Plane Only update by using the web console

You can use the OpenShift Container Platform web console to perform a Control Plane Only update of the Windows Machine Config Operator (WMCO).

Prerequisites

  • The cluster must be running on a supported EUS version of OpenShift Container Platform.
  • All Windows nodes must be in a healthy state.
  • All Windows nodes must be running on the same version of the WMCO.
  • All the of the prerequisites of the Control Plane Only update are met, as described in "Performing a Control Plane Only update."

Procedure

  1. Uninstall WMCO operator by using the following the steps:

    Important

    Delete the Operator only. Do not delete the Windows namespace or any Windows workloads.

    1. Log in to the OpenShift Container Platform web console.
    2. Navigate to Operators OperatorHub.
    3. Use the Filter by keyword box to search for Red Hat Windows Machine Config Operator.
    4. Click the Red Hat Windows Machine Config Operator tile. The Operator tile indicates it is installed.
    5. In the Windows Machine Config Operator descriptor page, click Uninstall.
  2. Update OpenShift Container Platform by following the steps in "Performing a Control Plane Only update."
  3. Install the new WMCO version by following the steps in "Installing the Windows Machine Config Operator using the web console."

8.2.2. WMCO Control Plane Only update by using the CLI

You can use the OpenShift CLI (oc) to perform a Control Plane Only update of the Windows Machine Config Operator (WMCO).

Prerequisites

  • The cluster must be running on a supported EUS version of OpenShift Container Platform.
  • All Windows nodes must be in a healthy state.
  • All Windows nodes must be running on the same version of the WMCO.
  • All the of the prerequisites of the Control Plane Only update are met, as described in "Performing a Control Plane Only update."

Procedure

  1. Uninstall the WMCO Operator from the cluster by following the steps in "Deleting Operators from a cluster using the CLI."

    Important

    Delete the Operator only. Do not delete the Windows namespace or any Windows workloads.

  2. Update OpenShift Container Platform by following the steps in "Performing a Control Plane Only update."
  3. Install the new WMCO version by following the steps in "Installing the Windows Machine Config Operator using the CLI."

Verification

  • On the Verify that the Status shows Succeeded to confirm successful installation of the WMCO.
맨 위로 이동
Red Hat logoGithubredditYoutubeTwitter

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 문서 정보

Red Hat을 사용하는 고객은 신뢰할 수 있는 콘텐츠가 포함된 제품과 서비스를 통해 혁신하고 목표를 달성할 수 있습니다. 최신 업데이트를 확인하세요.

보다 포괄적 수용을 위한 오픈 소스 용어 교체

Red Hat은 코드, 문서, 웹 속성에서 문제가 있는 언어를 교체하기 위해 최선을 다하고 있습니다. 자세한 내용은 다음을 참조하세요.Red Hat 블로그.

Red Hat 소개

Red Hat은 기업이 핵심 데이터 센터에서 네트워크 에지에 이르기까지 플랫폼과 환경 전반에서 더 쉽게 작업할 수 있도록 강화된 솔루션을 제공합니다.

Theme

© 2025 Red Hat, Inc.