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 — не должны быть в активной конфигурации устройства.
|
Примеры
- 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']
|
Статус
Этот модуль помечен как preview, что означает, что его интерфейс не гарантирует обратную совместимость.
Поддержка
Дополнительную информацию о поддержке этого модуля 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.5/modules/net_system_module.html
