junos_netconf – Настраивает службу Junos Netconf

Новая версия 2.1.

Обзор
Параметры
Примечания
Примеры
Возвращаемые значения
Статус

Обзор

Этот модуль предоставляет абстракцию, которая позволяет включить и настроить службу netconf системы, работающую на устройствах Junos. Этот модуль можно использовать для удобного включения API Netconf. Netconf предоставляет программно-ориентированный интерфейс для работы с ресурсами конфигурации и состояния, как определено в RFC 6242. Если netconf_port не указано в задаче по умолчанию, netconf будет включен только на порту 830.

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
netconf_port - добавлено в 2.2		По умолчанию: 830	Этот аргумент указывает порт, на котором служба netconf должна прослушивать подключения SSH. Порт по умолчанию, как определено в RFC 6242, составляет 830. псевдонимы: listens_on
provider словарь			Устарело Начиная с Ansible 2.5, рекомендуется использовать `connection: network_cli` или `connection: netconf`. Для получения дополнительной информации см. руководство по параметрам платформы Junos Junos OS Platform Options. Объект словаря, содержащий данные соединения.
	host строка / обязательно		Указывает имя хоста DNS или адрес для подключения к удалённому устройству по указанному транспорту. Значение параметра host используется в качестве адреса назначения для транспорта.
	password строка		Указывает пароль для аутентификации подключения к удалённому устройству. Это значение используется для аутентификации сеанса SSH. Если значение не указано в задаче, используется значение переменной среды `ANSIBLE_NET_PASSWORD`.
	port целое число	По умолчанию: 22	Указывает порт для подключения к удалённому устройству. Значение порта по умолчанию — 22 (для `transport=cli`) или 830 (для `transport=netconf`)-устройства.
	ssh_keyfile путь		Указывает SSH-ключ для аутентификации подключения к удалённому устройству. Это значение — путь к ключу, используемому для аутентификации сеанса SSH. Если значение не указано в задаче, используется значение переменной среды `ANSIBLE_NET_SSH_KEYFILE`.
	timeout целое число	По умолчанию: 10	Указывает время ожидания в секундах для связи с сетевым устройством при подключении или отправке команд. Если время ожидания истекает до завершения операции, модуль вернёт ошибку.
	username строка		Настраивает имя пользователя для аутентификации подключения к удалённому устройству. Это значение используется для аутентификации сеанса SSH. Если значение не указано в задаче, используется значение переменной среды `ANSIBLE_NET_USERNAME`.
state -		Варианты: present ← absent	Указывает состояние ресурса `junos_netconf` на удалённом устройстве. Если аргумент state установлен в present, служба netconf будет настроена. Если аргумент state установлен в absent, служба netconf будет удалена из конфигурации.

Примечания

Примечание

Тестировалось на vSRX JUNOS версии 15.1X49-D15.4, vqfx-10000 JUNOS Версии 15.1X53-D60.4.
Рекомендуемое подключение — network_cli. См. руководство по параметрам платформы Junos OS.
Этот модуль также работает с local подключениями для устаревших плейбуков.
Если значение netconf_port не указано в задаче, по умолчанию оно будет включено только на порту 830. Хотя значение netconf_port может быть от 1 до 65535, избегайте настройки доступа к порту, обычно назначенному для другой службы. Это предотвращает потенциальные конфликты ресурсов.
Для получения информации об использовании CLI и netconf см. руководство по параметрам платформы Junos OS
Для получения дополнительной информации об использовании Ansible для управления сетевыми устройствами см. руководство по Ansible Network
Для получения дополнительной информации об использовании Ansible для управления устройствами сети Juniper см. https://www.ansible.com/ansible-juniper.

Примеры

- name: enable netconf service on port 830
  junos_netconf:
    listens_on: 830
    state: present

- name: disable netconf service
  junos_netconf:
    state: absent

Возвращаемые значения

Общие возвращаемые значения описаны здесь, следующие поля уникальны для данного модуля:

Ключ	Возвращённое значение	Описание
commands строка	при изменении — True	Возвращает команду, отправленную на удалённое устройство Пример: set system services netconf ssh port 830

Статус

Не гарантируется обратная совместимость интерфейса этого модуля. [превью]
Этот модуль поддерживается командой Ansible Network Team. [сеть]

Поддержка Red Hat

Дополнительная информация о поддержке данного модуля Red Hat доступна в статье базы знаний Red Hat Red Hat Knowledge Base article.

Авторы

Peter Sprygada (@privateip)

Подсказка

Если вы обнаружите какие-либо проблемы в этом руководстве, вы можете отредактировать этот документ для улучшения.

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