ansible.netcommon.net_system – (устаревшее, удалено после 2022-06-01) Управление системными атрибутами на сетевых устройствах

Примечание

Этот плагин входит в коллекцию ansible.netcommon (версия 1.4.1).

Для его установки используйте: ansible-galaxy collection install ansible.netcommon.

Для использования в книге задач укажите: ansible.netcommon.net_system.

Новое в версии 1.0.0: анsible.netcommon

УСТАРЕВШЕ
Описание
Параметры
Примечания
Примеры
Возвращаемые значения
Статус

УСТАРЕВШЕ

Удалено в: главной версии после 2022-06-01
Почему: Выпущены обновлённые модули с большей функциональностью
Альтернатива: Используйте платформозависимый модуль “[netos]_system”

Описание

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

Примечание

У этого модуля есть соответствующий плагин действий.

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
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
  ansible.netcommon.net_system:
    hostname: ios01
    domain_name: test.example.com
    domain_search:
    - ansible.com
    - redhat.com
    - cisco.com

- name: domain search on single domain
  ansible.netcommon.net_system:
    domain_search: ansible.com

- name: remove configuration
  ansible.netcommon.net_system:
    state: absent

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

- name: configure name servers
  ansible.netcommon.net_system:
    name_servers:
    - 8.8.8.8
    - 8.8.4.4

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

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

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

Статус

Этот модуль будет удалён в следующей версии после 2022-06-01. [устаревший]
Дополнительную информацию см. в УСТАРЕВШЕ.

Авторы

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.10/collections/ansible/netcommon/net_system_module.html