This repository holds materials for an Ansible network automation tutorial presented at NANOG65, RIPE71, and APRICOT2017. The assumed audience for this tutorial are IP network engineers with no or minimal programming or 'DevOps' experience. The tutorial was first presented at NANOG65 on October 6th, 2015 in Montreal, Québec, Canada.
For environment simplicity, we assume a stock Ubuntu LTS server installation. It is highly encouraged to run a Linux host within a virtualization setup, such as VirtualBox, VMware Fusion, or other virtualization platforms. It is possible to run Ansible under other Linux distributions or even other operating systems, such as Mac OSX, FreeBSD, and Windows 10.
Within your host OS, Python 2.7.10 or greater must be installed (the Python 3.x releases are untested) along with pip (the Python packager management tool). For instructions on how to install the correct version of python and pip, as well as running Ansible on Windows, please see the following links:
- Python on Linux
- Python on Mac OSX
- Installing PIP
- Windows 10 & Ansible or Windows w/ Cygwin & Ansible
Follow the VirtualBox and Ubuntu VM installation instructions which include screenshots and descriptions for the required steps (note: the screenshots show an older Ubuntu release and slightly different git repo name, however the general directions still apply).
If you have an existing Linux environment that you're comfortable managing, the main steps are:
wget -O tutorial.tgz https://github.com/0xreid/ansible-network-automation-tutorial/archive/master.tar.gz
tar xzf tutorial.tgz
cd ansible-network-automation-tutorial-master
sudo apt-get install python-pip python-dev
sudo pip install -r requirements.txt
If, in the pip install -r requirements.txt step, the cryptography build and subsequently the package installation fails, then you should check if all the dependencies are met. Check out this Stack Overflow post on the subject: Failed to install Python Cryptography package with PIP and setup.py
This directory is meant to be used as a workspace to follow along with the hands-on tutorial portion of the talk. You'll be creating directories and files from scratch, as well as moving and editing existing reference files.
Basic role to learn to generate files and print "Hello world" to a text file.
This directory contains a more complete finished example of the tutorial for reference.
This directory contains some basic examples of the ipaddr() filter in action - both IPv4 and IPv6.
This directory contains more complex examples, geared as an Ansible 102 tutorial.
Copies of the slide deck used when the tutorial is presented at conferences.
Tutorial to walk through the installation of a VM for the tutorial.