You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: modules/configuring-localnet-switched-topology.adoc
+23-8
Original file line number
Diff line number
Diff line change
@@ -16,9 +16,9 @@ The switched `localnet` topology interconnects the workloads created as Network
16
16
// tag::localnet-content[]
17
17
You must map an additional network to the OVN bridge to use it as an OVN-Kubernetes additional network. Bridge mappings allow network traffic to reach the physical network. A bridge mapping associates a physical network name, also known as an interface label, to a bridge created with Open vSwitch (OVS).
18
18
19
-
You can create an `NodeNetworkConfigurationPolicy` object, part of the `nmstate.io/v1` API group, to declaratively create the mapping. This API is provided by the NMState Operator. By using this API you can apply the bridge mapping to nodes that match your specified `nodeSelector` expression, such as `node-role.kubernetes.io/worker: ''`.
19
+
You can create an `NodeNetworkConfigurationPolicy` object, part of the `nmstate.io/v1` API group, to declaratively create the mapping. This API is provided by the NMState Operator. By using this API you can apply the bridge mapping to nodes that match your specified `nodeSelector` expression, such as `node-role.kubernetes.io/worker: ''`. This declarative approach is recommended because the NMState Operator applies additional network configuration to all nodes specified by the node selector automatically and transparently.
20
20
21
-
When attaching an additional network, you can either use the existing `br-ex` bridge or create a new bridge. Which approach to use depends on your specific network infrastructure.
21
+
When attaching an additional network, you can either use the existing `br-ex` bridge or create a new bridge. Which approach to use depends on your specific network infrastructure. Consider the following approaches:
22
22
23
23
- If your nodes include only a single network interface, you must use the existing bridge. This network interface is owned and managed by OVN-Kubernetes and you must not remove it from the `br-ex` bridge or alter the interface configuration. If you remove or alter the network interface, your cluster network will stop working correctly.
24
24
- If your nodes include several network interfaces, you can attach a different network interface to a new bridge, and use that for your additional network. This approach provides for traffic isolation from your primary cluster network.
@@ -47,6 +47,23 @@ spec:
47
47
<3> The name for the additional network from which traffic is forwarded to the OVS bridge. This additional network must match the name of the `spec.config.name` field of the `NetworkAttachmentDefinition` CRD that defines the OVN-Kubernetes additional network.
48
48
<4> The name of the OVS bridge on the node. This value is required only if you specify `state: present`.
49
49
<5> The state for the mapping. Must be either `present` to add the bridge or `absent` to remove the bridge. The default value is `present`.
50
+
+
51
+
The following JSON example configures a localnet, `localnet1`, secondary network:
52
+
+
53
+
[source,json]
54
+
----
55
+
{
56
+
"cniVersion": "0.3.1",
57
+
"name": "ns1-localnet-network",
58
+
"type": "ovn-k8s-cni-overlay",
59
+
"topology":"localnet1",
60
+
"subnets": "202.10.130.112/28",
61
+
"vlanID": 33,
62
+
"mtu": 1500,
63
+
"netAttachDefName": "ns1/localnet-network",
64
+
"excludeSubnets": "10.100.200.0/29"
65
+
}
66
+
----
50
67
51
68
In the following example, the `localnet2` network interface is attached to the `ovs-br1` bridge. Through this attachment, the network interface is available to the OVN-Kubernetes network plugin as an additional network.
52
69
@@ -87,22 +104,20 @@ spec:
87
104
<5> The name for the additional network from which traffic is forwarded to the OVS bridge. This additional network must match the name of the `spec.config.name` field of the `NetworkAttachmentDefinition` CRD that defines the OVN-Kubernetes additional network.
88
105
<6> The name of the OVS bridge on the node. This value is required only if you specify `state: present`.
89
106
<7> The state for the mapping. Must be either `present` to add the bridge or `absent` to remove the bridge. The default value is `present`.
90
-
91
-
This declarative approach is recommended because the NMState Operator applies additional network configuration to all nodes specified by the node selector automatically and transparently.
92
-
107
+
+
93
108
The following JSON example configures a localnet secondary network:
0 commit comments