Create an NVIDIA nv-ipam IPPool for SR-IOV Networks

💡 Quick Answer: Create one IPPool in the same namespace as workloads and NAD, set poolType: ippool, and choose a subnet/block size combination that fits your node and pod scale.

nv-ipam allocates addresses from IPPool resources. Namespace and sizing must be consistent with your workload.

Example IPPool

apiVersion: nv-ipam.nvidia.com/v1alpha1
kind: IPPool
metadata:
  name: tenant-a
  namespace: tenant-a
spec:
  poolType: ippool
  subnet: 10.233.215.96/28
  gateway: 10.233.215.97
  perNodeBlockSize: 8

Apply:

oc apply -f ippool.yaml

Validate

oc get ippool -n tenant-a

Sizing Guidance

• /28 has 16 addresses total; use small block sizes.
• perNodeBlockSize must fit available addresses after gateway/network reservations.
• Use larger subnets for larger node counts or high SR-IOV density.

Namespace Rule

Create the pool in the same namespace used by workloads and generated NAD (for example tenant-a).