madstone-tech / terraform-provider-routeros

Terraform Provider for Mikrotik RouterOS

Terraform Provider RouterOS

Purpose

This repository implements two things:

• Go client to use with RouterOS v7 REST API
• Terraform provider which makes use of said go client

This is to allow configuration of Mikrotik's RouterOS at scale using Terraform. Please note that this provider is still in development, so functionality is missing in some areas. Have a look at the documentation for functionality that has been implemented. If there is a particular function you'd like to see, please raise an issue so it can be added to the roadmap.

Using the provider

To get started with the provider, include the following in your Terraform manifests:

terraform {
  required_providers {
    routeros = {
      source = "GNewbury1/routeros"
    }
  }
}

provider "routeros" {
  hosturl  = "https://my.router.local"
  username = "my_username"
  password = "my_super_secret_password"
}

For more in-depth documentation about each of the resources and datasources, please read the documentation on Hashicorp's Provider registry

Tested RouterOS versions

• 7.1
• 7.1.1
• 7.2rc1

Changelog and Roadmap

For a detailed changelog, please see the changelog.md. For a roadmap, please see the github project I created to cover this. To get things added to the roadmap (such as bugs or features), please raise an issue and describe what needs to be fixed/implemented. As you can imagine, I can only test in the environment I have, which may not work in the environment you have.

Contributing

Please do raise a pull request if you have a contribution to make. Any and all contributions are welcome!