junos_netconf - Настройка службы Junos Netconf

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

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

Обзор

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

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
netconf_port (добавлен в 2.2)		По умолчанию: 830	Этот аргумент задаёт порт, на котором служба netconf должна прослушивать SSH-соединения. Порт по умолчанию, как определено в RFC 6242, равен 830. псевдонимы: listens_on
provider		По умолчанию: None	Устарело Начиная с Ansible 2.5, мы рекомендуем использовать `connection: network_cli` или `connection: netconf`. Для получения дополнительной информации, пожалуйста, обратитесь к руководству Junos OS Platform Options. Объект словаря, содержащий детали подключения.
	username		Настраивает имя пользователя для аутентификации подключения к удалённому устройству. Это значение используется для аутентификации SSH-сессии. Если значение не указано в задаче, используется значение переменной окружения `ANSIBLE_NET_USERNAME`.
	host обязательно		Указывает имя хоста DNS или адрес для подключения к удалённому устройству по указанному протоколу. Значение host используется в качестве адреса назначения для протокола.
	ssh_keyfile		Указывает SSH-ключ для аутентификации подключения к удалённому устройству. Это значение — путь к ключу, используемому для аутентификации SSH-сессии. Если значение не указано в задаче, используется значение переменной окружения `ANSIBLE_NET_SSH_KEYFILE`.
	timeout	По умолчанию: 10	Задает таймаут в секундах для связи с сетевым устройством, либо при подключении, либо при отправке команд. Если таймаут превышен до завершения операции, модуль вернёт ошибку.
	password	По умолчанию: None	Указывает пароль для аутентификации подключения к удалённому устройству. Это значение используется для аутентификации SSH-сессии. Если значение не указано в задаче, используется значение переменной окружения `ANSIBLE_NET_PASSWORD`.
	port	По умолчанию: 22	Указывает порт, используемый при создании соединения с удалённым устройством. Значение порта по умолчанию — хорошо известный SSH-порт 22 (для `transport=cli`) или порт 830 (для `transport=netconf`) устройства.
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 Platform Options.
Этот модуль также работает с подключениями local для устаревших playbook.
Дополнительную информацию об использовании CLI и netconf см. в руководстве по настройкам платформы Junos OS.
Дополнительную информацию об использовании Ansible для управления сетевыми устройствами см. в руководстве Ansible по сетям.
Дополнительную информацию об использовании 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 str	при изменении changed = True	Возвращает команду, отправленную на удалённое устройство Пример: set system services netconf ssh port 830

Статус

Этот модуль помечен как бета-версия, что означает, что он не гарантирует обратную совместимость интерфейса.

Поддержка

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

Автор

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.5/modules/junos_netconf_module.html