Network configuration reference in os-net-config

[Ella Shulman]

- [X] This doc is inaccurate in this way: ovs_extra doesn't work when setting it under ovs_user_bridge section and only works when setting under the specific members (tested in my env with ovs_dpdk_port member) and doesn't work for ovs_user_bridge as suggested ("All of the Common attributes and Open vSwitch attributes can be used with this type"). not sure if this is an issue with the docs or os-net-config itself but it seems docs doesn't matches the actual behavior. using the following configuration (this is only partial snippet):
- type: ovs_user_bridge
  name: br-dpdk0
  mtu: 9000
  use_dhcp: false
  ovs_extra:
    - set Interface dpdk2 options:n_rxq_desc=2048
    - set Interface dpdk2 options:n_txq_desc=2048
  members:
    - type: ovs_dpdk_port
      rx_queue: 1
      name: dpdk2
      mtu: 9000
      members:
        - type: interface
          name: nic5

- type: ovs_user_bridge
  name: br-dpdk1
  mtu: 9000
  use_dhcp: false
  ovs_extra:
    - set Interface dpdk3 options:n_rxq_desc=2048
    - set Interface dpdk3 options:n_txq_desc=2048
  members:
    - type: ovs_dpdk_port
      rx_queue: 1
      name: dpdk3
      mtu: 9000
      members:
        - type: interface
          name: nic6

os-net-config fails to create br-dpdk0/1 with no apparent error
[root@compute-0 ~]# os-net-config -c /etc/os-net-config/config.yaml -m /etc/os-net-config/mapping.yaml
[root@compute-0 ~]# ip a | grep dpdk
[root@compute-0 ~]#

when changing the configuration to this:
- type: ovs_user_bridge
  name: br-dpdk0
  mtu: 9000
  use_dhcp: false
  members:
    - type: ovs_dpdk_port
      ovs_extra:
        - set Interface dpdk2 options:n_rxq_desc=2048
        - set Interface dpdk2 options:n_txq_desc=2048
      rx_queue: 1
      name: dpdk2
      mtu: 9000
      members:
        - type: interface
          name: nic5

- type: ovs_user_bridge
  name: br-dpdk1
  mtu: 9000
  use_dhcp: false
  members:
    - type: ovs_dpdk_port
      ovs_extra:
        - set Interface dpdk3 options:n_rxq_desc=2048
        - set Interface dpdk3 options:n_txq_desc=2048
      rx_queue: 1
      name: dpdk3
      mtu: 9000
      members:
        - type: interface
          name: nic6

bridges are created successfully and ovs_extra is applied:
[root@compute-0 ~]# os-net-config -c /etc/os-net-config/config.yaml -m /etc/os-net-config/mapping.yaml
[root@compute-0 ~]# ip a | grep dpdk
61: br-dpdk0: <BROADCAST,MULTICAST,PROMISC,UP,LOWER_UP> mtu 9000 qdisc fq_codel state UNKNOWN group default qlen 1000
62: br-dpdk1: <BROADCAST,MULTICAST,PROMISC,UP,LOWER_UP> mtu 9000 qdisc fq_codel state UNKNOWN group default qlen 1000
[root@compute-0 ~]# ovs-vsctl --columns=options list interface dpdk2
options : {dpdk-devargs="0000:82:00.2", n_rxq="1", n_rxq_desc="2048", n_txq_desc="2048"}
[root@compute-0 ~]# ovs-vsctl --columns=options list interface dpdk3
options : {dpdk-devargs="0000:82:00.3", n_rxq="1", n_rxq_desc="2048", n_txq_desc="2048"}

additionally the problem goes silently when not setting it under the ovs_dpdk_port which also seems to be an additional issue IMHO
-----------------------------------
Release: 16.1.0.dev38 on 2021-02-15 20:43:54
SHA: f148994568af57430508463070eb8e13dfc2c910
Source: https://opendev.org/openstack/os-net-config/src/doc/source/config.rst
URL: https://docs.openstack.org/os-net-config/latest/config.html