aci_epg_to_domain: parameter VLAN mode for VMM Domain (DCNE-225)

[alexeim1973]

ISSUE TYPE
enhancement or bug report

COMPONENT NAME
aci_epg_to_domain

ANSIBLE VERSION
v10

SUMMARY
When creating a VMM Domain Association for a EPG, it would be good to have the possibility to configure the VLAN mode as "static" and "dynamic" with default being "dynamic".

Currently this doesn't seem to be possible.

For the module, the name of this parameter could be something like "vlan_mode" and the value is a str.

The policy is configured in ACI via Tenant > Application Profile > EPG > Add VMM domain > VLAN mode [dynamic | static] - see the attached screenshot with APIC GUI.

There is a parameter "encap_mode" in this module with str values of "auto" "vlan" "vxlan" and is used in conjunction with parameter "encap" and in "encap" description it is stated that it can be used with static "encaps_mode". So probably it is a bug report and not an enhancement request. See the atached screenshot from Ansible documentation.

APIC version and APIC Platform

• V 5.2.8e on-prem.

Collection versions

• cisco.aci 2.10.1

Output/ Error message

failed: [10.46.31.51] (item={'epg': 'EPG-FACTORY-176', 'custom_epg_name': 'EPG-FACTORY-176-STATIC', 'encap_mode': 'static', 'encap': 176, 'bd': 'BD-FACTORY-176', 'pref_grp': True, 'dm': 'ACI-VMM-DVS7', 'dm_type': 'vmm', 'vm_provider': 'vmware'}) => {"ansible_loop_var": "item", "changed": false, "item": {"bd": "BD-FACTORY-176", "custom_epg_name": "EPG-FACTORY-176-STATIC", "dm": "ACI-VMM-DVS7", "dm_type": "vmm", "encap": 176, "encap_mode": "static", "epg": "EPG-FACTORY-176", "pref_grp": true, "vm_provider": "vmware"}, "msg": "value of encap_mode must be one of: auto, vlan, vxlan, got: static"}

[akinross]

Hi @alexeim1973,

The value encap_mode is not representing the vlan mode as you point towards in UI. The vlan mode in UI is only a toggle button to be able to set the port encap in UI. With the ansible module you only need to provide the encap if you want the port to be displayed as static in UI. I have removed the bug label for now, please let me know if this answers your question.

[alexeim1973]

Hi @alexeim1973,

The value encap_mode is not representing the vlan mode as you point towards in UI. The vlan mode in UI is only a toggle button to be able to set the port encap in UI. With the ansible module you only need to provide the encap if you want the port to be displayed as static in UI. I have removed the bug label for now, please let me know if this answers your question.

Hello and thanks for looking into this.
My understanding is that VLAN mode static will be used automatically once the encaps parameter is used. Is it correct?

As for the encaps_mode parameter, it is referred to in the encaps documentation as having value "static" , see the screedshot. The encaps documentation should probably be updated.

It should also be updated with the notion that VLAN mode GUI element static will be triggered automatically in case of static VLAN encapsulation in use.

Hope it makes sense.

[akinross]

Hi @alexeim1973,

See above attached PR with the suggested changes, hope this clarifies it for you. Let me know if this is unclear then I am open to suggestions.