Ansible ND 4.X | ND Manage Switches Module + Pydantic Models + Smart Endpoints by AKDRG · Pull Request #198 · CiscoDevNet/ansible-nd

AKDRG · 2026-03-11T17:18:19Z

This PR introduces the initial implementation of ND Manage switch lifecycle support in the cisco.nd collection.
It adds a new switch management resource layer, endpoint wrappers, Pydantic model hierarchy, utility helpers.

What’s Included

New switch lifecycle resource implementation

Added a full resource engine in plugins/module_utils/manage_switches/nd_switch_resources.py
Implements state handling for:

gathered
merged
replaced
overridden
deleted
POAP flows (bootstrap, pre-provision, serial swap)
RMA flow

Adds structured operation sequencing:

discovery
add/remove
role updates
credentials save
wait-for-manageability
save/deploy finalize

ND Manage endpoint layer

Added endpoint models under plugins/module_utils/endpoints/v1/:

manage_credentials_switches.py
manage_fabrics_actions.py
manage_fabrics_bootstrap.py
manage_fabrics_inventory.py
manage_fabrics_switchactions.py
manage_fabrics_switches.py
manage_fabrics.py

Pydantic model framework and nd_manage_switches models

Added nd_manage_switches model package and exports:
bootstrap, config, discovery, preprovision, rma, switch_actions, switch_data, enums, validators
package-level init re-exports for consistent imports

Utilities for lifecycle orchestration
Added helpers in plugins/module_utils/manage_switches:

utils.py

Unit Tests for the Endpoints and Integration Tests for the States supported by the Module.

These utilities centralize grouping, payload shaping, wait/retry logic, and fabric operations.

…g config

…ls + Module )

…tate Handling

…ible-nd into switch_int_pr

…ucture (CiscoDevNet#185)

plugins/module_utils/endpoints/v1/manage/nd_manage_switches/credentials.py

plugins/module_utils/endpoints/v1/manage/nd_manage_switches/fabric_bootstrap.py

…ible-nd into switch_int_pr

plugins/module_utils/endpoints/v1/manage/nd_manage_switches/fabric_config.py

plugins/module_utils/models/nd_manage_switches/bootstrap_models.py

plugins/modules/nd_manage_switches.py

mikewiebe · 2026-04-08T13:32:42Z

plugins/modules/nd_manage_switches.py

+        - Save/Recalculate the configuration of the fabric after inventory is updated.
+        type: bool
+        default: true
+    deploy:


We need to support separate save and deploy options

Use the following property structures

config_actions: save: true deploy: true type: switch [Enum Choices: switch and global]

If config_actions.save is false and config_actions.deploy is true we should fail

CiscoDevNet#209) * Fabric modules for ibgp,ebgp,external fabrics * Update ibgp model enums * Update pydantic model and module docstrings for ibgp * Update pydantic model for ebgp * Update ebgp module doc headers * Update enums and pydantic model descriptions for external fabrics * Update ebgp module doc strings * Fix ansible sanity tests failures * Black formatting * Move common models into common location for import * Fix black formatting issue * Add unit tests for fabric endpoints * Fix ansible sanity test failures * Test cleanup * Add ibgp testing params * Fix for merged state and tests * Add more properties in ibgp merged test * Add more properties in ibgp replaced test * Refactor merged fix * Change name property to fabric_name * Add nd_info into integration tests * remove underscore between un & numbered * Address review comments * Fix list behavior bug and update module docs * Make ansible sanity happy * Make netflow_exporter udp_port optional * Organize ibgp module doc header --------- Co-authored-by: Matt Tarkington <mtarking@cisco.com>

…ible-nd into switch_int_pr

…rces.

…ible-nd into switch_int_pr

allenrobel and others added 2 commits March 9, 2026 09:45

[ignore] Add generic logger facility through the Log class and loggin…

5c8b04d

…g config

Initial Commit : ND Manage Switches ( Smart Endpoints + Pydantic Mode…

b00aebe

…ls + Module )

AKDRG requested review from akinross, anvitha-jain, gmicol, lhercot, sajagana, samiib and shrsr as code owners March 11, 2026 17:18

allenrobel and others added 8 commits March 11, 2026 11:46

[ignore] Add Endpoints framework for ND API v1 (CiscoDevNet#186)

756bdcc

Add Hostname/DNS support in lieu of IP + Handle Switch Inconsistent S…

b1fe939

…tate Handling

Update Endpoints Inheritance, Directory Structure and Imports

2a135ae

Update Module Imports

081afe0

Merge branch 'nd42_integration' of https://github.com/CiscoDevNet/ans…

fbe00a5

…ible-nd into switch_int_pr

[ignore] Add RestSend framework, enums, and shared unit test infrastr…

f5b1655

…ucture (CiscoDevNet#185)

[ignore] Fix broken imports after nd42_rest_send restructuring

06633f6

Add constants, and fix comparison of constants in RMA.

888ee57

akinross requested changes Mar 13, 2026

View reviewed changes

AKDRG added 9 commits March 13, 2026 16:13

Merge branch 'nd42_integration' of https://github.com/CiscoDevNet/ans…

b784eff

…ible-nd into switch_int_pr

Add further POAP Bootstrap Validation and Fixes

267846a

Rebasing Mixins and Endpoints with Latest Endpoint Changes

9bd95af

Refactor Endpoints for consistency

522f360

Add NDOutput for displaying the result

095e474

Update Results object API calls from Module + Operation Handling

b0f3f34

Fix ConfigSync Status Error

47db2b1

Add duplicate ip validation in configs, fix api changes in module

28703b5

RMA, POAP Bootstrap and Diff Fixes

2372a74

mikewiebe requested changes Mar 17, 2026

View reviewed changes

plugins/module_utils/endpoints/v1/manage/nd_manage_switches/fabric_config.py Outdated Show resolved Hide resolved

plugins/module_utils/models/nd_manage_switches/bootstrap_models.py Outdated Show resolved Hide resolved

mikewiebe reviewed Mar 17, 2026

View reviewed changes

plugins/modules/nd_manage_switches.py Outdated Show resolved Hide resolved

mikewiebe reviewed Mar 17, 2026

View reviewed changes

plugins/modules/nd_manage_switches.py Outdated Show resolved Hide resolved

mtarking and others added 3 commits April 2, 2026 14:25

temp update to pr branch list for ci

932a186

State Fix + Config Output Changes

ddb3bb8

Add Replaced State + Tests Restructuring + Deploy Config Interdependence

8119ba5

AKDRG requested a review from allenrobel as a code owner April 5, 2026 19:39

Black Formatting Fix

9fd18b2

AKDRG changed the title ~~Ansible ND 4.X | WIP | ND Manage Switches Module + Pydantic Models + Smart Endpoints~~ Ansible ND 4.X | ND Manage Switches Module + Pydantic Models + Smart Endpoints Apr 6, 2026

mikewiebe reviewed Apr 8, 2026

View reviewed changes

mikewiebe and others added 8 commits April 8, 2026 09:56

Deploy + Config Save Changes

ebabd78

Merge_Prep

eb80a4a

Merge branch 'nd42_integration' of https://github.com/CiscoDevNet/ans…

00f2045

…ible-nd into switch_int_pr

Branch Merge

a35bd16

Check Mode Changes

35eca19

Black and Sanity Fix

65fc1b2

Revert Changes to Rest about Check Mode, Make the Fix in Switch Resou…

a88cea4

…rces.

sivakasi-cisco mentioned this pull request Apr 9, 2026

[ND 4.2+] Add vPC Peering Module #230

Open

mtarking added 2 commits April 9, 2026 11:17

Merge branch 'develop' into nd42_integration

17239dd

update actions

cacdeb2

mtarking deleted the branch CiscoDevNet:develop April 9, 2026 15:41

mtarking closed this Apr 9, 2026

mtarking reopened this Apr 9, 2026

mtarking changed the base branch from nd42_integration to develop April 9, 2026 15:45

AKDRG mentioned this pull request Apr 9, 2026

[ND 4.2+] Add Switch Inventory Module #231

Open

AKDRG and others added 4 commits April 9, 2026 21:57

Merge branch 'nd42_integration' of https://github.com/CiscoDevNet/ans…

292c234

…ible-nd into switch_int_pr

Merge branch 'develop' into switch_int_pr

17f139b

Pydantic V2 POS Field Fixes

331fba7

Fix Lint

2a7be2c

AKDRG requested review from akinross, mikewiebe and mtarking April 9, 2026 16:59

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Ansible ND 4.X | ND Manage Switches Module + Pydantic Models + Smart Endpoints#198

Ansible ND 4.X | ND Manage Switches Module + Pydantic Models + Smart Endpoints#198
AKDRG wants to merge 114 commits intoCiscoDevNet:developfrom
AKDRG:switch_int_pr

AKDRG commented Mar 11, 2026 •

edited

Loading

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

mikewiebe Apr 8, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

7 participants

Conversation

AKDRG commented Mar 11, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

mikewiebe Apr 8, 2026

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

7 participants

AKDRG commented Mar 11, 2026 •

edited

Loading