Skip to content

Commit

Permalink
Update readme
Browse files Browse the repository at this point in the history
  • Loading branch information
gfenn-newbury committed Dec 21, 2021
1 parent 7fb6a84 commit 1de34f2
Showing 1 changed file with 31 additions and 18 deletions.
49 changes: 31 additions & 18 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,27 +6,40 @@

## Purpose

This provider is intended to be used with Router OS 7 and above. It makes use of the REST API introduced with Router OS v7.
This repository implements two things:
- Go client to use with RouterOS v7 REST API
- Terraform provider which makes use of said go client

## Currently Implemented
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]([documentation on Hashicorp's Provider registry](https://registry.terraform.io/providers/GNewbury1/routeros/latest/docs)) for functionality that has been implemented. If there is a particular function you'd like to see, please raise an issue to it can be added to the [roadmap](https://github.com/users/GNewbury1/projects/2).

- Interface
- Bridge
- Bridge VLAN
- Bridge Port
- VLAN
- IP
- DHCP Client
- DHCP Server
- Firewall
- Filter
- Pool
- Route
## Using the provider

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

Please refer to the [documentation](docs/)
```terraform
terraform {
required_providers {
routeros = {
source = "GNewbury1/routeros"
}
}
}
## Changelog
provider "routeros" {
hosturl = "https://my.router.local"
username = "my_username"
password = "my_super_secret_password"
}
See [changelog.md](changelog.md)
```

For more in-depth documentation about each of the resources and datasources, please read the [documentation on Hashicorp's Provider registry](https://registry.terraform.io/providers/GNewbury1/routeros/latest/docs)

## Changelog and Roadmap

For a detailed changelog, please see the [changelog.md](changelog.md).
For a roadmap, please see [the github project](https://github.com/users/GNewbury1/projects/2) 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!

0 comments on commit 1de34f2

Please sign in to comment.