community.network.edgeos_config – Управление конфигурацией EdgeOS на удалённом устройстве

Примечание

Этот плагин входит в коллекцию community.network (версия 1.3.0).

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

Для использования в книге задач укажите: community.network.edgeos_config

Обзор
Параметры
Примечания
Примеры
Возвращаемые значения

Обзор

Этот модуль предоставляет управление файлами конфигурации устройств EdgeOS. Он предоставляет аргументы для управления как файлом конфигурации, так и состоянием активной конфигурации. Все команды конфигурации основаны на командах set и delete в конфигурации устройства.
Этот модуль предназначен для работы с сетью и требует connection: network_cli для корректной работы.
Дополнительную информацию можно найти в Руководстве по сети.

Примечание

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

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
backup boolean		Варианты: нет ← да	Аргумент `backup` создаст резервную копию текущей активной конфигурации устройства на контрольный хост Ansible перед внесением любых изменений. Если значение `backup_options` не задано, файл резервной копии будет расположен в папке backup в корневой директории книги задач или в корневой директории роли, если книга задач является частью роли ansible. Если директория не существует, она создаётся.
backup_options словарь			Это объект типа dict, содержащий конфигурируемые параметры, относящиеся к пути к файлу резервной копии. Значение этого параметра читается только при `backup` установлено в да. Если `backup` установлено в нет, этот параметр будет проигнорирован.
	dir_path путь		Этот параметр указывает путь, заканчивающийся именем директории, в которой будет храниться файл резервной копии конфигурации. Если директория не существует, она будет создана, а имя файла — это значение `filename` или имя файла по умолчанию, как описано в `filename` описание опций. Если значение пути не указано, будет создана папка backup в текущей рабочей директории, и резервная копия конфигурации будет скопирована в `filename` внутри папки backup.
	filename строка		Имя файла, которое будет использоваться для хранения резервной копии конфигурации. Если имя файла не указано, оно будет сгенерировано на основе имени хоста, текущей даты и времени в формате <имя_хоста>_config.<дата>@<время>
comment строка		По умолчанию: "настроено edgeos_config"	Позволяет указать описание коммита, которое будет включено при фиксации конфигурации. Если конфигурация не изменена или не фиксована, этот аргумент игнорируется.
config строка			Аргумент `config` указывает базу конфигурации для сравнения с желаемой конфигурацией. Если это значение не указано, модуль автоматически извлечёт текущую активную конфигурацию с удалённого устройства.
lines строка			Упорядоченный набор строк конфигурации, подлежащий управлению и сравнению с существующей конфигурацией на удалённом устройстве.
match строка		Варианты: строка ← нет	Аргумент `match` управляет методом сопоставления с текущей активной конфигурацией. По умолчанию, желаемая конфигурация сопоставляется с активной, и применяются изменения. Если аргумент `match` установлен в `none`, активная конфигурация игнорируется, и конфигурация всегда загружается.
save boolean		Варианты: нет ← да	Аргумент `save` управляет сохранением изменений в активной конфигурации на диске. Это независимо от фиксации конфигурации. При установке в `True`, активная конфигурация сохраняется.
src строка			Аргумент `src` указывает путь к исходному файлу конфигурации для загрузки. Исходный файл конфигурации может быть в формате с фигурными скобками или в заданном формате. Исходный файл может включать переменные шаблонов Jinja2.

Примечания

Примечание

Проверено на EdgeOS 1.9.7
Рекомендуется установить ANSIBLE_PERSISTENT_COMMAND_TIMEOUT в 30, так как команда сохранения может занимать больше времени, чем стандартные 10 секунд на некоторых аппаратных платформах EdgeOS.

Примеры

- name: Configure the remote device
  community.network.edgeos_config:
    lines:
      - set system host-name {{ inventory_hostname }}
      - set service lldp
      - delete service dhcp-server

- name: Backup and load from file
  community.network.edgeos_config:
    src: edgeos.cfg
    backup: yes

- name: Configurable backup path
  community.network.edgeos_config:
    src: edgeos.cfg
    backup: yes
    backup_options:
      filename: backup.cfg
      dir_path: /home/user

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

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

Ключ	Возвращаемое значение	Описание
backup_path строка	при backup = да	Полный путь к файлу резервной копии Пример: /playbooks/ansible/backup/edgeos_config.2016-07-16@22:28:34
commands список / элементы=строка	всегда	Список команд конфигурации, отправленных на устройство Пример: ['...', '...']

Авторы

Nathaniel Case (@Qalthos)
Sam Doran (@samdoran)

© 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/community/network/edgeos_config_module.html