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

Примечание

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

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

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

Новое в версии 1.0.0: из ansible.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–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/ansible/netcommon/net_system_module.html