nd_interface_vpc_trunk_host

[allenrobel]

Related Issue(s)

Proposed Changes

• Adds the nd_interface_vpc_trunk_host module, which manages vPC trunkVpcHost interfaces (template int_vpc_trunk_host) on Cisco Nexus Dashboard.
• Adds TrunkVpcHostPolicyTypeEnum to plugins/module_utils/models/interfaces/enums.py so the model can frozen-pin its policy_type.
• Inherits all CRUD, peer-serial resolution, per-interface DELETE, and query_all dedupe from VpcBaseOrchestrator (introduced in the nd_vpc_pair stack-grandparent PR).

Trunk-specific design (lab-verified on ND 4.2.1):

• Single user-facing allowed_vlans and native_vlan fields fan out to peer1AllowedVlans / peer2AllowedVlans and peer1NativeVlan / peer2NativeVlan at payload-serialization time via a @model_serializer. ND collapses both per-peer pairs back to single allowedVlans / nativeVlan on GET, AND wire-side rejects divergent peer values with HTTP 400 "…should be consistent" — so there is no use case for exposing the per-peer keys. Tagged TODO(4.2.1).
• Adds vlan_mapping and vlan_mapping_entries with shared AllowedVlans / CustomerVlanIdList validators (int→str coercion for the ND single-id echo, 1–4094 bounds, reversed-range rejection).
• Per-peer peer1/peer2 member_ports / port_channel_id / port_channel_description / port_channel_configuration exposed (OpenAPI preserves these on read).
• identifier_strategy = "single" on interface_name; switch_ip is routing-only and excluded from diff/payload.

Test Notes

• 71 new unit tests (58 model + 13 orchestrator) plus a fixture JSON: python -m pytest tests/unit/module_utils/models/test_vpc_trunk_host_interface.py tests/unit/module_utils/orchestrators/test_vpc_trunk_host_interface.py -q. Full repo suite stays green (926 pass, no regressions).
• Integration target tests/integration/targets/nd_interface_vpc_trunk_host/ with merged / replaced / overridden / deleted state coverage, exercised against ND 4.2.1 on the SITE1 lab (S1_LE1 / S1_LE2): ansible-test integration --docker nd_interface_vpc_trunk_host -vv. vlan_mapping cases gated on supports_vlan_mapping (Nexus 9000v rejects dot1q-tunnel).
• ansible-test sanity --docker default --python 3.11 passes on the changed files.
• Wire shape verified live: created vpc500 on S1_LE1/S1_LE2 with distinct then matching per-peer VLANs to confirm ND's consistency-enforcement + collapse-on-GET; clean per-interface DELETE cascades to both peers.

Cisco Nexus Dashboard Version

4.2.1

Related ND API Resource Category

• analyze
• infa
• manage
• onemanage
• other

Checklist

• Latest commit is rebased from develop with merge conflicts resolved
• New or updates to documentation has been made accordingly
• Assigned the proper reviewers