Spec-Zone.ru › Ansible

Планировочные параметры RouterOS

RouterOS входит в коллекцию community.network и поддерживает только подключения по CLI и прямой доступ к API. Эта страница содержит подробную информацию о том, как использовать ansible.netcommon.network_cli в RouterOS в Ansible. Дополнительную информацию можно найти в руководстве по SSH в коллекции community.routeros.

Информация о том, как использовать API RouterOS, находится в руководстве по API в коллекции community.routeros.

  • Доступные подключения
  • Использование CLI в Ansible

    • Пример CLI group_vars/routeros.yml
    • Пример задачи CLI

Доступные подключения

CLI

Протокол

SSH

Учетные данные

использует ключи SSH / SSH-агент, если доступен

принимает -u myuser -k при использовании пароля

Непрямой доступ

через бастион (шлюз)

Настройки подключения

ansible_connection: ansible.network.network_cli

Режим включения
(эскалация привилегий)

не поддерживается RouterOS

Формат возвращаемых данных

stdout[0].

Модули 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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API