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

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

Обзор
- Требования
Параметры
Примечания
Примеры
Возвращаемые значения
Статус
Техническое обслуживание
- Поддержка
- Автор

Обзор

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

Требования

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

ncclient (>=v0.5.2)

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
active bool		Варианты: нет да ←	Указывает, активна или деактивирована конфигурация.
domain_name			Настраивает доменное имя IP на удаленном устройстве на предоставленное значение. Значение должно быть в формате имени с точками и будет добавлено к `hostname` для создания полностью квалифицированного доменного имени.
domain_search			Предоставляет список суффиксов доменов, которые следует добавить к имени хоста для целей разрешения имен. Этот аргумент принимает список имен и будет согласован с текущей активной конфигурацией на работающем узле.
hostname			Настройка параметра имени хоста устройства. Этот параметр принимает значение ASCII-строки.
name_servers			Список DNS-серверов по IP-адресу для использования при выполнении поисков разрешения имен. Этот аргумент принимает список DNS-серверов. См. примеры.
provider			Устаревшее свойство Начиная с Ansible 2.5, рекомендуется использовать `connection: network_cli` или `connection: netconf`. Для получения дополнительной информации см. руководство по платформе Junos OS Junos OS Platform Options guide. Объект словаря, содержащий сведения о подключении.
	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	Состояние значений конфигурации в текущей активной конфигурации устройства. При установке в present значения должны быть настроены в активной конфигурации устройства, а при установке в absent — нет.

Примечания

Примечание

Для работы этого модуля требуется, чтобы на управляемом удаленном устройстве был включен сетевой сервис netconf.
Проверено на vSRX JUNOS версии 15.1X49-D15.4, vqfx-10000 JUNOS версии 15.1X53-D60.4.
Рекомендуемое подключение — netconf. См. параметры Junos OS Platform Options.
Этот модуль также работает с подключениями local для устаревших playbooks.
Сведения о работе с 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 строка	при изменении конфигурации и включенном параметре 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 по работе с сетями. См. поддержку и техническое обслуживание модулей для получения дополнительной информации.

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

Поддержка

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

Автор

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