MacVLAN (RDMA Shared)

Use Case

Ethernet fabric with MacVLAN network isolation and a shared RDMA device plugin. Each tenant gets its own MAC address and network namespace; RDMA hardware is shared across pods. Ideal for multi-tenant clusters, microservices, and cloud-native HPC where 10+ pods per node need network segmentation.

Prerequisites

  • Cluster access and operator ownership configured (see Installation).

  • l8k binary on your PATH.

  • Mellanox NICs in Ethernet mode on each node.

Discover

l8k discover --kubeconfig ~/.kube/config \
    --save-cluster-config ./cluster-config.yaml

Generate

l8k generate --user-config ./cluster-config.yaml \
    --fabric ethernet --deployment-type rdma_shared --multirail \
    --save-deployment-files ./deployments

Deploy

l8k deploy --deployment-files ./deployments

Verify

Validate the generated bundle, then inspect the relevant resources:

l8k validate --deployment-files ./deployments --wait 10m

kubectl -n nvidia-network-operator get pods
kubectl get macvlannetwork

See Also