Skip to content
Example playbook to demonstrate Ansible Network Module usage for Cisco IOS devices.
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information. Install stable version of Ansible Aug 3, 2016
ansible.cfg Initial commit Mar 20, 2016
inventory Initial commit Mar 20, 2016

Example usage of Ansible Network Module on Cisco IOS

Recently Peter Sprygada announced technology preview of the new Ansible Network Modules. Ansible 2.1 will bring support for basic tasks (_command, _config, _template) for various network equpiment, most notably Cisco IOS, IOS-XR, NX-OS and Juniper Junos platforms.

This repository contains working simple example that gathers show clock output from Cisco IOS switches. Following installation procedure was verified working on Mac OS X 10.11.3. Ansible playbook was executed on Cisco C2960X, IOS 15.2(2)E1 switches.

Example usage

Install Ansible

Ensure you are using Ansible v2.1 or above:

ansible-playbook --version

If not install the latest version via your OS packager, for more information see

Clone this repository to your working folder

Copy of all files in this repository will be downloaded to your mac/pc/whatever.

$ git clone

[Optional] Edit your hosts file

If you will be using IP addresses directly in you inventory file or if you have properly working internal DNS you can skip this step.

$ sudo nano /etc/hosts

Example hosts file on Mac OS X: localhost broadcasthost
::1             localhost switch1 switch2

Edit inventory

Add all network devices you want to gather time from to inventory file.

$ cd ansible-cisco-ios-example
$ nano inventory

Example inventory file:

# Example inventory file:

Run show_clock Playbook

$ ansible-playbook show_clock.yml
Username: ...
Password: ...

Playbook will prompt you for username and password that will be used to log in to inventory devices. Gathered output will be printed on screen.

You can’t perform that action at this time.