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 Team. См. Техническое обслуживание и поддержка модулей для получения дополнительной информации.

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

Поддержка

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