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

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

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

Описание

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

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
domain_name -		Настройка имени домена IP на удаленном устройстве на предоставленное значение. Значение должно быть в формате имени с точками и будет добавлено к `hostname`, чтобы создать полное доменное имя.
domain_search -		Предоставляет список суффиксов домена, которые необходимо добавить к имени хоста для целей разрешения имен. Этот аргумент принимает список имен и будет согласован с текущей активной конфигурацией на работающем узле.
hostname -		Настройка параметра имени хоста устройства. Этот параметр принимает значение ASCII-строки.
lookup_source -		Предоставляет один или несколько исходных интерфейсов для выполнения DNS-поиска. Интерфейс, указанный в `lookup_source`, должен быть действующим интерфейсом, настроенным на устройстве.
name_servers -		Список DNS-серверов по IP-адресу для выполнения поиска разрешения имен. Этот аргумент принимает либо список DNS-серверов. См. примеры.
state -	Варианты: present ← absent	Состояние значений конфигурации в текущей активной конфигурации устройства. При установке в present значения должны быть настроены в активной конфигурации устройства, а при установке в absent значения не должны находиться в активной конфигурации устройства

Примеры

- name: configure hostname and domain name
  net_system:
    hostname: ios01
    domain_name: test.example.com
    domain-search:
      - ansible.com
      - redhat.com
      - cisco.com

- name: remove configuration
  net_system:
    state: absent

- name: configure DNS lookup sources
  net_system:
    lookup_source: MgmtEth0/0/CPU0/0

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

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

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

Ключ	Возвращаемое значение	Описание
commands список	всегда, за исключением платформ, использующих транспорт Netconf для управления устройством.	Список команд режима конфигурации, которые необходимо отправить устройству Пример: ['hostname ios01', 'ip domain name test.example.com']

Статус

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

Поддержка Red Hat

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

Авторы

Ricardo Carrillo Cruz (@rcarrillocruz)

Подсказка

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

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.7/modules/net_system_module.html