Skip to content

docs: Clarify how NICo provides tenant-network addressing and intra-VPC connectivity (routed L3 overlay) #2442

@benhuntley

Description

@benhuntley

How would you describe the priority of this documentation request

Medium

Describe the future/missing documentation

What to clarify: The Network Prerequisites → "Tenant Networks" section documents the /31-per-interface allocation, but doesn't explain how NICo actually delivers connectivity: that a tenant network is a routed L3 overlay, and how instances reach one another across it. Adding this makes the existing /31 detail make sense and sets correct expectations for ISVs building on NICo.

How NICo does it (to document):

  • Each instance interface gets a /31 point-to-point link to its DPU; the instance is advertised to the VPC as a /32 host route over the VXLAN/EVPN overlay.
  • DPUs are the VTEPs and interconnect over the overlay, so any instance reaches any other by routing — instances are routable but not L2-adjacent and don't share a flat subnet.
  • Implication for ISVs: treat the VPC as a routed network (run the CNI in routed/overlay mode), don't assume L2 adjacency. (Surfaced when SpectroCloud's K8s cluster-formation assumed flat L2.)

Existing page: https://docs.nvidia.com/infra-controller/documentation/getting-started/prerequisites/network

Code of Conduct

  • I agree to follow this project's Code of Conduct

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type
    No fields configured for issues without a type.

    Projects

    Status
    Triage

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions