Lab Topology Reference¶
The lab topology is described in a YAML file using a dictionary format. The three major components that should be present in every topology file are:
nodes – list of nodes
links – list of links
defaults – describing topology-wide defaults like default device type
Other topology elements include:
provider – virtualization provider (default: libvirt)
groups – optional groups of nodes
module – list of modules used by this network topology
addressing – IPv4 and IPv6 pools used to address management, loopback, LAN, P2P and stub interfaces
name – topology name (used in bridge names)
All elements apart from nodes are optional – missing links element indicates a topology without inter-node links (just the management interfaces)
Default values of defaults and addressing elements are taken from default settings.
List of modules is used to specify additional initial configuration elements (example: OSPF routing)
Default topology name is the directory name.
You’ll find sample topology files in the tutorials.
- Nodes (Network Devices)
- Links between Network Devices
- Groups of Lab Devices (Nodes)
- Topology Address Pools
- Optional Configuration Modules
- Custom Plugins
- Topology Defaults