1
0
mirror of https://github.com/openshift/openshift-docs.git synced 2026-02-05 12:46:18 +01:00

SDN Migration

rosa_release_notes/rosa-release-notes.adoc
This commit is contained in:
mletalie
2025-01-07 17:35:38 -05:00
committed by openshift-cherrypick-robot
parent aca4cde773
commit 032a2c46fa
6 changed files with 84 additions and 6 deletions

View File

@@ -869,6 +869,8 @@ Topics:
File: about-ovn-kubernetes
- Name: Migrating from the OpenShift SDN network plugin
File: migrate-from-openshift-sdn-osd
# - Name: Migrating from the OpenShift SDN network plugin
# File: migrate-from-openshift-sdn
- Name: OpenShift SDN network plugin
Dir: ovn_kubernetes_network_provider
Topics:

View File

@@ -1129,6 +1129,8 @@ Topics:
File: about-ovn-kubernetes
- Name: Configuring an egress IP address
File: configuring-egress-ips-ovn
- Name: Migrating from OpenShift SDN network plugin to OVN-Kubernetes network plugin
File: migrate-from-openshift-sdn
- Name: OpenShift SDN network plugin
Dir: ovn_kubernetes_network_provider
Topics:

View File

@@ -0,0 +1,37 @@
// Module included in the following assemblies:
//networking/ovn_kubernetes_network_provider/migrate-from-openshift-sdn.adoc
:_mod-docs-content-type: PROCEDURE
[id="migrate-sdn-ovn-cli_{context}"]
= Initiate migration using the ROSA CLI
[WARNING]
====
You can only initiate migration on clusters that are version 4.16.24 and above.
====
To initiate the migration, run the following command:
[source,terminal]
----
$ rosa edit cluster -c <cluster_id> <1>
--network-type OVNKubernetes
--ovn-internal-subnets <configuration> <2>
----
<1> Replace `<cluster_id>` with the ID of the cluster you want to migrate to the OVN-Kubernetes network plugin.
<2> Optional: Users can create key-value pairs to configure internal subnets using any or all of the options `join, masquerade, transit` along with a single CIDR per option. For example, `--ovn-internal-subnets="join=0.0.0.0/24,transit=0.0.0.0/24,masquerade=0.0.0.0/24"`.
[IMPORTANT]
====
You cannot include the optional flag `--ovn-internal-subnets` in the command unless you define a value for the flag `--network-type`.
====
:_mod-docs-content-type: PROCEDURE
[id="verify-sdn-ovn_{context}"]
= Verify migration status using the ROSA CLI
To check the status of the migration, run the following command:
[source,terminal]
----
rosa describe cluster -c <cluster_id> <1>
----
<1> Replace `<cluster_id>` with the ID of the cluster to check the migration status.

View File

@@ -16,19 +16,21 @@ The following are some of the most commonly used {openshift-networking} features
+
** xref:../networking/ovn_kubernetes_network_provider/about-ovn-kubernetes.adoc#about-ovn-kubernetes[OVN-Kubernetes network plugin], which is the default CNI plugin.
** {OCP-short} SDN network plugin, which was deprecated in {OCP-short} 4.16 and removed in {OCP-short} 4.17.
+
ifdef::openshift-rosa[]
[IMPORTANT]
====
Before upgrading {product-title} clusters that are configured with the OpenShift SDN network plugin to version 4.17, you must migrate to the OVN-Kubernetes network plugin. For more information, see _Migrating from the OpenShift SDN network plugin to the OVN-Kubernetes network plugin_ in the _Additional resources_ section.
Before upgrading {rosa-classic} clusters that are configured with the OpenShift SDN network plugin to version 4.17, you must migrate to the OVN-Kubernetes network plugin. For more information, see _Migrating from the OpenShift SDN network plugin to the OVN-Kubernetes network plugin_ in the _Additional resources_ section.
====
endif::openshift-rosa[]
[discrete]
[role="_additional-resources"]
[id="additional-resources_{context}"]
== Additional resources
* link:https://access.redhat.com/articles/7065170[{OCP-short} SDN CNI removal in OCP 4.17]
ifdef::openshift-dedicated[]
* xref:../networking/ovn_kubernetes_network_provider/migrate-from-openshift-sdn-osd.adoc#migrate-from-openshift-sdn-osd[Migrating from the OpenShift SDN network plugin to the OVN-Kubernetes network plugin]
endif::openshift-dedicated[]
ifdef::openshift-rosa[]
* xref:../networking/ovn_kubernetes_network_provider/migrate-from-openshift-sdn.adoc#migrate-from-openshift-sdn[Migrating from the OpenShift SDN network plugin to the OVN-Kubernetes network plugin]
endif::openshift-rosa[]

View File

@@ -0,0 +1,30 @@
:_mod-docs-content-type: ASSEMBLY
[id="migrate-from-openshift-sdn"]
= Migrating from OpenShift SDN network plugin to OVN-Kubernetes network plugin
include::_attributes/common-attributes.adoc[]
include::_attributes/attributes-openshift-dedicated.adoc[]
:context: migrate-from-openshift-sdn
toc::[]
As a {rosa-classic-first} cluster administrator, you can initiate the migration from the OpenShift SDN network plugin to the OVN-Kubernetes network plugin and verify the migration status using the ROSA CLI.
Some considerations before starting migration initiation are:
* The cluster version must be 4.16.24 and above.
* The migration process cannot be interrupted.
* Migrating back to the SDN network plugin is not possible.
* Cluster nodes will be rebooted during migration.
* There will be no impact to workloads that are resilient to node disruptions.
* Migration time can vary between several minutes and hours, depending on the cluster size and workload configurations.
include::modules/migrate-sdn-ovn.adoc[leveloffset=+1]

View File

@@ -24,6 +24,11 @@ endif::openshift-rosa-hcp[]
ifdef::openshift-rosa[]
* **{rosa-classic} cluster node limit update.** {rosa-classic} clusters versions 4.14.14 and greater can now scale to 249 worker nodes. This is an increase from the previous limit of 180 nodes. For more information, see xref:../rosa_planning/rosa-limits-scalability.adoc#rosa-limits-scalability[Limits and scalability].
+
// * **{product-title} SDN network plugin blocks future major upgrades**
* **Initiate live migration from OpenShift SDN to OVN-Kubernetes.**
As part of the {product-title} move to OVN-Kubernetes as the only supported network plugin starting with {product-title} 4.17, users can now initiate live migration from the OpenShift SDN network plugin to the OVN-Kubernetes network plugin.
If your cluster uses the OpenShift SDN network plugin, you cannot upgrade to future major versions of {product-title} without migrating to OVN-Kubernetes. For more information about migrating to OVN-Kubernetes, see xref:../networking/ovn_kubernetes_network_provider/migrate-from-openshift-sdn.adoc#migrate-from-openshift-sdn[Migrating from OpenShift SDN network plugin to OVN-Kubernetes network plugin].
[IMPORTANT]
====
Egress lockdown is a Technology Preview feature.