Permalink
Find file Copy path
7d8aa5e Sep 9, 2018
2 contributors

Users who have contributed to this file

@dbarrosop @ogenstad
73 lines (54 sloc) 2.98 KB

Welcome to nornir's documentation!

Nornir is an automation framework written in python to be used with python. Most automation frameworks hide the language they are written in by using some cumbersome pseudo-language which usually is almost Turing complete but lacks tooling to debug and troubleshoot. Integrating with other systems is also usually quite hard as they usually have complex APIs if any at all. Some of the other common problems of those pseudo-languages is that are usually quite bad at dealing with data and re-usability is limited.

Nornir aims to solve those problems by providing a pure python framework. Just imagine Nornir as the Flask of automation. Nornir will take care of dealing with the inventory where you have your host information, it will take care of dispatching the tasks to your devices and will provide a common framework to write "plugins".

How the documentation is structured

Is something missing from the documentation? Please open an issue and tell us what you are missing or open a pull request and suggest an improvement.

A first glance

Here is an example on how to quickly build a runbook leveraging Nornir to retrieve information from the network:

from nornir import InitNornir
from nornir.plugins.functions.text import print_result
from nornir.plugins.tasks.networking import napalm_get

nr = InitNornir(
    config_file="nornir.yaml", dry_run=True, num_workers=20
)

results = nr.run(
    task=napalm_get, getters=["facts", "interfaces"]
)
print_result(results)

You can find this and other examples here.

Contents

.. toctree::
   :maxdepth: 1

   Home <self>
   Tutorials <tutorials/intro/index>
   Howto <howto/index>
   configuration/index
   plugins/index
   ref/index
   upgrading/index
   Contribute <contributing/index>


Indices and tables