Skip to content

# Nautobot Plugin Nornir

An App for Nautobot.

## Overview

A plugin for Nautobot, that intends to be a small shim layer between nornir-nautobot and other plugins. The primary abilities that the plugin provides is a native Nornir ORM based inventory and a credential manager.

As of the writing of this readme, the only plugin leveraging this plugin is the golden-config. However, future plugins are planned, such as the "network importer".

That being said, there is currently little reason to install this plugin by itself, without an enabler, which can be seen represented as the white rectangles inside the yellow rectangle in the diagram above. An enabler could be a Plugin, Job, or another piece of code like a Chatops command.

### Screenshots

As previously mentioned, the plugin is mostly a shim layer, here is an example of how Nautobot Golden Config uses a Nornir Job.

## Try it out!

This App is installed in the Nautobot Community Sandbox found over at demo.nautobot.com! This is used within the Nautobot Golden Config plugin, when the tasks of generating config, running backup of configs, or comparing configs.

> For a full list of all the available always-on sandbox environments, head over to the main page on networktocode.com.

## Documentation

Full web-based HTML documentation for this app can be found over on the Nautobot Docs website:

- User Guide - Overview, Using the App, Getting Started.
- Administrator Guide - How to Install, Configure, Upgrade, or Uninstall the App.
- Developer Guide - Extending the App, Code Reference, Contribution Guide.
- Release Notes / Changelog.
- Frequently Asked Questions.

### Contributing to the Docs

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 docs will be started using the invoke commands (details in the Development Environment Guide) on http://localhost:8001. As your changes are saved, the live docs will be automatically reloaded.

Any PRs with fixes or improvements are very welcome!

## Questions

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.