Package: nautobot-golden-config
Nautobot Golden ConfigAn App forNautobot.OverviewThe Golden Config plugin is a Nautobot plugin that provides a NetDevOps approach to golden configuration and configuration compliance.!!! info
Upgrading to Nautobot and Nautobot Golden Config 2.0, see ourmigration guide!Key Use CasesThis plugin enable six (6) key use cases.Configuration Backups- Is a Nornir process to connect to devices, optionally parse out lines/secrets, backup the configuration, and save to a Git repository.Intended Configuration- Is a Nornir process to generate configuration based on a Git repo of Jinja files to combine with a GraphQL generated data and a Git repo to store the intended configuration.Source of Truth Aggregation- Is a GraphQL query per device that creates a data structure used in the generation of configuration.Configuration Compliance- Is a process to run comparison of the actual (via backups) and intended (via Jinja file creation) CLI configurations upon saving the actual and intended configuration. This is started by either a Nornir process for cli-like configurations or calling the API for json-like configurationsConfiguration Remediation- Is a process of generating a partial device configuration that would get a configuration feature into a compliant state.Configuration Deployment- Is a process to generate a device configuration and push it to the network device. It supports compliance features, remediation engine and manual definitions.Notice:Configuration Postprocessing- (beta feature) This process renders a valid configuration artifact from an intended configuration, that can be pushed to devices. The current implementation renders this configuration; however,it doesn't push itto the target device.Notice: The operators of their own Nautobot instance are welcome to use any combination of these features. Though the appearance may seem like they are tightly coupled, this isn't actually the case. For example, one can obtain backup configurations from their current RANCID/Oxidized process and simply provide a Git Repo of the location of the backup configurations, and the compliance process would work the same way. Also, another user may only want to generate configurations, but not want to use other features, which is perfectly fine to do so.ScreenshotsThere are many features and capabilities the plugin provides into the Nautobot ecosystem. The following screenshots are intended to provide a quick visual overview of some of these features.The golden configuration is driven by jobs that run a series of tasks and the result is captured in this overview.The compliance report provides a high-level overview on the compliance of your network.The compliance overview will provide a per device and feature overview on the compliance of your network devices.Drilling into a specific device and feature, you can get an immediate detailed understanding of your device.Try it out!This App is installed in the Nautobot Community Sandbox found over atdemo.nautobot.com!For a full list of all the available always-on sandbox environments, head over to the main page onnetworktocode.com.DocumentationFull web-based HTML documentation for this app can be found over on theNautobot Docswebsite:User Guide- Overview, Using the App, Getting Started, Navigating compliance (cli, json, custom), backup, app usage, intended state creation.Administrator Guide- How to Install, Configure, Upgrade, or Uninstall the App.Developer Guide- Extending the App, Code Reference, Contribution Guide.Release Notes / ChangelogFrequently Asked QuestionsContributing to the DocsYou can find all the Markdown source for the App documentation under thedocsfolder 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 withmkdocs. A container hosting the docs will be started using the invoke commands (details in theDevelopment Environment Guide) onhttp://localhost:8001. As your changes are saved, the live docs will be automatically reloaded.Any PRs with fixes or improvements are very welcome!QuestionsFor any questions or comments, please check theFAQfirst. Feel free to also swing by theNetwork to Code Slack(channel#nautobot), sign uphereif you don't have an account.