Spec-Zone.ru › Ansible 2.6

ce_config - Управление разделами конфигурации Huawei CloudEngine.

Новое в версии 2.4.

  • Обзор
  • Параметры
  • Примеры
  • Возвращаемые значения
  • Статус
  • Техническое обслуживание
    • Автор

Обзор

  • Конфигурации Huawei CloudEngine используют простой синтаксис блочного отступа для разделения конфигурации на секции. Этот модуль предоставляет реализацию для работы с секциями конфигурации CloudEngine детерминированным способом. Этот модуль работает с транспортом CLI.

Параметры

Параметр Варианты/Значения по умолчанию Комментарии
after
Упорядоченный набор команд, которые нужно добавить в конец стека команд, если требуется внести изменения. Как и в случае с before, это позволяет разработчику плейбука добавить набор команд, которые нужно выполнить после набора команд.
backup
bool
    Варианты:
  • no ←
  • yes
Этот аргумент заставит модуль создать полную резервную копию текущей current-configuration с удаленного устройства перед внесением каких-либо изменений. Файл резервной копии записывается в папку backup в корневом каталоге плейбука. Если папка не существует, она создается.
before
Упорядоченный набор команд, которые нужно поместить в стек команд, если требуется внести изменения. Это позволяет разработчику плейбука выполнить команды конфигурации до внесения каких-либо изменений, не влияя на способ сопоставления набора команд с системой.
config
Модуль по умолчанию подключается к удаленному устройству и получает текущую текущую конфигурацию для использования в качестве базы для сравнения с содержимым источника. В некоторых случаях нежелательно, чтобы задача получала текущую конфигурацию для каждой задачи в плейбуке. Аргумент config позволяет разработчику передать конфигурацию для использования в качестве базовой конфигурации для сравнения.
defaults
bool
    Варианты:
  • no ←
  • yes
Аргумент defaults повлияет на то, как собирается текущая конфигурация с устройства. При значении true команда, используемая для сбора текущей конфигурации, дополняется словом all. При значении false команда выполняется без слова all.
lines
Упорядоченный набор команд, которые должны быть сконфигурированы в разделе. Команды должны быть такими же, как и в текущей конфигурации устройства. Обратите внимание на синтаксис команд конфигурации, так как некоторые команды автоматически изменяются анализатором конфигурации устройства.
match
    Варианты:
  • line ←
  • strict
  • exact
  • none
Указывает модулю способ выполнения сопоставления набора команд с текущей конфигурацией устройства. Если match установлено в line, команды сопоставляются построчно. Если match установлено в strict, строки команд сопоставляются относительно положения. Если match установлено в exact, строки команд должны быть идентичны. Наконец, если match установлено в none, модуль не будет пытаться сравнивать исходную конфигурацию с текущей конфигурацией на удаленном устройстве.
parents
Упорядоченный набор родительских элементов, которые однозначно идентифицируют раздел или иерархию, по которым следует проверять команды. Если аргумент parents опущен, команды проверяются по отношению к набору команд верхнего уровня или глобальных команд.
replace
    Варианты:
  • line ←
  • block
Указывает модулю способ выполнения конфигурации на устройстве. Если аргумент replace установлен в line, измененные строки отправляются устройству в режиме конфигурации. Если аргумент replace установлен в block, весь блок команд отправляется на устройство в режиме конфигурации, если какая-либо строка неверна.
save
bool
    Варианты:
  • no ←
  • yes
Аргумент save инструктирует модуль сохранить текущую конфигурацию в сохраненную конфигурацию. Эта операция выполняется после внесения любых изменений в текущую рабочую конфигурацию. Если изменений не было, конфигурация все равно сохраняется в конфигурации запуска. Этот параметр всегда заставит модуль вернуть измененное значение.
src
Аргумент src предоставляет путь к файлу конфигурации, который нужно загрузить в удаленную систему. Путь может быть полным системным путем к файлу конфигурации, если значение начинается с /, или относительным к корню реализованного роли или плейбука. Этот аргумент взаимоисключающий с аргументами lines и parents.

Примеры

# Note: examples below use the following provider dict to handle
#       transport and authentication to the node.

- name: CloudEngine config test
  hosts: cloudengine
  connection: local
  gather_facts: no
  vars:
    cli:
      host: "{{ inventory_hostname }}"
      port: "{{ ansible_ssh_port }}"
      username: "{{ username }}"
      password: "{{ password }}"
      transport: cli

  tasks:
  - name: "Configure top level configuration and save it"
    ce_config:
      lines: sysname {{ inventory_hostname }}
      save: yes
      provider: "{{ cli }}"

  - name: "Configure acl configuration and save it"
    ce_config:
      lines:
        - rule 10 permit source 1.1.1.1 32
        - rule 20 permit source 2.2.2.2 32
        - rule 30 permit source 3.3.3.3 32
        - rule 40 permit source 4.4.4.4 32
        - rule 50 permit source 5.5.5.5 32
      parents: acl 2000
      before: undo acl 2000
      match: exact
      provider: "{{ cli }}"

  - name: "Configure acl configuration and save it"
    ce_config:
      lines:
        - rule 10 permit source 1.1.1.1 32
        - rule 20 permit source 2.2.2.2 32
        - rule 30 permit source 3.3.3.3 32
        - rule 40 permit source 4.4.4.4 32
      parents: acl 2000
      before: undo acl 2000
      replace: block
      provider: "{{ cli }}"

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

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

Ключ Возвращаемое значение Описание
backup_path
string
при backup = yes
Полный путь к файлу резервной копии

Пример:
/playbooks/ansible/backup/ce_config.2016-07-16@22:28:34
updates
list
Только при указании lines.
Набор команд, которые будут отправлены на удаленное устройство

Пример:
['...', '...']


Статус

Этот модуль помечен как preview, что означает, что его интерфейс не гарантируется как обратная совместимость.

Техническое обслуживание

Этот модуль помечен как community, что означает, что он поддерживается сообществом Ansible. Дополнительную информацию см. в Разделе поддержки модулей.

Список других модулей, которые также поддерживаются сообществом Ansible, см. здесь.

Автор

  • QijunPan (@CloudEngine-Ansible)

Подсказка

Если вы заметили какие-либо проблемы в этой документации, вы можете отредактировать этот документ, чтобы улучшить его.

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.6/modules/ce_config_module.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API