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 — не должны быть в активной конфигурации устройства.

Примечания

Примечание

Этот модуль поддерживается на ansible_network_os сетевых платформах. Подробности см. в разделе Варианты сетевой платформы.

Примеры

- 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. [сетевой]

Поддержка 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.8/modules/net_system_module.html