Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/andreygubarev/ansible-routeros
Ansible Collection for managing RouterOS devices.
https://github.com/andreygubarev/ansible-routeros
ansible ansible-galaxy mikrotik networking routeros
Last synced: 16 days ago
JSON representation
Ansible Collection for managing RouterOS devices.
- Host: GitHub
- URL: https://github.com/andreygubarev/ansible-routeros
- Owner: andreygubarev
- License: mit
- Created: 2023-01-15T18:43:09.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2023-08-28T13:39:07.000Z (over 1 year ago)
- Last Synced: 2024-11-01T09:28:43.512Z (2 months ago)
- Topics: ansible, ansible-galaxy, mikrotik, networking, routeros
- Language: Makefile
- Homepage:
- Size: 49.8 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# `andreygubarev.routeros`
Collection for idempotent management of MikroTik RouterOS devices, including upsert of configs.
## Installation
To install this collection use the `ansible-galaxy` command-line tool:
```sh
ansible-galaxy collection install andreygubarev.routeros
```
# Roles
## `andreygubarev.routeros.api_find_and_upsert`
Role for idempotently finding and upserting Mikrotik RouterOS configurations using the RouterOS API.
```yaml
---
- hosts: routeros
tasks:
- name: Upsert IP pool
ansible.builtin.include_role: { name: andreygubarev.routeros.api_find_and_upsert }
vars:
path: ip pool
find:
name: dhcp
values:
name: dhcp
ranges: 10.10.0.2-10.10.0.254
```
For full documentation and usage instructions, please refer to the [role documentation](https://github.com/andreygubarev/ansible-routeros/blob/main/roles/api_find_and_upsert/README.md).
# Reference
- [Ansible Galaxy](https://galaxy.ansible.com/andreygubarev/routeros) - Find more information and download the collection.
- [Source Code](https://github.com/andreygubarev/ansible-routeros) - Access the collection's source code on Github.