Skip to content

Commit 9d36400

Browse files
EricPonvelleEricPonvelle
committed
OSDOCS#10932: Preliminary work for SDN-to-OVN migration
1 parent 4f6516c commit 9d36400

File tree

6 files changed

+71
-0
lines changed

6 files changed

+71
-0
lines changed

‎_attributes/attributes-openshift-dedicated.adoc

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -17,6 +17,7 @@
1717
:hybrid-console-url: link:https://console.redhat.com[Red Hat Hybrid Cloud Console]
1818
:AWS: Amazon Web Services (AWS)
1919
:GCP: Google Cloud Platform (GCP)
20+
:openshift-networking: Red Hat OpenShift Networking
2021
:product-registry: OpenShift image registry
2122
:kebab: image:kebab.png[title="Options menu"]
2223
:rhq-short: Red Hat Quay

‎_topic_maps/_topic_map_osd.yml

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -814,6 +814,8 @@ Name: Networking
814814
Dir: networking
815815
Distros: openshift-dedicated
816816
Topics:
817+
- Name: About networking
818+
File: about-managed-networking
817819
- Name: Understanding the DNS Operator
818820
File: dns-operator
819821
- Name: Understanding the Ingress Operator
@@ -844,6 +846,11 @@ Topics:
844846
File: deleting-network-policy
845847
- Name: Configuring multitenant isolation with network policy
846848
File: multitenant-network-policy
849+
- Name: OVN-Kubernetes network plugin
850+
Dir: ovn_kubernetes_network_provider
851+
Topics:
852+
- Name: About the OpenShift SDN network plugin
853+
File: about-ovn-kubernetes
847854
- Name: Configuring Routes
848855
Dir: routes
849856
Topics:

‎_topic_maps/_topic_map_rosa.yml

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1068,6 +1068,8 @@ Name: Networking
10681068
Dir: networking
10691069
Distros: openshift-rosa
10701070
Topics:
1071+
- Name: About networking
1072+
File: about-managed-networking
10711073
- Name: Understanding the DNS Operator
10721074
File: dns-operator
10731075
- Name: Understanding the Ingress Operator
@@ -1117,6 +1119,8 @@ Topics:
11171119
- Name: OVN-Kubernetes network plugin
11181120
Dir: ovn_kubernetes_network_provider
11191121
Topics:
1122+
- Name: About the OpenShift SDN network plugin
1123+
File: about-ovn-kubernetes
11201124
- Name: Configuring an egress IP address
11211125
File: configuring-egress-ips-ovn
11221126
- Name: Configuring Routes

‎networking/about-managed-networking.adoc

Lines changed: 22 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,22 @@
1+
:_mod-docs-content-type: ASSEMBLY
2+
[id="about-managed-networking"]
3+
= About networking
4+
include::_attributes/attributes-openshift-dedicated.adoc[]
5+
:context: about-managed-networking
6+
7+
toc::[]
8+
9+
{openshift-networking} is an ecosystem of features, plugins, and advanced networking capabilities that enhance Kubernetes networking with advanced networking-related features that your cluster needs to manage network traffic for one or multiple hybrid clusters. This ecosystem of networking capabilities integrates ingress, egress, load balancing, high-performance throughput, security, and inter- and intra-cluster traffic management. The {openshift-networking} ecosystem also provides role-based observability tooling to reduce its natural complexities.
10+
11+
The following are some of the most commonly used {openshift-networking} features available on your cluster:
12+
13+
- Primary cluster network provided by either of the following Container Network Interface (CNI) plugins:
14+
* xref:../networking/ovn_kubernetes_network_provider/about-ovn-kubernetes.adoc#about-ovn-kubernetes[OVN-Kubernetes network plugin] - the default plugin
15+
* link:https://docs.redhat.com/en/documentation/openshift_container_platform/4.14/html/networking/openshift-sdn-network-plugin#nw-openshift-sdn-modes_about-openshift-sdn[OpenShift SDN network plugin]- deprecated for clusters as of OpenShift 4.14
16+
- Cluster Network Operator for network plugin management
17+
18+
{product-title} clusters created with OpenShift 4.11 and above use OVN-Kubernetes network plugin by default. {product-title} clusters created before OpenShift version 4.11 use the OpenShift SDN plugin after they are upgraded to OpenShift version 4.11 and above.
19+
20+
include::snippets/sdn-deprecation-statement-managed.adoc[]
21+
22+
You will soon be able to migrate from OpenShift SDN to OVN for clusters running on OpenShift version 4.15 and later. This migration tool is not currently available. For more information about the OpenShift SDN deprecation and the OVN migration, see the KCS article about link:https://access.redhat.com/articles/7065170[OpenShift SDN CNI removal in OCP 4.17].

‎networking/ovn_kubernetes_network_provider/about-ovn-kubernetes.adoc

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -43,6 +43,7 @@ include::modules/nw-ovn-kuberentes-limitations.adoc[leveloffset=+1]
4343

4444
include::modules/nw-ovn-kubernetes-session-affinity.adoc[leveloffset=+1]
4545

46+
ifndef::openshift-rosa,openshift-dedicated[]
4647
[role="_additional-resources"]
4748
.Additional resources
4849
@@ -52,3 +53,4 @@ include::modules/nw-ovn-kubernetes-session-affinity.adoc[leveloffset=+1]
5253
* xref:../../networking/ovn_kubernetes_network_provider/enabling-multicast.adoc#nw-ovn-kubernetes-enabling-multicast[Enabling multicast for a project]
5354
* xref:../../networking/network_security/configuring-ipsec-ovn.adoc#configuring-ipsec-ovn[Configuring IPsec encryption]
5455
* xref:../../rest_api/operator_apis/network-operator-openshift-io-v1.adoc#network-operator-openshift-io-v1[Network [operator.openshift.io/v1\]]
56+
endif::openshift-rosa,openshift-dedicated[]

‎snippets/sdn-deprecation-statement-managed.adoc

Lines changed: 35 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,35 @@
1+
// Text snippet included in the following assemblies:
2+
//
3+
// * networking/about-networking.adoc
4+
// * networking/openshift_sdn/assigning-egress-ips.adoc
5+
// * networking/openshift_sdn/editing-egress-firewall.adoc
6+
// * networking/openshift_sdn/enabling-multicast.adoc
7+
// * networking/openshift_sdn/migrate-to-openshift-sdn.adoc
8+
// * networking/openshift_sdn/multitenant-isolation.adoc
9+
// * networking/openshift_sdn/removing-egress-firewall.adoc
10+
// * networking/ovn_kubernetes_network_provider/rollback-to-openshift-sdn.adoc
11+
// * networking/ovn_kubernetes_network_provider/viewing-egress-firewall-ovn.adoc
12+
// * networking/openshift_sdn/about-openshift-sdn.adoc
13+
// * networking/openshift_sdn/rollback-to-ovn-kubernetes.adoc
14+
// * networking/openshift_sdn/configuring-egress-firewall.adoc
15+
//
16+
// Text snippet included in the following modules:
17+
//
18+
// * modules/nw-networking-glossary-terms.adoc
19+
// * modules/nw-ovn-kubernetes-migration-about.adoc
20+
// * modules/optimizing-mtu-networking.adoc
21+
22+
:_mod-docs-content-type: SNIPPET
23+
24+
[IMPORTANT]
25+
====
26+
{product-title} follows the life cycle of SDN according to OpenShift Core Platform:
27+
28+
* SDN is deprecated for clusters as of OpenShift version 4.14.
29+
* Clusters that already use the OpenShift SDN plugin continue to use the plugin after they are upgraded to OpenShift versions 4.11 and above.
30+
* Clusters can be upgraded up to OpenShift version 4.16.
31+
32+
* Clusters running on OpenShift 4.16:
33+
** Clusters using OpenShift version 4.16 cannot upgrade if the clusters are using the SDN plugin.
34+
* The SDN plugin will be discontinued in OpenShift version 4.17.
35+
====

0 commit comments

Comments
 (0)