Spec-Zone.ru › Ansible 2.5

cnos_vlan — Управление ресурсами и атрибутами VLAN на устройствах, работающих под управлением Lenovo CNOS

Новая версия с 2.3.

  • Описание
  • Параметры
  • Примечания
  • Примеры
  • Возвращаемые значения
  • Статус
    • Автор

Описание

  • Этот модуль позволяет работать с конфигурациями, связанными с VLAN. Используемые операторы перегружены, чтобы обеспечить контроль над конфигурациями VLAN коммутатора. На первом уровне конфигурации VLAN можно настроить диапазон VLAN, сохранение тегов VLAN, карту доступа VLAN и фильтр карты доступа. После прохождения этого уровня есть пять аргументов VLAN, которые будут выполнять дальнейшую конфигурацию. Это vlanArg1, vlanArg2, vlanArg3, vlanArg4 и vlanArg5. Значение vlanArg1 определит способ оценки последующих аргументов. Более подробную информацию о том, как использовать эти аргументы, см. в [Перегруженные переменные]. Этот модуль использует SSH для управления конфигурацией сетевого устройства. Результаты операции будут помещены в каталог с именем «results», который должен быть создан пользователем в локальном каталоге, где выполняется playbook. Дополнительную информацию об этом модуле от Lenovo и настройку его использования для ваших задач, пожалуйста, посетите http://systemx.lenovofiles.com/help/index.jsp?topic=%2Fcom.lenovo.switchmgt.ansible.doc%2Fcnos_vlan.html

Параметры

Параметр Варианты/Значения по умолчанию Комментарии
deviceType
обязательный

(добавлено в 2.3)
    Варианты:
  • g8272_cnos
  • g8296_cnos
  • g8332_cnos
  • NE1072T
  • NE1032
  • NE1032T
  • NE10032
  • NE2572
Значение по умолчанию:
None
Указывает тип устройства, на котором выполняется метод. Варианты NE1072T, NE1032, NE1032T, NE10032, NE2572 добавлены с версии 2.4
enablePassword
(добавлено в 2.3)
Значение по умолчанию:
None
Настраивает пароль, используемый для входа в режим командной строки глобальной конфигурации на коммутаторе. Если коммутатор не запрашивает этот пароль, параметр игнорируется. Хотя, как правило, значение должно поступать из файла инвентаризации, вы также можете указать его как переменную. Этот параметр необязателен. Если он не указан, значение по умолчанию не будет использоваться.
host
обязательный

(добавлено в 2.3)
Значение по умолчанию:
None
Эта переменная используется для поиска файла хостов в /etc/ansible/hosts и определения IP-адреса устройства, на котором будет применена шаблон. Обычно в playbook используется ключевое слово Ansible {{ inventory_hostname }} как абстракция группы сетевых элементов, которые необходимо настроить.
outputfile
обязательный

(добавлено в 2.3)
Значение по умолчанию:
None
Указывает путь к файлу, в котором сохраняется вывод каждой команды. Здесь сохраняются каждая команда, указанная в объединённом файле шаблона, и каждый ответ от устройства. Обычно расположение находится в папке results, но вы можете выбрать другое расположение в зависимости от ваших прав записи.
password
обязательный

(добавлено в 2.3)
Значение по умолчанию:
None
Настраивает пароль, используемый для аутентификации подключения к удалённому устройству. Значение параметра password используется для аутентификации сессии SSH. Хотя, как правило, значение должно поступать из файла инвентаризации, вы также можете указать его как переменную. Этот параметр необязателен. Если он не указан, значение по умолчанию не будет использоваться.
username
обязательный

(добавлено в 2.3)
Значение по умолчанию:
None
Настраивает имя пользователя, используемое для аутентификации подключения к удалённому устройству. Значение параметра username используется для аутентификации сессии SSH. Хотя, как правило, значение должно поступать из файла инвентаризации, вы также можете указать его как переменную. Этот параметр необязателен. Если он не указан, значение по умолчанию не будет использоваться.
vlanArg1
обязательный
    Варианты:
  • access-map
  • dot1q
  • filter
  • <1-3999> Идентификатор VLAN 1-3999 или диапазон
Значение по умолчанию:
None
Это перегруженный первый аргумент vlan. Использование этого аргумента можно найти в руководстве пользователя, указанном выше.
vlanArg2
    Варианты:
  • Имя карты доступа VLAN
  • только-выход
  • имя
  • распространение
  • состояние
  • ip
Значение по умолчанию:
None
Это перегруженный второй аргумент vlan. Использование этого аргумента можно найти в руководстве пользователя, указанном выше.
vlanArg3
    Варианты:
  • действие
  • соответствие
  • статистика
  • ввод идентификатора VLAN или диапазона vlan
  • имя VLAN в ASCII
  • ipv4 или ipv6
  • активно или приостановлено
  • быстрый выход
  • интервал запроса последнего члена
  • mrouter
  • querier
  • таймаут querier
  • интервал запроса
  • максимальное время ответа запроса
  • подавление отчетов
  • значение переменной устойчивости
  • количество запросов, отправленных при запуске
  • интервал запроса при запуске
  • статическая группа
Значение по умолчанию:
None
Это перегруженный третий аргумент vlan. Использование этого аргумента можно найти в руководстве пользователя, указанном выше.
vlanArg4
    Варианты:
  • отбросить или передать или перенаправить
  • ip или mac
  • Интервал в секундах
  • ethernet
  • порт-агрегация
  • IP-адрес querier
  • таймаут querier в секундах
  • интервал запроса в секундах
  • максимальное время ответа запроса в секундах
  • значение переменной устойчивости
  • количество запросов, отправленных при запуске
  • интервал запроса при запуске
Значение по умолчанию:
None
Это перегруженный четвёртый аргумент vlan. Использование этого аргумента можно найти в руководстве пользователя, указанном выше.
vlanArg5
    Варианты:
  • имя списка доступа
  • номер слота/корпуса
  • номер агрегации портов
Значение по умолчанию:
None
Это перегруженный пятый аргумент vlan. Использование этого аргумента можно найти в руководстве пользователя, указанном выше.

Примечания

Примечание

  • Дополнительную информацию об использовании Ansible для управления сетевыми устройствами Lenovo см. на https://www.ansible.com/ansible-lenovo.

Примеры

Tasks: The following are examples of using the module cnos_vlan. These are written in the main.yml file of the tasks directory.
---
- name: Test Vlan - Create a vlan, name it
  cnos_vlan:
      host: "{{ inventory_hostname }}"
      username: "{{ hostvars[inventory_hostname]['ansible_ssh_user'] }}"
      password: "{{ hostvars[inventory_hostname]['ansible_ssh_pass'] }}"
      deviceType: "{{ hostvars[inventory_hostname]['deviceType'] }}"
      enablePassword: "{{ hostvars[inventory_hostname]['enablePassword'] }}"
      outputfile: "./results/test_vlan_{{ inventory_hostname }}_output.txt"
      vlanArg1: 13
      vlanArg2: "name"
      vlanArg3: "Anil"

- name: Test Vlan - Create a vlan, Flood configuration
  cnos_vlan:
      host: "{{ inventory_hostname }}"
      username: "{{ hostvars[inventory_hostname]['ansible_ssh_user'] }}"
      password: "{{ hostvars[inventory_hostname]['ansible_ssh_pass'] }}"
      deviceType: "{{ hostvars[inventory_hostname]['deviceType'] }}"
      enablePassword: "{{ hostvars[inventory_hostname]['enablePassword'] }}"
      outputfile: "./results/test_vlan_{{ inventory_hostname }}_output.txt"
      vlanArg1: 13
      vlanArg2: "flood"
      vlanArg3: "ipv4"

- name: Test Vlan - Create a vlan, State configuration
  cnos_vlan:
      host: "{{ inventory_hostname }}"
      username: "{{ hostvars[inventory_hostname]['ansible_ssh_user'] }}"
      password: "{{ hostvars[inventory_hostname]['ansible_ssh_pass'] }}"
      deviceType: "{{ hostvars[inventory_hostname]['deviceType'] }}"
      enablePassword: "{{ hostvars[inventory_hostname]['enablePassword'] }}"
      outputfile: "./results/test_vlan_{{ inventory_hostname }}_output.txt"
      vlanArg1: 13
      vlanArg2: "state"
      vlanArg3: "active"

- name: Test Vlan - VLAN Access map1
  cnos_vlan:
      host: "{{ inventory_hostname }}"
      username: "{{ hostvars[inventory_hostname]['ansible_ssh_user'] }}"
      password: "{{ hostvars[inventory_hostname]['ansible_ssh_pass'] }}"
      deviceType: "{{ hostvars[inventory_hostname]['deviceType'] }}"
      enablePassword: "{{ hostvars[inventory_hostname]['enablePassword'] }}"
      outputfile: "./results/test_vlan_{{ inventory_hostname }}_output.txt"
      vlanArg1: "access-map"
      vlanArg2: "Anil"
      vlanArg3: "statistics"

- name: Test Vlan - VLAN Accep Map2
  cnos_vlan:
      host: "{{ inventory_hostname }}"
      username: "{{ hostvars[inventory_hostname]['ansible_ssh_user'] }}"
      password: "{{ hostvars[inventory_hostname]['ansible_ssh_pass'] }}"
      deviceType: "{{ hostvars[inventory_hostname]['deviceType'] }}"
      enablePassword: "{{ hostvars[inventory_hostname]['enablePassword'] }}"
      outputfile: "./results/test_vlan_{{ inventory_hostname }}_output.txt"
      vlanArg1: "access-map"
      vlanArg2: "Anil"
      vlanArg3: "action"
      vlanArg4: "forward"

- name: Test Vlan - ip igmp snooping query interval
  cnos_vlan:
      host: "{{ inventory_hostname }}"
      username: "{{ hostvars[inventory_hostname]['ansible_ssh_user'] }}"
      password: "{{ hostvars[inventory_hostname]['ansible_ssh_pass'] }}"
      deviceType: "{{ hostvars[inventory_hostname]['deviceType'] }}"
      enablePassword: "{{ hostvars[inventory_hostname]['enablePassword'] }}"
      outputfile: "./results/test_vlan_{{ inventory_hostname }}_output.txt"
      vlanArg1: 13
      vlanArg2: "ip"
      vlanArg3: "query-interval"
      vlanArg4: 1313

- name: Test Vlan - ip igmp snooping mrouter interface port-aggregation 23
  cnos_vlan:
      host: "{{ inventory_hostname }}"
      username: "{{ hostvars[inventory_hostname]['ansible_ssh_user'] }}"
      password: "{{ hostvars[inventory_hostname]['ansible_ssh_pass'] }}"
      deviceType: "{{ hostvars[inventory_hostname]['deviceType'] }}"
      enablePassword: "{{ hostvars[inventory_hostname]['enablePassword'] }}"
      outputfile: "./results/test_vlan_{{ inventory_hostname }}_output.txt"
      vlanArg1: 13
      vlanArg2: "ip"
      vlanArg3: "mrouter"
      vlanArg4: "port-aggregation"
      vlanArg5: 23

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

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

Ключ Возвращаемое значение Описание
msg
строка
всегда
Сообщение об успехе или об ошибке

Пример:
Конфигурация VLAN выполнена


Статус

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

Автор

  • Anil Kumar Muraleedharan (@amuraleedhar)

Подсказка

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

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

Spec-Zone.ru

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