|
| 1 | +[id="windows-containers-release-notes-3-x"] |
| 2 | += Windows Container Support for Red Hat OpenShift release notes |
| 3 | +include::modules/common-attributes.adoc[] |
| 4 | +:context: windows-containers-release-notes |
| 5 | + |
| 6 | +toc::[] |
| 7 | + |
| 8 | +[id="about-windows-containers"] |
| 9 | +== About Windows Container Support for Red Hat OpenShift |
| 10 | + |
| 11 | +Windows Container Support for Red Hat OpenShift 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 Windows nodes available, you can run Windows container workloads in {product-title}. |
| 12 | + |
| 13 | +The release notes for Red Hat OpenShift for Windows Containers tracks the development of the WMCO, which provides all Windows container workload capabilities in {product-title}. |
| 14 | + |
| 15 | +[id="getting-support"] |
| 16 | +== Getting support |
| 17 | + |
| 18 | +You must have a subscription to receive support for the Red Hat WMCO. Deploying Windows container workloads in production clusters is not supported without a subscription. If you do not have a subscription, you can use the community WMCO, a distribution that lacks official support. Request support through the link:http://access.redhat.com/[Red Hat Customer Portal]. |
| 19 | + |
| 20 | +[id="wmco-3-0-0"] |
| 21 | +== Release notes for Red Hat Windows Machine Config Operator 3.0.0 |
| 22 | + |
| 23 | +This release of the WMCO provides bug fixes and enhancements for running Windows compute nodes in an {product-title} cluster. The components of the WMCO 3.0.0 were released in link:https://access.redhat.com/errata/RHSA-2021:3001[RHSA-2021:3001-05]. |
| 24 | + |
| 25 | +[IMPORTANT] |
| 26 | +==== |
| 27 | +Users running WMCO 2.0.2 and below must uninstall the operator and reinstall WMCO 3.0.0 to work around a known bug preventing users from upgrading from WMCO 2.0.2 to WMCO 3.0.0. (link:https://bugzilla.redhat.com/show_bug.cgi?id=1983153[*BZ#1983153*]) |
| 28 | +==== |
| 29 | + |
| 30 | +include::modules/wmco-prerequisites.adoc[leveloffset=+1] |
| 31 | + |
| 32 | +[IMPORTANT] |
| 33 | +==== |
| 34 | +Running Windows container workloads is not supported for clusters in a restricted network or disconnected environment. |
| 35 | +==== |
| 36 | + |
| 37 | +Version 3.x of the WMCO is only compatible with {product-title} 4.8. |
| 38 | + |
| 39 | +[id="wmco-3-0-0-improvements"] |
| 40 | +=== New features and improvements |
| 41 | + |
| 42 | +This release adds the following new features and improvements. |
| 43 | + |
| 44 | +// Addresses Github #32620 - https://github.com/openshift/openshift-docs/pull/32620 |
| 45 | +==== Clarified limits on custom VXLAN port selection |
| 46 | + |
| 47 | +Users must not select a custom VXLAN port when using the latest version of Windows server. |
| 48 | + |
| 49 | +[id="wmco-3-0-0-bug-fixes"] |
| 50 | +=== Bug fixes |
| 51 | + |
| 52 | +* Previously, the load balancer service would become unstable when the backing deployment had multiple pods scheduled on different Windows nodes. This issue has been fixed. (link:https://bugzilla.redhat.com/show_bug.cgi?id=1905950[**BZ#1905950**]) |
| 53 | + |
| 54 | +* Previously, WMCO added the public key annotation, `windowsmachineconfig.openshift.io/pub-key-hash`, to Linux nodes. Now, WMCO no longer adds an annotation to Linux nodes. (link:https://bugzilla.redhat.com/show_bug.cgi?id=1930791[**BZ#1930791**]) |
| 55 | + |
| 56 | +* Previously, when users provided an invalid private key, the Windows Machine Config Operator (WMCO) would fail. With this update, the WMCO produces an error alerting the user of an invalid key. (link:https://bugzilla.redhat.com/show_bug.cgi?id=1929579[*BZ#1929579*]) |
| 57 | + |
| 58 | +* Previously, the kube-proxy service would crash upon the creation of a load balancer service when the backing development had multiple pods scheduled on different Windows nodes. This issue has now been fixed. (link:https://bugzilla.redhat.com/show_bug.cgi?id=1939968[**BZ#1939968**]) |
| 59 | + |
| 60 | +* Previously, the `windows_exporter` component reported various metrics as `windows_*`. This error caused some of the node-level metrics that provide insight into the nodes through telemetry services to go unreported. Now, the componets export correctly showing all of the expected metrics. (link:https://bugzilla.redhat.com/show_bug.cgi?id=1948037[**BZ#1948037**]) |
| 61 | + |
| 62 | +=== RHSA-2021:76465-04 - Windows Container support for {product-title} security update |
| 63 | + |
| 64 | +As part of the previously noted bug fix (link:https://bugzilla.redhat.com/show_bug.cgi?id=1946538[**BZ#1946538**]), an update for Windows kube-proxy is now available for Red Hat Windows Machine Config Operator 2.0.1. Details of the update are documented in the link:https://access.redhat.com/errata/RHSA-2021:2130[RHSA-2021:2130] advisory. |
| 65 | + |
| 66 | +[id="wmco-3-0-0-known-issues"] |
| 67 | +=== Known issues |
| 68 | + |
| 69 | +* The filesystem graphs available in the web console do not display for Windows nodes. This is caused by changes in the filesystem queries. This will be fixed in a future release of WMCO. (link:https://bugzilla.redhat.com/show_bug.cgi?id=1930347[*BZ#1930347*]) |
0 commit comments