fabric-network

Instructions

When invoked, generate networking code for FABRIC slices. Determine the user's networking needs:

1. L2 Networks (Bridge, PTP, STS) — Layer 2 Ethernet connectivity
2. L3 FABnet — FABRIC's routed IPv4/IPv6 network across sites
3. FABNetv4Ext — Public IPv4 addresses
4. Facility Ports — External connectivity to campus/provider networks
5. Sub-interfaces/VLANs — VLAN tagging on dedicated NICs
6. Port Mirroring — Traffic capture

Guide users on NIC type selection based on their needs.

Important: Use the modern API pattern for networks:

1. Create the network with slice.add_l2network() or slice.add_l3network()
2. Set interface mode: iface.set_mode('auto')
3. Add interface to network: net.add_interface(iface)
4. For L3 routing: node.add_route(subnet=fablib.FABNETV4_SUBNET, next_hop=net.get_gateway())

API Reference

L2 Network Types

net = slice.add_l2network(
    name: str = None,
    interfaces: list[Interface] = [],  # Can pass here or use net.add_interface() after
    type: str = None,       # "L2Bridge", "L2PTP", "L2STS"
    subnet: ipaddress = None,  # For auto IP assignment
    gateway: ipaddress = None,
    user_data: dict = {},
) -> NetworkService

• L2Bridge: Local Ethernet on a single site, unlimited interfaces
• L2PTP: Point-to-point link between exactly 2 interfaces (can span sites)
• L2STS: Site-to-site link between exactly 2 interfaces on different sites

L3 Network

net = slice.add_l3network(
    name: str = None,
    interfaces: list[Interface] = [],  # Can pass here or use net.add_interface() after
    type: str = "IPv4",     # "IPv4", "IPv6", "IPv4Ext", "IPv6Ext"
    user_data: dict = {},
    technology: str = None,
    subnet: ipaddress.ip_network = None,
    site: str = None,
) -> NetworkService

Network Methods

net.add_interface(iface)           # Add interface to network
net.get_gateway()                   # Get gateway for L3 networks
net.get_interfaces()                # Get all interfaces on network