diff --git a/_topic_maps/_topic_map.yml b/_topic_maps/_topic_map.yml index 4cf0dfcfc4..86e3ab744e 100644 --- a/_topic_maps/_topic_map.yml +++ b/_topic_maps/_topic_map.yml @@ -852,8 +852,8 @@ Topics: File: troubleshooting-s2i - Name: Troubleshooting storage issues File: troubleshooting-storage-issues - - Name: Troubleshooting Windows container workload issues - File: troubleshooting-windows-container-workload-issues +# - Name: Troubleshooting Windows container workload issues +# File: troubleshooting-windows-container-workload-issues - Name: Investigating monitoring issues File: investigating-monitoring-issues - Name: Diagnosing OpenShift CLI (oc) issues @@ -2834,47 +2834,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-17-x - - Name: Past releases - File: windows-containers-release-notes-10-17-x-past - - Name: Windows Machine Config Operator prerequisites - File: windows-containers-release-notes-10-17-x-prereqs - - Name: Windows Machine Config Operator known limitations - File: windows-containers-release-notes-10-17-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: Release notes +# Dir: wmco_rn +# Topics: +# - Name: Red Hat OpenShift support for Windows Containers release notes +# File: windows-containers-release-notes-10-17-x +# - Name: Past releases +# File: windows-containers-release-notes-10-17-x-past +# - Name: Windows Machine Config Operator prerequisites +# File: windows-containers-release-notes-10-17-x-prereqs +# - Name: Windows Machine Config Operator known limitations +# File: windows-containers-release-notes-10-17-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 diff --git a/installing/installing_aws/ipi/installing-aws-network-customizations.adoc b/installing/installing_aws/ipi/installing-aws-network-customizations.adoc index fc3569541f..0e579a1df1 100644 --- a/installing/installing_aws/ipi/installing-aws-network-customizations.adoc +++ b/installing/installing_aws/ipi/installing-aws-network-customizations.adoc @@ -104,10 +104,13 @@ include::modules/nw-aws-nlb-new-cluster.adoc[leveloffset=+1] include::modules/configuring-hybrid-ovnkubernetes.adoc[leveloffset=+1] +//// +Hiding until WMCO 10.18.0 GAs [NOTE] ==== -For more information about using Linux and Windows nodes in the same cluster, see xref:../../../windows_containers/understanding-windows-container-workloads.adoc#understanding-windows-container-workloads[Understanding Windows container workloads]. +For more information about using Linux and Windows nodes in the same cluster, see ../../../windows_containers/understanding-windows-container-workloads.adoc#understanding-windows-container-workloads[Understanding Windows container workloads]. ==== +//// include::modules/installation-launching-installer.adoc[leveloffset=+1] diff --git a/installing/installing_azure/ipi/installing-azure-network-customizations.adoc b/installing/installing_azure/ipi/installing-azure-network-customizations.adoc index 83c9ca6817..6e4d03225a 100644 --- a/installing/installing_azure/ipi/installing-azure-network-customizations.adoc +++ b/installing/installing_azure/ipi/installing-azure-network-customizations.adoc @@ -46,10 +46,13 @@ include::modules/nw-modifying-operator-install-config.adoc[leveloffset=+1] include::modules/nw-operator-cr.adoc[leveloffset=+1] include::modules/configuring-hybrid-ovnkubernetes.adoc[leveloffset=+1] +//// +Hiding until WMCO 10.18.0 GAs [NOTE] ==== -For more information about using Linux and Windows nodes in the same cluster, see xref:../../../windows_containers/understanding-windows-container-workloads.adoc#understanding-windows-container-workloads[Understanding Windows container workloads]. +For more information about using Linux and Windows nodes in the same cluster, see ../../../windows_containers/understanding-windows-container-workloads.adoc#understanding-windows-container-workloads[Understanding Windows container workloads]. ==== +//// [role="_additional-resources"] .Additional resources diff --git a/installing/installing_azure_stack_hub/ipi/installing-azure-stack-hub-network-customizations.adoc b/installing/installing_azure_stack_hub/ipi/installing-azure-stack-hub-network-customizations.adoc index 532b5731b1..eb496de661 100644 --- a/installing/installing_azure_stack_hub/ipi/installing-azure-stack-hub-network-customizations.adoc +++ b/installing/installing_azure_stack_hub/ipi/installing-azure-stack-hub-network-customizations.adoc @@ -50,12 +50,13 @@ include::modules/nw-modifying-operator-install-config.adoc[leveloffset=+1] include::modules/nw-operator-cr.adoc[leveloffset=+1] include::modules/configuring-hybrid-ovnkubernetes.adoc[leveloffset=+1] - +//// +Hiding until WMCO 10.18.0 GAs [NOTE] ==== -For more information about using Linux and Windows nodes in the same cluster, see xref:../../../windows_containers/understanding-windows-container-workloads.adoc#understanding-windows-container-workloads[Understanding Windows container workloads]. +For more information about using Linux and Windows nodes in the same cluster, see ../../../windows_containers/understanding-windows-container-workloads.adoc#understanding-windows-container-workloads[Understanding Windows container workloads]. ==== - +//// include::modules/installation-launching-installer.adoc[leveloffset=+1] diff --git a/installing/overview/installing-preparing.adoc b/installing/overview/installing-preparing.adoc index e2f89ec81f..b34abb4255 100644 --- a/installing/overview/installing-preparing.adoc +++ b/installing/overview/installing-preparing.adoc @@ -116,7 +116,11 @@ For a production cluster, you must configure the following integrations: == Preparing your cluster for workloads Depending on your workload needs, you might need to take extra steps before you begin deploying applications. For example, after you prepare infrastructure to support your application xref:../../cicd/builds/build-strategies.adoc#build-strategies[build strategy], you might need to make provisions for xref:../../scalability_and_performance/cnf-tuning-low-latency-nodes-with-perf-profile.adoc#cnf-low-latency-perf-profile[low-latency] workloads or to xref:../../nodes/pods/nodes-pods-secrets.adoc#nodes-pods-secrets[protect sensitive workloads]. You can also configure xref:../../observability/monitoring/configuring-user-workload-monitoring/preparing-to-configure-the-monitoring-stack-uwm.adoc#enabling-monitoring-for-user-defined-projects-uwm_preparing-to-configure-the-monitoring-stack-uwm[monitoring] for application workloads. -If you plan to run xref:../../windows_containers/enabling-windows-container-workloads.adoc#enabling-windows-container-workloads[Windows workloads], you must enable xref:../../networking/ovn_kubernetes_network_provider/configuring-hybrid-networking.adoc#configuring-hybrid-networking[hybrid networking with OVN-Kubernetes] during the installation process; hybrid networking cannot be enabled after your cluster is installed. + +//// +Hiding until WMCO 10.18.0 GAs +If you plan to run ../../windows_containers/enabling-windows-container-workloads.adoc#enabling-windows-container-workloads[Windows workloads], you must enable xref:../../networking/ovn_kubernetes_network_provider/configuring-hybrid-networking.adoc#configuring-hybrid-networking[hybrid networking with OVN-Kubernetes] during the installation process; hybrid networking cannot be enabled after your cluster is installed. +//// [id="supported-installation-methods-for-different-platforms"] == Supported installation methods for different platforms diff --git a/modules/configuring-hybrid-ovnkubernetes.adoc b/modules/configuring-hybrid-ovnkubernetes.adoc index 7474910f40..7707efad63 100644 --- a/modules/configuring-hybrid-ovnkubernetes.adoc +++ b/modules/configuring-hybrid-ovnkubernetes.adoc @@ -15,14 +15,142 @@ endif::[] You can configure your cluster to use hybrid networking with the OVN-Kubernetes network plugin. This allows a hybrid cluster that supports different node networking configurations. +//// +Hiding until WMCO 10.18.0 GAs [NOTE] ==== This configuration is necessary to run both Linux and Windows nodes in the same cluster. ==== +//// ifndef::post-install[] .Prerequisites +// Made changes to hide Windows-related material until WMCO 4.18.0 releases. Below is the full procedure, commented out. + +* You defined `OVNKubernetes` for the `networking.networkType` parameter in the `install-config.yaml` file. See the installation documentation for configuring {product-title} network customizations on your chosen cloud provider for more information. + +.Procedure + +. Change to the directory that contains the installation program and create the manifests: ++ +[source,terminal] +---- +$ ./openshift-install create manifests --dir +---- ++ +-- +where: + +``:: Specifies the name of the directory that contains the `install-config.yaml` file for your cluster. +-- + +. Create a stub manifest file for the advanced network configuration that is named `cluster-network-03-config.yml` in the `/manifests/` directory: ++ +[source,terminal] +---- +$ cat < /manifests/cluster-network-03-config.yml +apiVersion: operator.openshift.io/v1 +kind: Network +metadata: + name: cluster +spec: +EOF +---- ++ +-- +where: + +``:: Specifies the directory name that contains the +`manifests/` directory for your cluster. +-- + +. Open the `cluster-network-03-config.yml` file in an editor and configure OVN-Kubernetes with hybrid networking, as in the following example: ++ +-- +.Specify a hybrid networking configuration +[source,yaml] +---- +apiVersion: operator.openshift.io/v1 +kind: Network +metadata: + name: cluster +spec: + defaultNetwork: + ovnKubernetesConfig: + hybridOverlayConfig: + hybridClusterNetwork: <1> + - cidr: 10.132.0.0/14 + hostPrefix: 23 +---- +<1> Specify the CIDR configuration used for nodes on the additional overlay network. The `hybridClusterNetwork` CIDR must not overlap with the `clusterNetwork` CIDR. +-- + +. Save the `cluster-network-03-config.yml` file and quit the text editor. +. Optional: Back up the `manifests/cluster-network-03-config.yml` file. The +installation program deletes the `manifests/` directory when creating the +cluster. +endif::post-install[] +ifdef::post-install[] +.Prerequisites + +* Install the OpenShift CLI (`oc`). +* Log in to the cluster as a user with `cluster-admin` privileges. +* Ensure that the cluster uses the OVN-Kubernetes network plugin. + +.Procedure + + +. To configure the OVN-Kubernetes hybrid network overlay, enter the following command: ++ +[source,terminal] +---- +$ oc patch networks.operator.openshift.io cluster --type=merge \ + -p '{ + "spec":{ + "defaultNetwork":{ + "ovnKubernetesConfig":{ + "hybridOverlayConfig":{ + "hybridClusterNetwork":[ + { + "cidr": "", + "hostPrefix": + } + ] + } + } + } + } + }' +---- ++ +-- +where: + +`cidr`:: Specify the CIDR configuration used for nodes on the additional overlay network. This CIDR must not overlap with the cluster network CIDR. +`hostPrefix`:: Specifies the subnet prefix length to assign to each individual node. For example, if `hostPrefix` is set to `23`, then each node is assigned a `/23` subnet out of the given `cidr`, which allows for 510 (2^(32 - 23) - 2) pod IP addresses. If you are required to provide access to nodes from an external network, configure load balancers and routers to manage the traffic. +-- ++ +.Example output +[source,text] +---- +network.operator.openshift.io/cluster patched +---- + +. To confirm that the configuration is active, enter the following command. It can take several minutes for the update to apply. ++ +[source,terminal] +---- +$ oc get network.operator.openshift.io -o jsonpath="{.items[0].spec.defaultNetwork.ovnKubernetesConfig}" +---- + +endif::post-install[] + +//// +Hiding until WMCO 10.18.0 GAs +ifndef::post-install[] +.Prerequisites + * You defined `OVNKubernetes` for the `networking.networkType` parameter in the `install-config.yaml` file. See the installation documentation for configuring {product-title} network customizations on your chosen cloud provider for more information. .Procedure @@ -102,6 +230,7 @@ ifdef::post-install[] .Procedure + . To configure the OVN-Kubernetes hybrid network overlay, enter the following command: + [source,terminal] @@ -157,6 +286,7 @@ Windows Server Long-Term Servicing Channel (LTSC): Windows Server 2019 is not su //// endif::post-install[] +//// ifdef::post-install[] :!post-install: diff --git a/networking/ovn_kubernetes_network_provider/configuring-hybrid-networking.adoc b/networking/ovn_kubernetes_network_provider/configuring-hybrid-networking.adoc index 36343a3456..f49a7a7b8e 100644 --- a/networking/ovn_kubernetes_network_provider/configuring-hybrid-networking.adoc +++ b/networking/ovn_kubernetes_network_provider/configuring-hybrid-networking.adoc @@ -14,7 +14,10 @@ include::modules/configuring-hybrid-ovnkubernetes.adoc[leveloffset=+1] [id="configuring-hybrid-networking-additional-resources"] == Additional resources -* xref:../../windows_containers/understanding-windows-container-workloads.adoc#understanding-windows-container-workloads[Understanding Windows container workloads] -* xref:../../windows_containers/enabling-windows-container-workloads.adoc#enabling-windows-container-workloads[Enabling Windows container workloads] +//// +Hiding until WMCO 10.18.0 GAs +* ../../windows_containers/understanding-windows-container-workloads.adoc#understanding-windows-container-workloads[Understanding Windows container workloads] +* ../../windows_containers/enabling-windows-container-workloads.adoc#enabling-windows-container-workloads[Enabling Windows container workloads] +//// * xref:../../installing/installing_aws/ipi/installing-aws-network-customizations.adoc#installing-aws-network-customizations[Installing a cluster on AWS with network customizations] * xref:../../installing/installing_azure/ipi/installing-azure-network-customizations.adoc#installing-azure-network-customizations[Installing a cluster on Azure with network customizations] diff --git a/release_notes/addtl-release-notes.adoc b/release_notes/addtl-release-notes.adoc index 05cd45a935..5b52611fe0 100644 --- a/release_notes/addtl-release-notes.adoc +++ b/release_notes/addtl-release-notes.adoc @@ -74,12 +74,16 @@ xref:../service_mesh/v2x/servicemesh-release-notes.adoc#service-mesh-release-not {nbsp} + link:https://docs.openshift.com/service-mesh/3.0.0tp1/ossm-release-notes/ossm-release-notes-assembly.html[{SMProductName} 3.x] + {nbsp} + -xref:../windows_containers/wmco_rn/windows-containers-release-notes-10-17-x.adoc#windows-containers-release-notes-10-17-x[{productwinc}] + -{nbsp} + xref:../virt/release_notes/virt-4-18-release-notes.adoc#virt-4-18-release-notes[Red Hat {VirtProductName}] + {nbsp} + 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}] + +{nbsp} + +//// + P:: xref:../observability/power_monitoring/power-monitoring-release-notes.adoc#power-monitoring-release-notes[{PM-title-c}] @@ -89,4 +93,4 @@ xref:../nodes/pods/run_once_duration_override/run-once-duration-override-release S:: xref:../nodes/scheduling/secondary_scheduler/nodes-secondary-scheduler-release-notes.adoc#nodes-secondary-scheduler-release-notes[{secondary-scheduler-operator-full}] + {nbsp} + -xref:../security/security_profiles_operator/spo-release-notes.adoc#spo-release-notes[Security Profiles Operator] \ No newline at end of file +xref:../security/security_profiles_operator/spo-release-notes.adoc#spo-release-notes[Security Profiles Operator] diff --git a/welcome/learn_more_about_openshift.adoc b/welcome/learn_more_about_openshift.adoc index ad96ef77f8..b700b07957 100644 --- a/welcome/learn_more_about_openshift.adoc +++ b/welcome/learn_more_about_openshift.adoc @@ -172,11 +172,14 @@ a|* xref:../networking/networking_operators/cluster-network-operator.adoc#nw-clu | xref:../operators/understanding/olm-understanding-operatorhub.adoc#olm-understanding-operatorhub[Manage Operators] | xref:../operators/user/olm-creating-apps-from-installed-operators.adoc#olm-creating-apps-from-installed-operators[Creating applications from installed Operators] -| xref:../windows_containers/index.adoc#index[{productwinc} overview] -| xref:../windows_containers/understanding-windows-container-workloads.adoc#understanding-windows-container-workloads_understanding-windows-container-workloads[Understanding Windows container workloads] - |=== +//// +Hiding until WMCO 10.18.0 releases, replace as the last row of the above table after WMCO GAs +| xref: ../windows_containers/understanding-windows-container-workloads.adoc#understanding-windows-container-workloads_understanding-windows-container-workloads[Understanding Windows container workloads] +| +//// + [discrete] ==== Changing cluster components diff --git a/windows_containers/index.adoc b/windows_containers/index.adoc index ca8f4f1225..f2ce1808b2 100644 --- a/windows_containers/index.adoc +++ b/windows_containers/index.adoc @@ -6,6 +6,11 @@ include::_attributes/common-attributes.adoc[] toc::[] + +Documentation for {productwinc} is planned to be available for {product-title} {product-version} in the near future. + +//// +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]. 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]. @@ -33,3 +38,4 @@ You can xref:../windows_containers/disabling-windows-container-workloads.adoc#di * Uninstalling the Windows Machine Config Operator * Deleting the Windows Machine Config Operator namespace +////