Возможности платформы с поддержкой Netconf

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

• Доступные подключения
• Использование NETCONF в Ansible
  • Включение NETCONF
  • Пример инвентаризации NETCONF [junos:vars]
  • Пример задачи NETCONF
  • Пример задачи NETCONF с настраиваемыми переменными
  • Настройка бастиона/шлюза
  • Автообнаружение ansible_network_os

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

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

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

Включение NETCONF

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

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

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

- 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 |

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

- name: Backup current switch config
  netconf_config:
    backup: yes
  register: backup_junos_location

Пример задачи NETCONF с настраиваемыми переменными

- name: configure interface while providing different private key file path
  netconf_config:
    backup: yes
  register: backup_junos_location
  vars:
    ansible_private_key_file: /home/admin/.ssh/newprivatekeyfile

Примечание: для настраиваемых переменных плагина подключения netconf см. netconf.

Настройка бастиона/шлюза

Чтобы использовать шлюз для подключения к устройству с включенным NETCONF, необходимо установить переменную среды ANSIBLE_NETCONF_SSH_CONFIG.

ANSIBLE_NETCONF_SSH_CONFIG can be set to either:

• 1 или TRUE (чтобы запустить использование файла конфигурации SSH по умолчанию ~/.ssh/config)
• Абсолютный путь к пользовательскому файлу конфигурации SSH.

Файл конфигурации SSH должен выглядеть примерно так:

Host *
  proxycommand ssh -o StrictHostKeyChecking=no -W %h:%p jumphost-username@jumphost.fqdn.com
  StrictHostKeyChecking no

Авторизация для шлюза должна использовать аутентификацию на основе ключей.

Вы можете указать используемый приватный ключ в файле конфигурации SSH:

IdentityFile "/absolute/path/to/private-key.pem"

Или использовать ssh-агент.

Автообнаружение ansible_network_os

Если ansible_network_os не указан для узла, Ansible попытается автоматически определить, какой плагин network_os использовать.

Автообнаружение ansible_network_os также может быть запущено с помощью auto в качестве ansible_network_os. (Примечание: ранее default использовался вместо auto).