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

Примечание

Этот плагин является частью коллекции junipernetworks.junos (версия 1.2.1).

Для его установки используйте: ansible-galaxy collection install junipernetworks.junos.

Для использования в книге задач укажите: junipernetworks.junos.junos_system.

Новое в версии 1.0.0: плагина junipernetworks.junos

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

Обзор

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

Примечание

У этого модуля есть соответствующий плагин действий.

Требования

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

ncclient (>=v0.5.2)

Параметры

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

Примечания

Примечание

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

Примеры

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

- name: remove configuration
  junipernetworks.junos.junos_system:
    state: absent

- name: configure name servers
  junipernetworks.junos.junos_system:
    name_servers:
    - 8.8.8.8
    - 8.8.4.4

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

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

Ключ	Возвращаемое значение	Описание
diff.prepared строка	при изменении конфигурации и включении параметра 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;

Авторы

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.10/collections/junipernetworks/junos/junos_system_module.html