CHANGELOG.md

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog and this project adheres to Semantic Versioning.

v2.0.0 (2024-03-13)

Feature

• ✨ Changed filter for Nautobot load() funcs to use Tenant if specified in Job form. (15893af)
• Add namespace to IPAddress DiffSync model. (af052ff)
• Adding ipaddress to interface function and updating ipaddress load function (d50ad01)
• Adding External intergration and removing DNAC instance related components (371bea4)
• Add method to get Device model from list string. (4f2573e)
• Add platform handling for 9130 models (941fc24)

Fix

• ♻️ Replace location_map with region, site, and floor map to ensure proper LocationType is used. (72041cc)
• 🐛 Change Site LocationType to not be nestable (d947b3a)
• 🐛 Have object actually saved! (00744e0)
• 🐛 Correct load to use OrmIPAddress (b281f9a)
• 🐛 Correct syntax (af19de8)
• 🐛 Correct check for existing IPAddress to match DiffSync model. (13a11ed)
• 🐛 Add check for building not being found in device_info. (1c4a81e)
• 🐛 Add handling for ValidationError when updating an IPAddress. (b95886e)
• 🐛 Set DiffSyncModelFlags to SKIP_UNMATCHED_DST on loaded objects if Tenant specified. (dc170ad)
• 🐛 Correct number of dunder to 2 (b3468ee)
• 🐛 Correct filter to specify Device Tenant for load_ports() (2d11041)
• Correct config information. (92a9363)
• 🐛 Correct DataMapping to Locations instead of Regions/Sites (778749b)
• Catch IntegrityError being thrown. (bc2e88b)
• 🐛 Correct use of ipaddr_map and ipaddr_pf_map to use IPAddress host instead of address. (c5ab022)
• Use host and mask_length instead of address for IPAddress. (d49b7ae)
• Correct typo (310fb79)
• Correct Device location update to not allow None. (3e92d11)
• Correct Role to specify ContentType if created. (1a4c206)
• Correct port status to use proper name field. (487bc73)
• Correct check for Platform to use network_driver (3ec6029)
• Remove execute_sync method as it isn't needed. (a04a011)
• 🐛 Redo loading of IPAddress to Interface to use IPAddressToInterface instead of IPAddress. (b00ad92)
• 🐛 Add Prefixes and IPAddresses to objects_to_delete so they're removed in correct order. (26bb123)
• 🔥 Remove code for Device and Interface from IPAddress creation as not needed any longer. (27985e3)
• 🐛 Correct object attributes in Device update. (5a4ea94)
• 🐛 Correct attribute to be site instead of location when loading a device. (8dffac9)
• 🐛 Correct default Region to be Global if undefined. (4844367)
• 🐛 Correct Relationship to use label to get object and not name. (b7aec2e)
• 🐛 Ensure network_driver is defined when creating a Platform and should use platform_name. (df706e8)
• 🐛 Correct data_mapping to use location_list instead of region/site. (b650767)
• Logging bug fix with proper 2.X logging conventions. (ed48117)
• Changes to tests for 2.0 (5eafaa3)
• Additional changes for 2.0 (857c893)
• Logging for 2.0 (91e6728)
• Add Prefix to Dna center adapter (d6901b8)
• Add Prefix Diffsync model and related changes in adapters (e393f6c)
• Slug to name for 2.0 (177049a)
• Region, Site with locations and fix imports (9bb354f)
• Navigation for 2.0 replace plugin with apps framework (c3d62fa)
• Import changes for 2.0 (427379d)
• Correct model update for Device to include vendor. (3d94aae)
• Throw Exception instead of logging when auth failure. (1b40fb2)
• 🐛 Restructure how floor is updated on a Device (6097072)
• 🐛 Ensure Location is None if not set for Device to match DNAC (ac88038)
• Add check for type key (ab85a71)
• 🐛 Add handling for 3800 series AP missing platform (7092923)
• 🐛 Add handling for devices without hostname. (2d5b513)

Documentation

• 🚨 Fix docstrings (6905ce1)
• Add SSoT dashboard image (cec8298)
• 📝 Add image for DNAC DataSource details page. (42b0e54)
• 📝 Add images for documentation (5f04a2c)
• 🏷️ Add type hint for job (2aa4800)
• 📝 Fix docstrings for a few methods. (03570fc)
• 📝 Fix docstrings to match method signature. (85b0abb)

Performance

• Refactor project to use maps and bulk operations. (34ad17b)

v1.0.0 (2023-06-07)

Feature

• ✨ Update Device load function to hostname_mapping setting is found. (8ecdd8b)
• ✨ Add new function to parse hostname to determine DeviceRole. (91b139f)

Documentation

• 📝 Update README with details about hostname_mapping and other settings. (17b02a1)

v0.9.0 (2023-05-22)

Feature

• Add failed_import_devices list for field validation. (55ace49)

Fix

• 🐛 Correct updates for role and device type as they're tuples (bd69d61)
• 🐛 Correct attribute to facility from site (c6e2294)
• 🐛 Only do DLC check if version in attrs for update (cef860d)
• 🐛 Remove filter using DNAC CF on Floor (379eba8)
• Remove management_addr from _attributes on Device (6037ddc)
• Correct Sync CF to just be date (15b30ed)
• Correct query for Device when loading ports (e788adb)

v0.8.0 (2023-04-26)

Feature

• ✨ Update Job to execute sync in post_run to make it non-atomic. (20579ff)
• ✨ Add update_locations setting to disable updating/deleting of Sites from DNAC (bb6c8cb)
• ✨ Add setting to ignore Global Area so it's not imported. (1a31745)

Fix

• 🐛 Ensure serial on Device is always a string, can't be None in Nautobot. (09fc158)
• 🐛 Add check for already loaded Building in case of duplicates in DNAC. (2227653)
• 🐛 Specify Interface when finding IPAddress to update CustomFields. (82caba6)
• 🐛 Add Tenant field to tables (aed644a)
• Use is_truthy with import_global setting (44a2fd0)
• ♻️ Redo code to work properly without Global area. Also added tests to validate functionality. (3f70ada)
• 🐛 Add check for existing Region in create function. (0908b5e)
• 🐛 Add check for type value being non-null (1d360be)
• 🐛 Add check for existing Port before loading to avoid duplicates. (be4d386)
• Add handling for validating device already loaded to prevent possible duplicates. (690cd93)
• 🐛 Add check for MTU being null, set to 1500 if found. (6c2946f)
• Have model set to Unknown if null in DNAC (a0c2f65)
• 🐛 Update get_devices to be less than, ensure offset has minimum of 1. (983d96e)
• 🐛 Update get_locations to remove duplicate results and add pagination handling. (c0a6c19)
• 🐛 Add handling for more than 500 responses for getting sites and devices. (440342f)

Documentation

• 📝 Update documentation with import_global setting (0e6c53d)
• 📝 Add logging to notify user of errors. (4b0e8fa)
• 📝 Add some debug logging to DNAC load functions (343c22c)

v0.7.0 (2023-04-10)

Feature

• ✨ Add support for Device Lifecycle App for software version tracking. (65b4551)
• ✨ Create verify_platform function to get/create Platform to ensure standardized. (437770a)

Fix

• 🐛 Remove metadata for py3.7 as not needed anymore (41d19f8)

v0.6.0 (2023-04-06)

Feature

• ✨ Add CustomField to all imported devices stating SoR and last sync date/time. (1896b9c)

Fix

• 🐛 Correct CustomField name to match slug. This fixes the warning in Nautobot. (1dbe114)
• Add handling in case a Site has no Region. (ce4dd97)

v0.5.0 (2023-04-04)

Feature

• ✨ Add tenant to supported models (b1fa72c)
• ✨ Add Tenant to DNACInstance model (ca70638)
• ✨ Add DNA Center logo and update data mappings for IP Addresses (1cb2f19)
• ✨ Add sync_complete method to process deletion of location objects (0a0990c)
• ✨ Add validation to DNACInstance model and update tests accordingly (5512b0a)
• ✨ Add IPAddresses from Interfaces to imports and CRUD ops to Nautobot. (6dc9181)

Fix

• 🐛 Add Tenant to forms to enable specifying in DNACInstance. (354644f)
• Correct slug for OS Version CF to be a dash (f998470)
• Add update_forward_ref to all parent models (78c161e)
• 🐛 Make management_addr attribute optional as it's not being evaluated in attribute list (9c43390)

Documentation

• 📝 Add docstring to test_delete method (31abd51)

v0.4.0 (2023-02-28)

Feature

• ✨ Update CRUD methods for NautobotPort (2a34749)
• ✨ Add enabled attribute to Port model (8a82c4c)
• ✨ Add load methods for each Port derived model. (410d285)
• ✨ Add method to get port information with device_id (0302bec)
• ✨ Add initial Port derived classes for DNAC and Nautobot (b8b28a7)
• ✨ Add Port base DiffSync model (dfe5b8c)

Fix

• 🔥 Remove garbage characters in test_jobs (9a4b159)
• 🐛 Ensure MAC address is string and formatted the same for diff (d01c28e)
• 🐛 Ensure Location created with Site and Status and fix name. (363187d)
• 🐛 Add handling in case Device family attribute is null (41eeeda)
• 🐛 Skip Devices without a hostname (1cd0308)
• 🐛 Update DnacInstance class to derive from PrimaryModel (f362fae)

Documentation

• 📝 Add informational logging to Nautobot CRUD methods. (5c63618)

v0.3.1 (2023-02-17)

Fix

• 🐛 Ensure version is recorded in Device CustomField (93b8282)

v0.3.0 (2023-02-17)

Feature

• Add Device import from DNAC #3 (9c8774e)
• Update Nautobot model CRUD methods (f76dfb6)
• ✨ Update NautobotDevice CRUD to use updated attributes. (cdeae35)
• ✨ Add load methods for devices from DNAC, include test to validate functionality. (ad40c25)
• ✨ Add method to get_device_detail to get location data from DNAC (17114a5)
• ✨ Add method to find latitude and longitude from Device additionalInfo (3514834)

Fix

• 🐛 Updates to ensure fields in diff line up and match (a659509)
• 🐛 Make parent an identifier to allow for nested areas (3831f25)

Documentation

• 📝 Update docstring for get_locations method (8c17deb)

v0.2.0 (2023-02-10)

Feature

• Add Site load from DNAC and Nautobot (#1) (0b42275)