mirror of
https://github.com/openshift/openshift-docs.git
synced 2026-02-05 12:46:18 +01:00
35 lines
2.7 KiB
Plaintext
35 lines
2.7 KiB
Plaintext
//module included in the following assembly:
|
|
//
|
|
// *networking/multiple_networks/understanding-user-defined-networks.adoc
|
|
|
|
:_mod-docs-content-type: CONCEPT
|
|
[id="understanding-multiple-networks-con_{context}"]
|
|
= Multiple networks with the OVN-K CNI
|
|
|
|
[role="_abstract"]
|
|
By default, OVN-Kubernetes serves as the Container Network Interface (CNI) of an {product-title} cluster. This network interface is what administrators use to create default networks.
|
|
|
|
Both user-defined networks and Network Attachment Definitions can serve as the following network types:
|
|
|
|
* *Primary networks*: Act as the primary network for the pod. By default, all traffic passes through the primary network unless you have configured a pod route to send traffic through other networks.
|
|
|
|
* *Secondary networks*: Act as secondary, non-default networks for a pod. Secondary networks offer separate interfaces dedicated to specific traffic types or purposes. Only pod traffic that you explicitly configure to use a secondary network routes through its interface.
|
|
|
|
The following diagram shows a cluster that has an existing default network infrastructure that uses a physical network interface, `eth0`, to connect to two namespaces. Pods or virtual machines (VMs) in one namespace run in isolation from pods or VMs in the other namespace. You can create only one primary network. However, you can create multiple secondary networks for each namespace.
|
|
|
|
.Diagram showing namespaces with multiple secondary UDNs
|
|
image::501_OpenShift_UDN_pri_sec_0925.png[Diagram showing namespaces with multiple secondary UDNs]
|
|
|
|
During cluster installation, {product-title} administrators can configure alternative default secondary pod networks by leveraging the Multus CNI plugin. With Multus, you can use multiple CNI plugins such as ipvlan, macvlan, or Network Attachment Definitions together to serve as secondary networks for pods.
|
|
|
|
[IMPORTANT]
|
|
====
|
|
User-defined networks are only supported when OVN-Kubernetes is used as the CNI. UDNs are not supported for use with other CNIs.
|
|
====
|
|
|
|
You can define an secondary network based on the available CNI plugins and attach one or more of these networks to your pods. You can define more than one secondary network for your cluster depending on your needs. This gives you flexibility when you configure pods that deliver network functionality, such as switching or routing. For more information, see the links in the Additional resources:
|
|
|
|
* For a complete list of supported CNI plugins, see "Secondary networks in {product-title}".
|
|
* For information about user-defined networks, see "About user-defined networks (UDNs)".
|
|
* For information about Network Attachment Definitions, "Creating primary networks by using a NetworkAttachmentDefinition".
|