Планировочные параметры RouterOS
RouterOS входит в коллекцию community.network и поддерживает только подключения по CLI и прямой доступ к API. Эта страница содержит подробную информацию о том, как использовать ansible.netcommon.network_cli в RouterOS в Ansible. Дополнительную информацию можно найти в руководстве по SSH в коллекции community.routeros.
Информация о том, как использовать API RouterOS, находится в руководстве по API в коллекции community.routeros.
Доступные подключения
CLI | |
|---|---|
Протокол | SSH |
Учетные данные |
использует ключи SSH / SSH-агент, если доступен принимает |
Непрямой доступ | через бастион (шлюз) |
Настройки подключения |
|
Режим включения | не поддерживается RouterOS |
Формат возвращаемых данных |
|
Модули SSH RouterOS не поддерживают ansible_connection: local. Необходимо использовать ansible_connection: ansible.netcommon.network_cli.
Модулям API RouterOS требуется ansible_connection: local. Дополнительную информацию см. в руководстве по API коллекции community.routeros.
Использование CLI в Ansible
Пример CLI group_vars/routeros.yml
ansible_connection: ansible.netcommon.network_cli ansible_network_os: community.network.routeros ansible_user: myuser ansible_password: !vault... ansible_become: true ansible_become_method: enable ansible_become_password: !vault... ansible_ssh_common_args: '-o ProxyCommand="ssh -W %h:%p -q bastion01"'
- Если вы используете ключи SSH (включая ssh-агент), вы можете удалить настройку
ansible_password. - Если вы обращаетесь к хосту напрямую (не через бастион/шлюз), вы можете удалить настройку
ansible_ssh_common_args. - Если вы обращаетесь к хосту через бастион/шлюз, вы не можете включить свой пароль SSH в директиву
ProxyCommand. Для предотвращения утечки секретов (например, вpsвыводе), SSH не поддерживает предоставление паролей через переменные среды. - Если вы получаете ошибки таймаута, возможно, вам следует добавить суффикс
+cet1024wк своему имени пользователя, что отключит цветовые коды, включит «глухой» режим, сообщит RouterOS, что он не должен пытаться обнаруживать возможности терминала, и установит ширину терминала в 1024 столбца. Дополнительную информацию см. в статье Процесс входа в консоль на сайте MikroTik wiki. - Дополнительные заметки можно найти в руководстве по SSH коллекции community.routeros.
Пример задачи CLI
- name: Display resource statistics (routeros)
community.network.routeros_command:
commands: /system resource print
register: routeros_resources
when: ansible_network_os == 'community.network.routeros'
Предупреждение
Никогда не храните пароли в открытом виде. Рекомендуется использовать ключи SSH для аутентификации SSH-соединений. Ansible поддерживает ssh-агент для управления вашими ключами SSH. Если вам необходимо использовать пароли для аутентификации SSH-соединений, рекомендуется шифровать их с помощью Ansible Vault.
См. также
© 2012–2018 Michael DeHaan
© 2018–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/network/user_guide/platform_routeros.html