Skip to content

Commit 58c2d87

Browse files
authored
Revert "WMCO hiding 4.18.0 docs"
1 parent 68e0d4b commit 58c2d87

File tree

10 files changed

+60
-207
lines changed

10 files changed

+60
-207
lines changed

_topic_maps/_topic_map.yml

+43-43
Original file line numberDiff line numberDiff line change
@@ -859,8 +859,8 @@ Topics:
859859
File: troubleshooting-s2i
860860
- Name: Troubleshooting storage issues
861861
File: troubleshooting-storage-issues
862-
# - Name: Troubleshooting Windows container workload issues
863-
# File: troubleshooting-windows-container-workload-issues
862+
- Name: Troubleshooting Windows container workload issues
863+
File: troubleshooting-windows-container-workload-issues
864864
- Name: Investigating monitoring issues
865865
File: investigating-monitoring-issues
866866
- Name: Diagnosing OpenShift CLI (oc) issues
@@ -2842,47 +2842,47 @@ Distros: openshift-origin,openshift-enterprise
28422842
Topics:
28432843
- Name: Red Hat OpenShift support for Windows Containers overview
28442844
File: index
2845-
#- Name: Release notes
2846-
# Dir: wmco_rn
2847-
# Topics:
2848-
# - Name: Red Hat OpenShift support for Windows Containers release notes
2849-
# File: windows-containers-release-notes-10-17-x
2850-
# - Name: Past releases
2851-
# File: windows-containers-release-notes-10-17-x-past
2852-
# - Name: Windows Machine Config Operator prerequisites
2853-
# File: windows-containers-release-notes-10-17-x-prereqs
2854-
# - Name: Windows Machine Config Operator known limitations
2855-
# File: windows-containers-release-notes-10-17-x-limitations
2856-
#- Name: Getting support
2857-
# File: windows-containers-support
2858-
# Distros: openshift-enterprise
2859-
#- Name: Understanding Windows container workloads
2860-
# File: understanding-windows-container-workloads
2861-
#- Name: Enabling Windows container workloads
2862-
# File: enabling-windows-container-workloads
2863-
#- Name: Creating Windows machine sets
2864-
# Dir: creating_windows_machinesets
2865-
# Topics:
2866-
# - Name: Creating a Windows machine set on AWS
2867-
# File: creating-windows-machineset-aws
2868-
# - Name: Creating a Windows machine set on Azure
2869-
# File: creating-windows-machineset-azure
2870-
# - Name: Creating a Windows machine set on GCP
2871-
# File: creating-windows-machineset-gcp
2872-
# - Name: Creating a Windows machine set on Nutanix
2873-
# File: creating-windows-machineset-nutanix
2874-
# - Name: Creating a Windows machine set on vSphere
2875-
# File: creating-windows-machineset-vsphere
2876-
#- Name: Scheduling Windows container workloads
2877-
# File: scheduling-windows-workloads
2878-
#- Name: Windows node updates
2879-
# File: windows-node-upgrades
2880-
#- Name: Using Bring-Your-Own-Host Windows instances as nodes
2881-
# File: byoh-windows-instance
2882-
#- Name: Removing Windows nodes
2883-
# File: removing-windows-nodes
2884-
#- Name: Disabling Windows container workloads
2885-
# File: disabling-windows-container-workloads
2845+
- Name: Release notes
2846+
Dir: wmco_rn
2847+
Topics:
2848+
- Name: Red Hat OpenShift support for Windows Containers release notes
2849+
File: windows-containers-release-notes-10-17-x
2850+
- Name: Past releases
2851+
File: windows-containers-release-notes-10-17-x-past
2852+
- Name: Windows Machine Config Operator prerequisites
2853+
File: windows-containers-release-notes-10-17-x-prereqs
2854+
- Name: Windows Machine Config Operator known limitations
2855+
File: windows-containers-release-notes-10-17-x-limitations
2856+
- Name: Getting support
2857+
File: windows-containers-support
2858+
Distros: openshift-enterprise
2859+
- Name: Understanding Windows container workloads
2860+
File: understanding-windows-container-workloads
2861+
- Name: Enabling Windows container workloads
2862+
File: enabling-windows-container-workloads
2863+
- Name: Creating Windows machine sets
2864+
Dir: creating_windows_machinesets
2865+
Topics:
2866+
- Name: Creating a Windows machine set on AWS
2867+
File: creating-windows-machineset-aws
2868+
- Name: Creating a Windows machine set on Azure
2869+
File: creating-windows-machineset-azure
2870+
- Name: Creating a Windows machine set on GCP
2871+
File: creating-windows-machineset-gcp
2872+
- Name: Creating a Windows machine set on Nutanix
2873+
File: creating-windows-machineset-nutanix
2874+
- Name: Creating a Windows machine set on vSphere
2875+
File: creating-windows-machineset-vsphere
2876+
- Name: Scheduling Windows container workloads
2877+
File: scheduling-windows-workloads
2878+
- Name: Windows node updates
2879+
File: windows-node-upgrades
2880+
- Name: Using Bring-Your-Own-Host Windows instances as nodes
2881+
File: byoh-windows-instance
2882+
- Name: Removing Windows nodes
2883+
File: removing-windows-nodes
2884+
- Name: Disabling Windows container workloads
2885+
File: disabling-windows-container-workloads
28862886
---
28872887
Name: OpenShift sandboxed containers
28882888
Dir: sandboxed_containers

installing/installing_aws/ipi/installing-aws-network-customizations.adoc

+2-4
Original file line numberDiff line numberDiff line change
@@ -104,13 +104,11 @@ include::modules/nw-aws-nlb-new-cluster.adoc[leveloffset=+1]
104104

105105
include::modules/configuring-hybrid-ovnkubernetes.adoc[leveloffset=+1]
106106

107-
////
108-
Hiding until WMCO 10.18.0 GAs
107+
109108
[NOTE]
110109
====
111-
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].
110+
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].
112111
====
113-
////
114112

115113
include::modules/installation-launching-installer.adoc[leveloffset=+1]
116114

installing/installing_azure/ipi/installing-azure-network-customizations.adoc

+2-4
Original file line numberDiff line numberDiff line change
@@ -46,13 +46,11 @@ include::modules/nw-modifying-operator-install-config.adoc[leveloffset=+1]
4646
include::modules/nw-operator-cr.adoc[leveloffset=+1]
4747
include::modules/configuring-hybrid-ovnkubernetes.adoc[leveloffset=+1]
4848

49-
////
50-
Hiding until WMCO 10.18.0 GAs
49+
5150
[NOTE]
5251
====
53-
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].
52+
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].
5453
====
55-
////
5654

5755
[role="_additional-resources"]
5856
.Additional resources

installing/installing_azure_stack_hub/ipi/installing-azure-stack-hub-network-customizations.adoc

+3-4
Original file line numberDiff line numberDiff line change
@@ -50,13 +50,12 @@ include::modules/nw-modifying-operator-install-config.adoc[leveloffset=+1]
5050
include::modules/nw-operator-cr.adoc[leveloffset=+1]
5151
include::modules/configuring-hybrid-ovnkubernetes.adoc[leveloffset=+1]
5252

53-
////
54-
Hiding until WMCO 10.18.0 GAs
53+
5554
[NOTE]
5655
====
57-
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].
56+
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].
5857
====
59-
////
58+
6059

6160
include::modules/installation-launching-installer.adoc[leveloffset=+1]
6261

installing/overview/installing-preparing.adoc

+1-5
Original file line numberDiff line numberDiff line change
@@ -116,11 +116,7 @@ For a production cluster, you must configure the following integrations:
116116
== Preparing your cluster for workloads
117117

118118
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.
119-
120-
////
121-
Hiding until WMCO 10.18.0 GAs
122-
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.
123-
////
119+
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.
124120

125121
[id="supported-installation-methods-for-different-platforms"]
126122
== Supported installation methods for different platforms

modules/configuring-hybrid-ovnkubernetes.adoc

-130
Original file line numberDiff line numberDiff line change
@@ -15,142 +15,14 @@ endif::[]
1515

1616
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.
1717

18-
////
19-
Hiding until WMCO 10.18.0 GAs
2018
[NOTE]
2119
====
2220
This configuration is necessary to run both Linux and Windows nodes in the same cluster.
2321
====
24-
////
2522

2623
ifndef::post-install[]
2724
.Prerequisites
2825

29-
// Made changes to hide Windows-related material until WMCO 4.18.0 releases. Below is the full procedure, commented out.
30-
31-
* 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.
32-
33-
.Procedure
34-
35-
. Change to the directory that contains the installation program and create the manifests:
36-
+
37-
[source,terminal]
38-
----
39-
$ ./openshift-install create manifests --dir <installation_directory>
40-
----
41-
+
42-
--
43-
where:
44-
45-
`<installation_directory>`:: Specifies the name of the directory that contains the `install-config.yaml` file for your cluster.
46-
--
47-
48-
. Create a stub manifest file for the advanced network configuration that is named `cluster-network-03-config.yml` in the `<installation_directory>/manifests/` directory:
49-
+
50-
[source,terminal]
51-
----
52-
$ cat <<EOF > <installation_directory>/manifests/cluster-network-03-config.yml
53-
apiVersion: operator.openshift.io/v1
54-
kind: Network
55-
metadata:
56-
name: cluster
57-
spec:
58-
EOF
59-
----
60-
+
61-
--
62-
where:
63-
64-
`<installation_directory>`:: Specifies the directory name that contains the
65-
`manifests/` directory for your cluster.
66-
--
67-
68-
. Open the `cluster-network-03-config.yml` file in an editor and configure OVN-Kubernetes with hybrid networking, as in the following example:
69-
+
70-
--
71-
.Specify a hybrid networking configuration
72-
[source,yaml]
73-
----
74-
apiVersion: operator.openshift.io/v1
75-
kind: Network
76-
metadata:
77-
name: cluster
78-
spec:
79-
defaultNetwork:
80-
ovnKubernetesConfig:
81-
hybridOverlayConfig:
82-
hybridClusterNetwork: <1>
83-
- cidr: 10.132.0.0/14
84-
hostPrefix: 23
85-
----
86-
<1> Specify the CIDR configuration used for nodes on the additional overlay network. The `hybridClusterNetwork` CIDR must not overlap with the `clusterNetwork` CIDR.
87-
--
88-
89-
. Save the `cluster-network-03-config.yml` file and quit the text editor.
90-
. Optional: Back up the `manifests/cluster-network-03-config.yml` file. The
91-
installation program deletes the `manifests/` directory when creating the
92-
cluster.
93-
endif::post-install[]
94-
ifdef::post-install[]
95-
.Prerequisites
96-
97-
* Install the OpenShift CLI (`oc`).
98-
* Log in to the cluster as a user with `cluster-admin` privileges.
99-
* Ensure that the cluster uses the OVN-Kubernetes network plugin.
100-
101-
.Procedure
102-
103-
104-
. To configure the OVN-Kubernetes hybrid network overlay, enter the following command:
105-
+
106-
[source,terminal]
107-
----
108-
$ oc patch networks.operator.openshift.io cluster --type=merge \
109-
-p '{
110-
"spec":{
111-
"defaultNetwork":{
112-
"ovnKubernetesConfig":{
113-
"hybridOverlayConfig":{
114-
"hybridClusterNetwork":[
115-
{
116-
"cidr": "<cidr>",
117-
"hostPrefix": <prefix>
118-
}
119-
]
120-
}
121-
}
122-
}
123-
}
124-
}'
125-
----
126-
+
127-
--
128-
where:
129-
130-
`cidr`:: Specify the CIDR configuration used for nodes on the additional overlay network. This CIDR must not overlap with the cluster network CIDR.
131-
`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.
132-
--
133-
+
134-
.Example output
135-
[source,text]
136-
----
137-
network.operator.openshift.io/cluster patched
138-
----
139-
140-
. To confirm that the configuration is active, enter the following command. It can take several minutes for the update to apply.
141-
+
142-
[source,terminal]
143-
----
144-
$ oc get network.operator.openshift.io -o jsonpath="{.items[0].spec.defaultNetwork.ovnKubernetesConfig}"
145-
----
146-
147-
endif::post-install[]
148-
149-
////
150-
Hiding until WMCO 10.18.0 GAs
151-
ifndef::post-install[]
152-
.Prerequisites
153-
15426
* 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.
15527
15628
.Procedure
@@ -230,7 +102,6 @@ ifdef::post-install[]
230102
231103
.Procedure
232104

233-
234105
. To configure the OVN-Kubernetes hybrid network overlay, enter the following command:
235106
+
236107
[source,terminal]
@@ -281,7 +152,6 @@ network.operator.openshift.io/cluster patched
281152
$ oc get network.operator.openshift.io -o jsonpath="{.items[0].spec.defaultNetwork.ovnKubernetesConfig}"
282153
----
283154
endif::post-install[]
284-
////
285155

286156
ifdef::post-install[]
287157
:!post-install:

networking/ovn_kubernetes_network_provider/configuring-hybrid-networking.adoc

+2-5
Original file line numberDiff line numberDiff line change
@@ -14,10 +14,7 @@ include::modules/configuring-hybrid-ovnkubernetes.adoc[leveloffset=+1]
1414
[id="configuring-hybrid-networking-additional-resources"]
1515
== Additional resources
1616

17-
////
18-
Hiding until WMCO 10.18.0 GAs
19-
* ../../windows_containers/understanding-windows-container-workloads.adoc#understanding-windows-container-workloads[Understanding Windows container workloads]
20-
* ../../windows_containers/enabling-windows-container-workloads.adoc#enabling-windows-container-workloads[Enabling Windows container workloads]
21-
////
17+
* xref:../../windows_containers/understanding-windows-container-workloads.adoc#understanding-windows-container-workloads[Understanding Windows container workloads]
18+
* xref:../../windows_containers/enabling-windows-container-workloads.adoc#enabling-windows-container-workloads[Enabling Windows container workloads]
2219
* xref:../../installing/installing_aws/ipi/installing-aws-network-customizations.adoc#installing-aws-network-customizations[Installing a cluster on AWS with network customizations]
2320
* xref:../../installing/installing_azure/ipi/installing-azure-network-customizations.adoc#installing-azure-network-customizations[Installing a cluster on Azure with network customizations]

release_notes/addtl-release-notes.adoc

+1-1
Original file line numberDiff line numberDiff line change
@@ -12,4 +12,4 @@ Purpose: A compilation of links to release notes for additional related componen
1212

1313
Do not add or edit this file here on the `main` branch. Edit the `addtl-release-notes.adoc` file directly in the branch that a change is relevant for. Changes to this file should be added or edited in their own PR, per version branch as needed.
1414

15-
This is because there might be different version compatabilities with OCP, or some components/products/Operators might not be available all for a given OCP version.
15+
This is because there might be different version compatabilities with OCP, or some components/products/Operators might not be available all for a given OCP version.

welcome/learn_more_about_openshift.adoc

+3-6
Original file line numberDiff line numberDiff line change
@@ -172,13 +172,10 @@ a|* xref:../networking/networking_operators/cluster-network-operator.adoc#nw-clu
172172
| xref:../operators/understanding/olm-understanding-operatorhub.adoc#olm-understanding-operatorhub[Manage Operators]
173173
| xref:../operators/user/olm-creating-apps-from-installed-operators.adoc#olm-creating-apps-from-installed-operators[Creating applications from installed Operators]
174174

175-
|===
175+
| xref:../windows_containers/index.adoc#index[{productwinc} overview]
176+
| xref:../windows_containers/understanding-windows-container-workloads.adoc#understanding-windows-container-workloads_understanding-windows-container-workloads[Understanding Windows container workloads]
176177

177-
////
178-
Hiding until WMCO 10.18.0 releases, replace as the last row of the above table after WMCO GAs
179-
| xref: ../windows_containers/understanding-windows-container-workloads.adoc#understanding-windows-container-workloads_understanding-windows-container-workloads[Understanding Windows container workloads]
180-
|
181-
////
178+
|===
182179

183180
[discrete]
184181
==== Changing cluster components

windows_containers/index.adoc

+3-5
Original file line numberDiff line numberDiff line change
@@ -6,11 +6,6 @@ include::_attributes/common-attributes.adoc[]
66

77
toc::[]
88

9-
10-
Documentation for {productwinc} is planned to be available for {product-title} {product-version} in the near future.
11-
12-
////
13-
Hiding until WMCO 10.18.0 GAs
149
{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].
1510

1611
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].
@@ -38,4 +33,7 @@ You can xref:../windows_containers/disabling-windows-container-workloads.adoc#di
3833

3934
* Uninstalling the Windows Machine Config Operator
4035
* Deleting the Windows Machine Config Operator namespace
36+
37+
////
38+
Documentation for {productwinc} will be available for {product-title} {product-version} in the near future.
4139
////

0 commit comments

Comments
 (0)