Skip to content

Latest commit

 

History

History
38 lines (28 loc) · 1.25 KB

README.md

File metadata and controls

38 lines (28 loc) · 1.25 KB

Ansible MikroTik modules

Introduction

This repository provides Ansible modules to manage MikroTik RouterOS-based devices.

Requirements

At this time there are no external dependencies. However, there are additional Python modules that are required by the Ansible modules. You may find these in pythonlibs. Before using Ansible you should add these libraries to your Python path: export PYTHONPATH="$PYTHONPATH:$PWD/pythonlibs"

Development

In order to test this module, you'll need a RouterOS instance to target. If you have an existing RouterOS-based MikroTik device, you need only make sure the API service is enabled.

Otherwise, this repository provides a Vagrantfile for setting up the x86 build of RouterOS for testing. To use it, you must first ensure Vagrant and VirtualBox are installed. Then, run ./create_vagrant_mikrotik.sh to download the official MikroTik Cloud Hosted Router (CHR) image from MikroTik, package it as a Vagrant .box file, and register the .box with Vagrant.

Then, you need only run vagrant up in the repository root to start the CHR.

Installing

These modules are still in a very early stage of development; stay tuned for installation instructions later! :)