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

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

Описание

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

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
netconf_port -		По умолчанию: 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 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 строка	при changed = True	Возвращает команду, отправленную удалённому устройству Пример: set system services netconf ssh port 830

Статус

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

Поддержка Red Hat

Дополнительная информация о поддержке этого модуля Red Hat доступна в этой статье базы знаний 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.9/modules/junos_netconf_module.html