From df1d1da4a9386631d47cd89cb8b7ceb8090140bb Mon Sep 17 00:00:00 2001 From: Michael Burke Date: Tue, 27 May 2025 16:48:19 -0400 Subject: [PATCH 1/2] WMCO 10.19.0 release notes --- _topic_maps/_topic_map.yml | 8 ++--- release_notes/addtl-release-notes.adoc | 2 +- .../enabling-windows-container-workloads.adoc | 2 +- windows_containers/index.adoc | 2 +- ...dows-containers-release-notes-10-17-x.adoc | 21 ------------ ...rs-release-notes-10-19-x-limitations.adoc} | 4 +-- ...ontainers-release-notes-10-19-x-past.adoc} | 17 +++++----- ...ainers-release-notes-10-19-x-prereqs.adoc} | 12 +++---- ...dows-containers-release-notes-10-19-x.adoc | 33 +++++++++++++++++++ 9 files changed, 56 insertions(+), 45 deletions(-) delete mode 100644 windows_containers/wmco_rn/windows-containers-release-notes-10-17-x.adoc rename windows_containers/wmco_rn/{windows-containers-release-notes-10-17-x-limitations.adoc => windows-containers-release-notes-10-19-x-limitations.adoc} (93%) rename windows_containers/wmco_rn/{windows-containers-release-notes-10-17-x-past.adoc => windows-containers-release-notes-10-19-x-past.adoc} (55%) rename windows_containers/wmco_rn/{windows-containers-release-notes-10-17-x-prereqs.adoc => windows-containers-release-notes-10-19-x-prereqs.adoc} (93%) create mode 100644 windows_containers/wmco_rn/windows-containers-release-notes-10-19-x.adoc diff --git a/_topic_maps/_topic_map.yml b/_topic_maps/_topic_map.yml index ffd1d99699da..ae041fe9ce23 100644 --- a/_topic_maps/_topic_map.yml +++ b/_topic_maps/_topic_map.yml @@ -2902,13 +2902,13 @@ Topics: # Dir: wmco_rn # Topics: # - Name: Red Hat OpenShift support for Windows Containers release notes -# File: windows-containers-release-notes-10-17-x +# File: windows-containers-release-notes-10-19-x # - Name: Past releases -# File: windows-containers-release-notes-10-17-x-past +# File: windows-containers-release-notes-10-19-x-past # - Name: Windows Machine Config Operator prerequisites -# File: windows-containers-release-notes-10-17-x-prereqs +# File: windows-containers-release-notes-10-19-x-prereqs # - Name: Windows Machine Config Operator known limitations -# File: windows-containers-release-notes-10-17-x-limitations +# File: windows-containers-release-notes-10-19-x-limitations #- Name: Getting support # File: windows-containers-support # Distros: openshift-enterprise diff --git a/release_notes/addtl-release-notes.adoc b/release_notes/addtl-release-notes.adoc index 9b3214ff9e0e..39760a8a0c77 100644 --- a/release_notes/addtl-release-notes.adoc +++ b/release_notes/addtl-release-notes.adoc @@ -80,7 +80,7 @@ xref:../observability/otel/otel-rn.adoc#otel-rn[{OTELName}] //// Hiding until -xref:../windows_containers/wmco_rn/windows-containers-release-notes-10-17-x.adoc#windows-containers-release-notes-10-17-x[{productwinc}] + +xref:../windows_containers/wmco_rn/windows-containers-release-notes-10-19-x.adoc#windows-containers-release-notes-10-19-x[{productwinc}] + {nbsp} + //// diff --git a/windows_containers/enabling-windows-container-workloads.adoc b/windows_containers/enabling-windows-container-workloads.adoc index e80d40ae9cfc..e2dedfbf4845 100644 --- a/windows_containers/enabling-windows-container-workloads.adoc +++ b/windows_containers/enabling-windows-container-workloads.adoc @@ -33,7 +33,7 @@ Windows instances deployed by the WMCO are configured with the containerd contai [role="_additional-resources"] .Additional resources -* For the comprehensive prerequisites for the Windows Machine Config Operator, see xref:../windows_containers/wmco_rn/windows-containers-release-notes-10-17-x-prereqs.adoc#windows-containers-release-notes-10-17-x-prereqs[Windows Machine Config Operator prerequisites]. +* For the comprehensive prerequisites for the Windows Machine Config Operator, see xref:../windows_containers/wmco_rn/windows-containers-release-notes-10-19-x-prereqs.adoc#windows-containers-release-notes-10-19-x-prereqs[Windows Machine Config Operator prerequisites]. [id="installing-the-wmco"] == Installing the Windows Machine Config Operator diff --git a/windows_containers/index.adoc b/windows_containers/index.adoc index f2ce1808b2cd..d2802e38d4de 100644 --- a/windows_containers/index.adoc +++ b/windows_containers/index.adoc @@ -11,7 +11,7 @@ Documentation for {productwinc} is planned to be available for {product-title} { //// Hiding until WMCO 10.18.0 GAs -{productwinc} is a feature providing the ability to run Windows compute nodes in an {product-title} cluster. This is possible by using the Red Hat Windows Machine Config Operator (WMCO) to install and manage Windows nodes. With a Red Hat subscription, you can get support for running Windows workloads in {product-title}. Windows instances deployed by the WMCO are configured with the containerd container runtime. For more information, see the xref:../windows_containers/wmco_rn/windows-containers-release-notes-10-17-x.adoc#windows-containers-release-notes-10-17-x[release notes]. +{productwinc} is a feature providing the ability to run Windows compute nodes in an {product-title} cluster. This is possible by using the Red Hat Windows Machine Config Operator (WMCO) to install and manage Windows nodes. With a Red Hat subscription, you can get support for running Windows workloads in {product-title}. Windows instances deployed by the WMCO are configured with the containerd container runtime. For more information, see the xref:../windows_containers/wmco_rn/windows-containers-release-notes-10-19-x.adoc#windows-containers-release-notes-10-19-x[release notes]. You can add Windows nodes either by creating a xref:../windows_containers/creating_windows_machinesets/creating-windows-machineset-aws.adoc#creating-windows-machineset-aws[compute machine set] or by specifying existing Bring-Your-Own-Host (BYOH) Window instances through a xref:../windows_containers/byoh-windows-instance.adoc#byoh-windows-instance[configuration map]. diff --git a/windows_containers/wmco_rn/windows-containers-release-notes-10-17-x.adoc b/windows_containers/wmco_rn/windows-containers-release-notes-10-17-x.adoc deleted file mode 100644 index 7de41cf70a2a..000000000000 --- a/windows_containers/wmco_rn/windows-containers-release-notes-10-17-x.adoc +++ /dev/null @@ -1,21 +0,0 @@ -:_mod-docs-content-type: ASSEMBLY -[id="windows-containers-release-notes-10-17-x"] -= {productwinc} release notes -include::_attributes/common-attributes.adoc[] -:context: windows-containers-release-notes - -toc::[] - - -[id="wmco-10-17-0"] -== Release notes for Red Hat Windows Machine Config Operator 10.17.0 - -This release of the WMCO provides bug fixes for running Windows compute nodes in an {product-title} cluster. The components of the WMCO 10.17.0 were released in - - -[id="wmco-10-17-0-new-features"] -=== New features and improvements - -[id="wmco-10-17-0-bug-fixes"] -=== Bug fixes - diff --git a/windows_containers/wmco_rn/windows-containers-release-notes-10-17-x-limitations.adoc b/windows_containers/wmco_rn/windows-containers-release-notes-10-19-x-limitations.adoc similarity index 93% rename from windows_containers/wmco_rn/windows-containers-release-notes-10-17-x-limitations.adoc rename to windows_containers/wmco_rn/windows-containers-release-notes-10-19-x-limitations.adoc index 49b3087dbe94..b02e128f7f42 100644 --- a/windows_containers/wmco_rn/windows-containers-release-notes-10-17-x-limitations.adoc +++ b/windows_containers/wmco_rn/windows-containers-release-notes-10-19-x-limitations.adoc @@ -1,6 +1,6 @@ :_mod-docs-content-type: ASSEMBLY -:context: windows-containers-release-notes-10-17-x-limitations -[id="windows-containers-release-notes-10-17-x-limitations"] +:context: windows-containers-release-notes-10-19-x-limitations +[id="windows-containers-release-notes-10-19-x-limitations"] = Windows Machine Config Operator known limitations include::_attributes/common-attributes.adoc[] diff --git a/windows_containers/wmco_rn/windows-containers-release-notes-10-17-x-past.adoc b/windows_containers/wmco_rn/windows-containers-release-notes-10-19-x-past.adoc similarity index 55% rename from windows_containers/wmco_rn/windows-containers-release-notes-10-17-x-past.adoc rename to windows_containers/wmco_rn/windows-containers-release-notes-10-19-x-past.adoc index 7366e0d0b0b2..6cb913d7fc4c 100644 --- a/windows_containers/wmco_rn/windows-containers-release-notes-10-17-x-past.adoc +++ b/windows_containers/wmco_rn/windows-containers-release-notes-10-19-x-past.adoc @@ -1,6 +1,6 @@ :_mod-docs-content-type: ASSEMBLY -:context: windows-containers-release-notes-10-17-x-past -[id="windows-containers-release-notes-10-17-x-past"] +:context: windows-containers-release-notes-10-19-x-past +[id="windows-containers-release-notes-10-19-x-past"] = Release notes for past releases of the Windows Machine Config Operator include::_attributes/common-attributes.adoc[] @@ -8,18 +8,17 @@ toc::[] The following release notes are for previous versions of the Windows Machine Config Operator (WMCO). -For the current version, see xref:../../windows_containers/wmco_rn/windows-containers-release-notes-10-17-x.adoc#windows-containers-release-notes-10-17-x[{productwinc} release notes]. +For the current version, see xref:../../windows_containers/wmco_rn/windows-containers-release-notes-10-19-x.adoc#windows-containers-release-notes-10-19-x[{productwinc} release notes]. -[id="wmco-10-17-"] -== Release notes for Red Hat Windows Machine Config Operator 10.17.0 +[id="wmco-10-19-0"] +== Release notes for Red Hat Windows Machine Config Operator 10-19.0 -This release of the WMCO provides bug fixes for running Windows compute nodes in an {product-title} cluster. The components of the WMCO 10.17.0 were released in +This release of the WMCO provides bug fixes for running Windows compute nodes in an {product-title} cluster. The components of the WMCO 10-19.0 were released in - -[id="wmco-10-17-past-new-features"] +[id="wmco-10-19-past-new-features"] === New features and improvements -[id="wmco-10-17-bug-fixes"] +[id="wmco-10-19-bug-fixes"] === Bug fixes diff --git a/windows_containers/wmco_rn/windows-containers-release-notes-10-17-x-prereqs.adoc b/windows_containers/wmco_rn/windows-containers-release-notes-10-19-x-prereqs.adoc similarity index 93% rename from windows_containers/wmco_rn/windows-containers-release-notes-10-17-x-prereqs.adoc rename to windows_containers/wmco_rn/windows-containers-release-notes-10-19-x-prereqs.adoc index 6bbfd20cf5b5..0318aec6da83 100644 --- a/windows_containers/wmco_rn/windows-containers-release-notes-10-17-x-prereqs.adoc +++ b/windows_containers/wmco_rn/windows-containers-release-notes-10-19-x-prereqs.adoc @@ -1,22 +1,22 @@ :_mod-docs-content-type: ASSEMBLY -:context: windows-containers-release-notes-10-17-x-prereqs -[id="windows-containers-release-notes-10-17-x-prereqs"] +:context: windows-containers-release-notes-10-19-x-prereqs +[id="windows-containers-release-notes-10-19-x-prereqs"] = Windows Machine Config Operator prerequisites include::_attributes/common-attributes.adoc[] The following information details the supported platform versions, Windows Server versions, and networking configurations for the Windows Machine Config Operator (WMCO). See the vSphere documentation for any information that is relevant to only that platform. -[id="wmco-prerequisites-supported-install-10.17.0_{context}"] +[id="wmco-prerequisites-supported-install-10-19.0_{context}"] == WMCO supported installation method The WMCO fully supports installing Windows nodes into installer-provisioned infrastructure (IPI) clusters. This is the preferred {product-title} installation method. For user-provisioned infrastructure (UPI) clusters, the WMCO supports installing Windows nodes only into a UPI cluster installed with the `platform: none` field set in the `install-config.yaml` file (bare-metal or provider-agnostic) and only for the xref:../../windows_containers/byoh-windows-instance.adoc#byoh-windows-instance[BYOH (Bring Your Own Host)] use case. UPI is not supported for any other platform. -[id="wmco-prerequisites-supported-10.17.0_{context}"] -== WMCO 10.17.0 supported platforms and Windows Server versions +[id="wmco-prerequisites-supported-10-19.0_{context}"] +== WMCO 10-19.0 supported platforms and Windows Server versions -The following table lists the link:https://docs.microsoft.com/en-us/windows/release-health/windows-server-release-info[Windows Server versions] that are supported by WMCO 10.17.0, based on the applicable platform. Windows Server versions not listed are not supported and attempting to use them will cause errors. To prevent these errors, use only an appropriate version for your platform. +The following table lists the link:https://docs.microsoft.com/en-us/windows/release-health/windows-server-release-info[Windows Server versions] that are supported by WMCO 10-19.0, based on the applicable platform. Windows Server versions not listed are not supported and attempting to use them will cause errors. To prevent these errors, use only an appropriate version for your platform. [cols="3,7",options="header"] |=== diff --git a/windows_containers/wmco_rn/windows-containers-release-notes-10-19-x.adoc b/windows_containers/wmco_rn/windows-containers-release-notes-10-19-x.adoc new file mode 100644 index 000000000000..7e8943f93bd5 --- /dev/null +++ b/windows_containers/wmco_rn/windows-containers-release-notes-10-19-x.adoc @@ -0,0 +1,33 @@ +:_mod-docs-content-type: ASSEMBLY +[id="windows-containers-release-notes-10-19-x"] += {productwinc} release notes +include::_attributes/common-attributes.adoc[] +:context: windows-containers-release-notes + +toc::[] + + +[id="wmco-10-19-0"] +== Release notes for Red Hat Windows Machine Config Operator 10-19.0 + +This release of the WMCO provides bug fixes for running Windows compute nodes in an {product-title} cluster. The components of the WMCO 10-19.0 were released in + + +[id="wmco-10-19-0-new-features"] +=== New features and improvements + +[id="wmco-10-19-0-new-features-debuglogging"] +==== WMCO kubelet configuration changes +// https://github.com/openshift/windows-machine-config-operator/pull/2709 + +With this release, the WMCO now sets the following values in the `KubeletConfig` custom resource (CR): + +* The `system-reserved` parameter is now set to 2GiB of memory for system processes, as recommended in the link:https://kubernetes.io/docs/concepts/configuration/windows-resource-management/#resource-reservation[Kubernetes documentation]. +* The `enforceNodeAllocatable` with a default value of `none`. Previously, the value was set to `[]` to avoid a known issue. Both settings disable the enforcement of node allocatable resource limits. +* The `evictionHard` parameters, `imagefs.available` and `nodefs.available` are now set to `15%` and `10%` respectively, as recommended in the link:https://kubernetes.io/docs/concepts/scheduling-eviction/node-pressure-eviction/#eviction-signals[Kubernetes documentation] + +The `KubeletConfig` object configures the kubelet service, which runs on each node in the cluster to ensure that containers in a pod are running. + +[id="wmco-10-19-0-bug-fixes"] +=== Bug fixes + From 00b4a96632d11b6409f8e22b956b5e49a00a1be6 Mon Sep 17 00:00:00 2001 From: Michael Burke Date: Thu, 29 May 2025 17:11:39 -0400 Subject: [PATCH 2/2] updated topic map --- _topic_maps/_topic_map.yml | 78 +++++++++++++++++++------------------- 1 file changed, 39 insertions(+), 39 deletions(-) diff --git a/_topic_maps/_topic_map.yml b/_topic_maps/_topic_map.yml index ae041fe9ce23..e1eab93e530f 100644 --- a/_topic_maps/_topic_map.yml +++ b/_topic_maps/_topic_map.yml @@ -2898,47 +2898,47 @@ Distros: openshift-origin,openshift-enterprise Topics: - Name: Red Hat OpenShift support for Windows Containers overview File: index -#- Name: Release notes -# Dir: wmco_rn -# Topics: -# - Name: Red Hat OpenShift support for Windows Containers release notes -# File: windows-containers-release-notes-10-19-x +- Name: Release notes + Dir: wmco_rn + Topics: + - Name: Red Hat OpenShift support for Windows Containers release notes + File: windows-containers-release-notes-10-19-x # - Name: Past releases # File: windows-containers-release-notes-10-19-x-past -# - Name: Windows Machine Config Operator prerequisites -# File: windows-containers-release-notes-10-19-x-prereqs -# - Name: Windows Machine Config Operator known limitations -# File: windows-containers-release-notes-10-19-x-limitations -#- Name: Getting support -# File: windows-containers-support -# Distros: openshift-enterprise -#- Name: Understanding Windows container workloads -# File: understanding-windows-container-workloads -#- Name: Enabling Windows container workloads -# File: enabling-windows-container-workloads -#- Name: Creating Windows machine sets -# Dir: creating_windows_machinesets -# Topics: -# - Name: Creating a Windows machine set on AWS -# File: creating-windows-machineset-aws -# - Name: Creating a Windows machine set on Azure -# File: creating-windows-machineset-azure -# - Name: Creating a Windows machine set on GCP -# File: creating-windows-machineset-gcp -# - Name: Creating a Windows machine set on Nutanix -# File: creating-windows-machineset-nutanix -# - Name: Creating a Windows machine set on vSphere -# File: creating-windows-machineset-vsphere -#- Name: Scheduling Windows container workloads -# File: scheduling-windows-workloads -#- Name: Windows node updates -# File: windows-node-upgrades -#- Name: Using Bring-Your-Own-Host Windows instances as nodes -# File: byoh-windows-instance -#- Name: Removing Windows nodes -# File: removing-windows-nodes -#- Name: Disabling Windows container workloads -# File: disabling-windows-container-workloads + - Name: Windows Machine Config Operator prerequisites + File: windows-containers-release-notes-10-19-x-prereqs + - Name: Windows Machine Config Operator known limitations + File: windows-containers-release-notes-10-19-x-limitations +- Name: Getting support + File: windows-containers-support + Distros: openshift-enterprise +- Name: Understanding Windows container workloads + File: understanding-windows-container-workloads +- Name: Enabling Windows container workloads + File: enabling-windows-container-workloads +- Name: Creating Windows machine sets + Dir: creating_windows_machinesets + Topics: + - Name: Creating a Windows machine set on AWS + File: creating-windows-machineset-aws + - Name: Creating a Windows machine set on Azure + File: creating-windows-machineset-azure + - Name: Creating a Windows machine set on GCP + File: creating-windows-machineset-gcp + - Name: Creating a Windows machine set on Nutanix + File: creating-windows-machineset-nutanix + - Name: Creating a Windows machine set on vSphere + File: creating-windows-machineset-vsphere +- Name: Scheduling Windows container workloads + File: scheduling-windows-workloads +- Name: Windows node updates + File: windows-node-upgrades +- Name: Using Bring-Your-Own-Host Windows instances as nodes + File: byoh-windows-instance +- Name: Removing Windows nodes + File: removing-windows-nodes +- Name: Disabling Windows container workloads + File: disabling-windows-container-workloads --- Name: OpenShift sandboxed containers Dir: sandboxed_containers