junos_system – Управление атрибутами системы на устройствах Juniper JUNOS

Новое в версии 2.4.

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

Обзор

Этот модуль обеспечивает декларативное управление атрибутами системы узла на устройствах Juniper JUNOS. Он предоставляет возможность настроить параметры системы хоста или удалить эти параметры из активной конфигурации устройства.

Требования

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

ncclient (>=v0.5.2)

Параметры

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

Примечания

Примечание

Для этого модуля требуется, чтобы служба netconf системы была включена на удалённом управляемом устройстве.
Тестировано на vSRX JUNOS версии 15.1X49-D15.4, vqfx-10000 JUNOS версии 15.1X53-D60.4.
Рекомендуемое подключение — netconf. См. руководство по вариантам платформы Junos OS.
Этот модуль также работает с подключениями local для устаревших playbook.
Сведения об использовании CLI и netconf см. в руководстве Junos OS Platform Options guide
Дополнительную информацию об использовании Ansible для управления сетевыми устройствами см. в руководстве Ansible Network Guide
Дополнительную информацию об использовании Ansible для управления сетевыми устройствами Juniper см. на странице https://www.ansible.com/ansible-juniper.

Примеры

- name: configure hostname and domain name
  junos_system:
    hostname: junos01
    domain_name: test.example.com
    domain-search:
      - ansible.com
      - redhat.com
      - juniper.com

- name: remove configuration
  junos_system:
    state: absent

- name: configure name servers
  junos_system:
    name_servers:
      - 8.8.8.8
      - 8.8.4.4

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

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

Ключ	Возвращаемое значение	Описание
diff.prepared string	при изменении конфигурации и включении опции diff.	Разница в конфигурации до и после применения изменений. Пример: [edit system] + host-name test; + domain-name ansible.com; + domain-search redhat.com; [edit system name-server] 172.26.1.1 { ... } + 8.8.8.8;

Статус

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

Поддержка Red Hat

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

Авторы

Ganesh Nalawade (@ganeshrn)

Подсказка

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

© 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_system_module.html