Goal

Add networking diagram for localnet with trunk / VLAN on br-ex

Background

This diagram request came from Petr Horacek. We will need his help answering these questions:

• How many diagrams are needed for this use case? If multiple diagrams are needed, do all have the same priority or can some be added later?
  • Just one. But other diagrams are related. See the description of DIAGRAMS-510
• Is the documentation where the diagram should be placed already published and only the diagram is missing?

• • OVN localnet documentation https://docs.openshift.com/container-platform/4.17/networking/multiple_networks/configuring-additional-network.html#configuring-additional-network_configuration-additional-network-interface
  • CNV localnet documentation https://docs.openshift.com/container-platform/4.17/virt/vm_networking/virt-connecting-vm-to-ovn-secondary-network.html#virt-creating-layer2-nad-cli_virt-connecting-vm-to-ovn-secondary-network
  • Any future UDN localnet documentation
• If the documentation is not published yet, when is the hard deadline?
  • This request is related to this feature, which is currently targeting OCP 4.18: https://issues.redhat.com/browse/SDN-5313
  • The docs tracker is https://issues.redhat.com/browse/OSDOCS-12356
  • There is also blog content planned: https://docs.google.com/document/d/1okVxHGxRE5y6X-Ld9nJ4pBLx-TfJYSwaTTAAQBY_EqM/edit?tab=t.0
  • 4.19 will "re-release" localnet and having it covered with the diagram would be awesome.
  • Even before that, we already have localnet support in OCP / CNV, so we could benefit from this today
• Are sketches available?
  • Yes, see this source content: https://github.com/dlbewley/demo-virt/blob/new-diag/networking/diagram.md
  •  [phoracek] I'm happy to meet and discuss the diagram, or to simplify it or match your design if needed.
• Does the diagram need to be created from scratch or can we modify an existing one?
  •  [phoracek] The only host network topology diagram in OCP I'm aware of is https://docs.openshift.com/container-platform/4.17/virt/vm_networking/virt-networking-overview.html
• Possible placement:
  • For VMs https://docs.openshift.com/container-platform/4.16/virt/vm_networking/virt-connecting-vm-to-ovn-secondary-network.html#virt-creating-localnet-nad-cli_virt-connecting-vm-to-ovn-secondary-network
  • for everybody: https://docs.openshift.com/container-platform/4.16/networking/multiple_networks/configuring-additional-network.html#configuring-additional-network_configuration-additional-network-interface

Priority

• What is the team's priority for each use case?
  • High. This is one of two main ways of doing networking in OpenShift Virtualization.
• The priority should be in the following order
  DIAGRAMS-510 (now CNV-59622)
  ^^^ this shows what the network config looks like after default installation
  DIAGRAMS-498 (now CNV-59623)
  DIAGRAMS-497 (now CNV-59624)
  ^^^ the two above are common scenarios and show how we want customers to build their host network for localnet