OpenShift 4 with MacVLAN and whereabouts

About this tutorial

One of the must important things when transitioning into Micro Services is to make sure we provide a solution for edge scenarios such as Multicast communication or random clients request from a specific scope.
For those type of scenarios (and more) in Openshift 4 we can setup a CNI named “Multus” which enables us to add another interface to our running pod and those connecting it to another network other then OpenShift SDN.

How do it works ?

Basically because Multus is already part of OpenShift 4 we need to take a few simple steps :

  1. setting up the Network Operator
  2. adding the network to the namespace
  3. configuring the pod with another network (we can also set it up to be the only network).

Network Operator

In order to edit and add another network we need to run “oc edit”:

# oc edit cluster

And then add the following values to the spec section :

# cat > cluster-macvlan-network.yaml << EOF
kind: Network
name: cluster
- name : net-test
namespace: test
type: Raw
rawCNIConfig: >-
{ "cniVersion": "0.3.1",
"name": "test",
"type": "macvlan",
"master": "bond0.100",
"ipam": {
"type": "whereabouts",
"range": "",
"exclude": [
"routes": [{"dst": ""}]

My adding the part Above we are creating a new network dedicated for the namespace “test” and we are naming the network “net-test”.

More so we are defining the fact that it is a MacVLAN network and we are using whereabouts as it’s type.

After that comes the interesting part , here we letting the network it’s IP pool and Range and excluding the IP address we do NOT want the whereabouts to attach to one of the pods.

the IP of the default gateway must be in the range of the pool or it will not work (we will configure the default gateway later on in the pod annotation).


In case we want the default gateway to remain on the OpenShiftSDN we can add a “gateway” section and destination routes to use that gateway and for all the other network it will use the OpenShiftSDN :

"ipam": { 
"type": "whereabouts",
"range": "",
"gateway": ""
"routes": [{"dst": ""}]

In our scenario we will not use this option.

Adding the Network

Now let’s save the file we created and apply it :

# oc apply -f cluster-macvlan-network.yaml

Confirm that the CNO created the NetworkAttachmentDefinition CR by running the following command. Replace test with the namespace that you specified when configuring the network attachment. There might be a delay before the CNO creates the CR.

# oc get network-attachment-definitions -n test
net-test 14m

Pod Configuration

For the Last part we need to tell the pod to use additional networks and to use our Multus network as our Default Gateway.

In order to set it up we are going to add the following annotation :

annotations: |-
"name": "net-test",
"namespace": "test",
"default-route": [""]

Once does configuration have been added the Pod will be available in both networks the OpenShiftSDN and the Multus network (net-test).

As you can notice from the configuration the pod will get the default gateway from the Multus Network but will still have access to the services and the other Pods network (in it’s namespace).

If you have any question feel free to responed/ leave a comment.
You can find on linkedin at :
Or twitter at :

That is it !!!

Open Source contributer for the past 15 years