Nautobot Single Source of Truth (SSoT)¶
A plugin for Nautobot. This plugin facilitates integration and data synchronization between various "source of truth" (SoT) systems, with Nautobot acting as a central clearinghouse for data - a Single Source of Truth, if you will.
The nautobot-ssot plugin builds atop the DiffSync Python library and Nautobot's Jobs feature. This enables the rapid development and integration of Jobs that can be run within Nautobot to pull data from other systems ("Data Sources") into Nautobot and/or push data from Nautobot into other systems ("Data Targets") as desired. Key features include the following:
- A dashboard UI lists all registered Data Sources and Data Targets and provides a summary of the synchronization history.
- The outcome of executing of a data synchronization Job is automatically saved to Nautobot's database for later review.
- Detailed logging output generated by DiffSync is automatically captured and saved to the database as well.
The dashboard view of the app.
The detailed view of the example data source that is prepackaged within this app.
The detailed view of an executed sync.
More screenshots can be found in the Using the App page in the documentation.
Try it out!¶
This App is installed in the Nautobot Community Sandbox found over at demo.nautobot.com!
For a full list of all the available always-on sandbox environments, head over to the main page on networktocode.com.
Full documentation for this App can be found over on the Nautobot Docs website:
- User Guide - Overview, Using the App, Getting Started, Developing Jobs.
- Administrator Guide - How to Install, Configure, Upgrade, or Uninstall the App.
- Developer Guide - Extending the App, Code Reference, Contribution Guide.
- Release Notes / Changelog.
Contributing to the Documentation¶
You can find all the Markdown source for the App documentation under the
docs folder in this repository. For simple edits, a Markdown capable editor is sufficient: clone the repository and edit away.
If you need to view the fully-generated documentation site, you can build it with MkDocs. A container hosting the documentation can be started using the
invoke commands (details in the Development Environment Guide) on http://localhost:8001. Using this container, as your changes to the documentation are saved, they will be automatically rebuilt and any pages currently being viewed will be reloaded in your browser.
Any PRs with fixes or improvements are very welcome!
For any questions or comments, please check the FAQ first. Feel free to also swing by the Network to Code Slack (channel
#nautobot), sign up here if you don't have an account.