f5networks.f5_modules.bigip_vlan – Управление VLAN на системе BIG-IP

Примечание

Этот плагин входит в коллекцию f5networks.f5_modules (версия 1.6.0).

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

Для использования в плейбуке укажите: f5networks.f5_modules.bigip_vlan.

Новая версия 1.0.0: модуля f5networks.f5_modules

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

Обзор

Управление VLAN на системе BIG-IP

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
cmp_hash строка		Варианты: default destination-address source-address dst-ip src-ip dest destination source dst src	Указывает, как происходит разделение трафика на VLAN. Выбранное значение определяет метод разделения трафика. Вы можете выбрать разделение трафика на основе `source-address` (исходный IP-адрес), `destination-address` (адрес назначения IP) или `default`, что определяет, что по умолчанию CMP хеширование использует порты L4. При создании новой VLAN, если этот параметр не указан, значение по умолчанию — `default`.
dag_round_robin булево		Варианты: no yes	Указывает, должен ли некоторый бессостоятельный трафик на VLAN разделяться в порядке круговой очереди вместо использования статического хеширования. Бессостоятельный трафик включает трафик L2, не являющийся IP, ICMP, некоторые протоколы UDP и так далее. При создании новой VLAN, если этот параметр не указан, значение по умолчанию — (no).
dag_tunnel строка		Варианты: inner outer	Указывает, как дистрибутор (DAG) распределяет полученные пакеты с туннельной инкапсуляцией по экземплярам TMM. Выберите `inner` для распределения пакетов на основе информации во внутренних заголовках. Выберите `outer` для распределения пакетов на основе информации во внешних заголовках без проверки внутренних заголовков. При создании новой VLAN, если этот параметр не указан, значение по умолчанию — `outer`. Этот параметр не поддерживается в виртуальных изданиях (VE) BIG-IP.
description строка			Описание VLAN.
fail_safe булево		Варианты: no yes	В случае `yes`, указывает, что VLAN принимает указанное `fail_safe_action` в случае обнаружения системой потери трафика на интерфейсах этой VLAN.
fail_safe_action строка		Варианты: reboot restart-all failover	Указывает действие, которое система выполняет, когда она не обнаруживает трафика на этой VLAN, и `fail_safe_timeout` истекло.
fail_safe_timeout целое число			Указывает количество секунд, которые система может работать без обнаружения сетевого трафика на этой VLAN, прежде чем она выполнит `fail_safe_action`.
hw_syn_cookie булево добавлен в 1.3.0 f5networks.f5_modules		Варианты: no yes	Включает режим hardware syncookie для VLAN. При `yes`, защита SYN cookie на уровне аппаратного обеспечения для каждой VLAN срабатывает, когда на поддерживаемых платформах достигается определенный порог трафика.
interfaces список / элементы=словарь			Интерфейсы, которые вы хотите добавить в VLAN. Это могут быть как интерфейсы с тегами, так и без тегов, как определяет параметр `tagging`. Этот параметр взаимоисключает параметры `untagged_interfaces` и `tagged_interfaces`.
	interface строка		Имя интерфейса
	tagging строка	Варианты: tagged untagged	Является ли интерфейс `tagged` или `untagged`.
mtu целое число			Указывает максимальный размер транспортного блока (MTU) для трафика на этой VLAN. При создании новой VLAN, если этот параметр не указан, используется значение по умолчанию `1500`. Это число должно быть от 576 до 9198.
name строка / обязательно			VLAN для управления. Если указана специальная VLAN `ALL` со значением `state` `absent`, все VLAN будут удалены.
partition строка		По умолчанию: "Common"	Раздел устройства для управления ресурсами.
provider словарь добавлен в 1.0.0 f5networks.f5_modules			Объект словаря, содержащий данные подключения.
	auth_provider строка		Настраивает поставщик аутентификации для получения токенов аутентификации от удаленного устройства. Этот параметр используется при работе с устройствами BIG-IQ.
	no_f5_teem булево	Варианты: no yes	Если `yes`, данные телеметрии TEEM не отправляются в F5. Вы можете пропустить этот параметр, установив переменную окружения `F5_TEEM`.
	password строка / обязательно		Пароль для учетной записи пользователя, используемой для подключения к BIG-IP. Вы можете пропустить этот параметр, установив переменную окружения `F5_PASSWORD`. псевдонимы: pass, pwd
	server строка / обязательно		Хост BIG-IP. Вы можете пропустить этот параметр, установив переменную окружения `F5_SERVER`.
	server_port целое число	По умолчанию: 443	Порт сервера BIG-IP. Вы можете пропустить этот параметр, установив переменную окружения `F5_SERVER_PORT`.
	timeout целое число		Указывает время ожидания в секундах для связи с сетевым устройством для подключения или отправки команд. Если время ожидания превышено до завершения операции, модуль выдаст ошибку.
	transport строка	Варианты: rest ←	Настраивает транспортное подключение для использования при подключении к удаленному устройству.
	user строка / обязательно		Имя пользователя для подключения к BIG-IP. Этот пользователь должен иметь права администратора на устройстве. Вы можете пропустить этот параметр, установив переменную окружения `F5_USER`.
	validate_certs булево	Варианты: no yes ←	Если `no`, сертификаты SSL не проверяются. Используйте это только на контролируемых вами сайтах с самозаверенными сертификатами. Вы можете пропустить этот параметр, установив переменную окружения `F5_VALIDATE_CERTS`.
sflow_poll_interval целое число			Указывает максимальный интервал в секундах между двумя опросами.
sflow_sampling_rate целое число			Указывает отношение наблюдаемых пакетов к сгенерированным образцам.
source_check булево		Варианты: no yes	При `yes`, указывает, что система проверяет, совпадает ли обратный маршрут к начальному пакету с VLAN, из которой пакет был отправлен. Система выполняет эту проверку только если параметр `auto_last_hop` равен `no`.
state строка		Варианты: absent present ←	Состояние VLAN в системе. При `present`, гарантирует, что VLAN существует с предоставленными атрибутами. При `absent`, удаляет VLAN из системы.
tag целое число			Номер тега для VLAN. Номер тега может быть любым целым числом от 1 до 4094. Система автоматически присваивает номер тега, если вы не указываете значение.
tagged_interfaces список / элементы=строка			Указывает список интерфейсов и каналов с тегами, которые вы хотите настроить для VLAN. Используйте интерфейсы с тегами или каналы, когда вы хотите назначить один интерфейс или канал нескольким VLAN. Этот параметр взаимоисключает параметры `untagged_interfaces` и `interfaces`. псевдонимы: tagged_interface
untagged_interfaces список / элементы=строка			Указывает список интерфейсов и каналов без тегов, которые вы хотите настроить для VLAN. Этот параметр взаимоисключает параметры `tagged_interfaces` и `interfaces`. псевдонимы: untagged_interface

Примечания

Примечание

Требуются версии BIG-IP >= 12.0.0
Дополнительную информацию об использовании Ansible для управления устройствами F5 Networks см. на странице https://www.ansible.com/integrations/networks/f5.
Требуется версия ПО BIG-IP >= 12.
Модули F5 изменяют только рабочую конфигурацию продукта F5. Чтобы убедиться, что конфигурация, специфичная для BIG-IP, сохранится на диске, обязательно включите хотя бы одну задачу, использующую модуль f5networks.f5_modules.bigip_config, для сохранения рабочей конфигурации. Обратитесь к документации модуля для правильного использования модуля для сохранения рабочей конфигурации.

Примеры

- name: Create VLAN
  bigip_vlan:
    name: net1
    provider:
      password: secret
      server: lb.mydomain.com
      user: admin
  delegate_to: localhost

- name: Set VLAN tag
  bigip_vlan:
    name: net1
    tag: 2345
    provider:
      user: admin
      password: secret
      server: lb.mydomain.com
  delegate_to: localhost

- name: Add VLAN 2345 as tagged to interface 1.1
  bigip_vlan:
    tagged_interface: 1.1
    name: net1
    tag: 2345
    provider:
      password: secret
      server: lb.mydomain.com
      user: admin
  delegate_to: localhost

- name: Add VLAN 1234 as tagged to interfaces 1.1 and 1.2
  bigip_vlan:
    tagged_interfaces:
      - 1.1
      - 1.2
    name: net1
    tag: 1234
    provider:
      user: admin
      password: secret
      server: lb.mydomain.com
  delegate_to: localhost

Значения возврата

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

Ключ	Возвращаемое значение	Описание
cmp_hash строка	изменено	Новый метод агрегирования трафика. Пример: source-address
dag_tunnel строка	изменено	Новое значение настройки туннеля DAG. Пример: outer
description строка	изменено	Описание, установленное для VLAN. Пример: VLAN foo
fail_safe булево	изменено	Новое значение настройки Fail Safe.
fail_safe_action строка	изменено	Новое значение настройки Fail Safe Action. Пример: reboot
fail_safe_timeout целое число	изменено	Новое значение настройки Fail Safe Timeout. Пример: 90
hw_syn_cookie булево	изменено	Включает режим аппаратного syncookie для VLAN.
interfaces список / элементы=строка	изменено	Интерфейсы, к которым назначена VLAN. Пример: ['1.1', '1.2']
partition строка	изменено	Раздел, на котором была создана VLAN. Пример: Common
sflow_poll_interval целое число	изменено	Новое значение настройки sFlow Polling Interval. Пример: 10
sflow_sampling_rate целое число	изменено	Новое значение настройки sFlow Sampling Rate. Пример: 20
source_check булево	изменено	Новое значение настройки Source Check. Пример: True
tag целое число	изменено	Идентификатор VLAN. Пример: 2345

Авторы

Tim Rupp (@caphrim007)
Wojciech Wypior (@wojtek0806)

© 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/f5networks/f5_modules/bigip_vlan_module.html