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 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 Platform Options.
Этот модуль также работает с подключениями local для устаревших playbooks.
Если значение netconf_port не указано в задаче, по умолчанию оно будет включено только на порте 830. Хотя значение netconf_port может быть от 1 до 65535, следует избегать настройки доступа на порте, обычно назначенном для другой службы. Это предотвратит потенциальные конфликты ресурсов.
Дополнительную информацию о работе с CLI и netconf см. в руководстве Junos OS Platform Options
Для получения дополнительной информации об использовании 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 строка	при changed = True	Возвращает команду, отправленную удалённому устройству Пример: set system services netconf ssh port 830

Статус

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

Поддержка Red Hat

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

Авторы

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