Goal

Document a recommended network setup for VMs. This should cover the process end to end, from planning and hardware requirements, through definition of the bonding, bridge, UDN, to its use from a VM and IP allocation.

User Stories

• As a user, I want to be given clear guide on best practices and end-to-end solutions for typical setups

Non-Requirements

• <List of things not included in this epic, to alleviate any doubt raised during the grooming process.>

Notes

• This can be either in our docs or in https://validatedpatterns.io/patterns/
• There should be an intro to localnet, what is it good for, what are the best practices (use VLANs)
• The localnet setup has these stages:
  • Once:
    • Planning (NICs, primary network or secondary, DHCP or no, flat network, VLAN trunk configured)
    • Creating bonding and a bridge (depending on the planning, this may be one of two ways, either with the day-1 installer for primary, or knmstate for secondary), defining the bridge mapping
    • Creating the CUDN (clearly explain that IPAM is no an option, and that all the fields set there are there for a reason)
  • Per each namespace:
    • Make sure the namespace has the correct label
  • Per each VM:
    • Connecting to the network
      • Bridge binding to that network
      • UI or YAML
      • Explain that VM is connected only to that one network, no need for Pod network
    • IPAM
      • Explain the options, set by the guest, through cloud init, DHCP
• List caveats
  • No trunk, PVLAN, MAC spoof off
  • To get multiple connections to the same VLAN from a VM, multiple CUDNs must be used