Config Actions: Wire nd_manage_switches to the Common Save and Deploy Framework

[AKDRG]

Related Issue(s)

Related to #368

Merge dependency on common framework #498

Proposed Changes

• Wire nd_manage_switches into the shared config_actions framework.
• Parse and validate switch module config_actions through the common policy-driven parser.
• Add a switch-specific config actions backend for:
  • fabric config save
  • switch-scoped deploy
  • global fabric deploy
• Preserve existing switch module defaults:
  • config_actions.save: true
  • config_actions.deploy: true
  • config_actions.type: switch
• Enforce common validation behavior:
  • reject explicit empty config_actions: {}
  • reject deploy: true with save: false
  • reject unsupported deploy types for switch workflows
• Route switch finalize flows through the common controller while preserving existing add, migrate, re-add, POAP, preprovision, RMA, and idempotent deploy behavior.
• Add result registration for config save/deploy actions so config action execution is visible in module output.
• Keep idempotent out-of-sync switches deployable on a later run when config_actions.deploy is enabled.
• Add focused unit coverage for switch config action finalize behavior and common framework integration.

Test Notes

• Ran formatting:

  • black --check -l 159 plugins tests
  • Result: passed

• Ran targeted sanity checks:

  • ansible-test sanity --test pep8 --color --truncate 0
  • ansible-test sanity --test pylint --color --truncate 0
  • Result: passed

• Ran full sanity from a materialized collection tree:

  • ansible-test sanity --color --truncate 0
  • Result: passed
  • Note: Python 3.10 and 3.12 compile/import checks were skipped locally because those interpreters are not installed.

• Live tested switch config actions on AK-VXLAN:

  • 8-switch import with config save and switch-level deploy enabled.
  • Switch-level deploy flow completed.
  • Global deploy flow was exercised.
  • Subsequent deploy run after a staged/non-deployed run was validated.
  • Cleanup/removal workflow was tested.

Cisco Nexus Dashboard Version

Cisco Nexus Dashboard 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

[allenrobel]

Code review

Reviewed the switch-module wiring into the common config-actions framework (findings in the config_actions/ package itself are out of scope here since they land via #498). Two findings, posted inline.

🤖 Generated with Claude Code

[allenrobel]

Verified 8327cd91 addresses both threads: finalize() now fails on switch-scoped deploy with no targets, and _idempotent_sync_serials() fails early naming any out-of-sync switch without a resolved switchId. Unit tests pass locally (39 passed). LGTM.