Spec-Zone.ru › Ansible 2.9

Опции платформы Junos OS

Juniper Junos OS поддерживает несколько соединений. Эта страница содержит подробную информацию о работе каждого подключения в Ansible и о его использовании.

  • Доступные подключения
  • Использование CLI в Ansible
    • Пример инвентаризации CLI [junos:vars]
    • Пример задачи CLI
  • Использование NETCONF в Ansible
    • Включение NETCONF
    • Пример инвентаризации NETCONF [junos:vars]
    • Пример задачи NETCONF

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

CLI

junos_netconf и junos_command модули только

NETCONF

все модули, кроме junos_netconf, который включает NETCONF

Протокол SSH XML по SSH
Учетные данные

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

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

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

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

Непосредственный доступ через бастион (прокси-сервер) через бастион (прокси-сервер)
Настройки подключения ansible_connection: network_cli ansible_connection: netconf
Режим включения
(Эскалация привилегий)
не поддерживается Junos OS не поддерживается Junos OS
Формат возвращаемых данных stdout[0].
  • json: result[0]['software-information'][0]['host-name'][0]['data'] foo lo0
  • text: result[1].interface-information[0].physical-interface[0].name[0].data foo lo0
  • xml: result[1].rpc-reply.interface-information[0].physical-interface[0].name[0].data foo lo0

Для устаревших playbooks Ansible по-прежнему поддерживает ansible_connection=local для всех модулей JUNOS. Рекомендуется как можно скорее перейти на использование ansible_connection=netconf или ansible_connection=network_cli.

Использование CLI в Ansible

Пример инвентаризации CLI [junos:vars]

[junos:vars]
ansible_connection=network_cli
ansible_network_os=junos
ansible_user=myuser
ansible_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 не поддерживает предоставление паролей через переменные окружения.

Пример задачи CLI

- name: Retrieve Junos OS version
  junos_command:
    commands: show version
  when: ansible_network_os == 'junos'

Использование NETCONF в Ansible

Включение NETCONF

Прежде чем использовать NETCONF для подключения к коммутатору, необходимо:

  • установить пакет python ncclient на узле(ах) управления с помощью pip install ncclient
  • включить NETCONF на устройстве(ах) Junos OS

Для включения NETCONF на новом коммутаторе через Ansible используйте модуль junos_netconf через подключение CLI. Настройте переменные уровня платформы так же, как в примере CLI выше, затем выполните задачу playbooks следующим образом:

- name: Enable NETCONF
  connection: network_cli
  junos_netconf:
  when: ansible_network_os == 'junos'

После включения NETCONF измените переменные, чтобы использовать подключение NETCONF.

Пример инвентаризации NETCONF [junos:vars]

[junos:vars]
ansible_connection=netconf
ansible_network_os=junos
ansible_user=myuser
ansible_password=!vault |
ansible_ssh_common_args='-o ProxyCommand="ssh -W %h:%p -q bastion01"'

Пример задачи NETCONF

- name: Backup current switch config (junos)
  junos_config:
    backup: yes
  register: backup_junos_location
  when: ansible_network_os == 'junos'

Предупреждение

Никогда не храните пароли в открытом виде. Рекомендуется использовать ключи SSH для аутентификации подключений SSH. Ansible поддерживает ssh-agent для управления вашими ключами SSH. Если вам необходимо использовать пароли для аутентификации подключений SSH, рекомендуется шифровать их с помощью Ansible Vault.

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.9/network/user_guide/platform_junos.html

Spec-Zone.ru

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