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			Устаревший Начиная с Ansible 2.5, рекомендуется использовать `connection: network_cli` или `connection: netconf`. Для получения дополнительной информации, пожалуйста, обратитесь к руководству по вариантам платформы Junos OS . Объект словаря, содержащий сведения о подключении.
	host обязательно		Указывает имя хоста DNS или адрес для подключения к удаленному устройству через указанный транспорт. Значение host используется в качестве адреса назначения для транспорта.
	port	По умолчанию: 22	Указывает порт, который следует использовать при построении подключения к удаленному устройству. Значение порта по умолчанию — хорошо известный порт SSH 22 (для `transport=cli`) или порт 830 (для `transport=netconf`) устройства.
	username		Настраивает имя пользователя, используемое для аутентификации подключения к удаленному устройству. Это значение используется для аутентификации сеанса SSH. Если значение не указано в задании, используется значение переменной среды `ANSIBLE_NET_USERNAME`.
	password		Указывает пароль, используемый для аутентификации подключения к удаленному устройству. Это значение используется для аутентификации сеанса SSH. Если значение не указано в задании, используется значение переменной среды `ANSIBLE_NET_PASSWORD`.
	timeout	По умолчанию: 10	Указывает время ожидания в секундах для связи с сетевым устройством для подключения или отправки команд. Если время ожидания превышено до завершения операции, модуль выдаст ошибку.
	ssh_keyfile		Указывает SSH-ключ для аутентификации подключения к удаленному устройству. Это значение — путь к ключу, используемому для аутентификации сеанса SSH. Если значение не указано в задании, используется значение переменной среды `ANSIBLE_NET_SSH_KEYFILE`.
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 для устаревших playbooks.
Для получения информации об использовании 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

Статус

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

Техническое обслуживание

Этот модуль помечен как сетевой, что означает, что он поддерживается командой Ansible Network. Для получения дополнительной информации см. Поддержка и обслуживание модулей.

Список других модулей, также поддерживаемых командой Ansible Network, см. здесь.

Поддержка

Дополнительную информацию о поддержке этого модуля компанией 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.6/modules/junos_netconf_module.html