f5networks.f5_modules.bigip_network_globals – Управление глобальными настройками сети на BIG-IP

Примечание

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

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

Для использования в книге задач укажите: f5networks.f5_modules.bigip_network_globals.

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

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

Обзор

Модуль для управления глобальными настройками STP, Multicast, DAG, LLDP и Self Allow на BIG-IP.

Параметры

Параметр			Варианты/Значения по умолчанию	Комментарии
dag словарь				Управление глобальными настройками разбиения трафика.
	dag_ipv6_prefix_len целое число			Указывает, следует ли использовать SPDAG или DAG префикса IPv6 для разбиения трафика IPv6, когда хэш vlan cmp установлен на `src-ip` или `dst-ip`. Допустимый диапазон значений от 0 до 128, при значении `128` используется SPAG. Этот параметр доступен только в версии TMOS `13.x` и выше.
	icmp_hash строка		Варианты: icmp ipicmp	Указывает хэш ICMP для запросов и ответов ICMP echo в SW DAG. Когда `icmp`, запросы и ответы ICMP echo разделяются на основе идентификатора ICMP. Когда `ipicmp`, запросы и ответы ICMP echo разделяются на основе идентификатора ICMP и IP-адресов. Этот параметр доступен только в версии `TMOS` `13.x` и выше.
	round_robin_mode строка		Варианты: global local	Указывает, может ли агрегатор round robin (DAG) на блейде разделить пакеты со всеми TMM в системе или только с TMM, локальными для блейда. Когда `global`, DAG будет разбиения пакеты со всеми TMM в системе. Когда `local`, DAG будет разбиения пакеты только с локальными TMM блейда.
lldp словарь				Управление параметрами конфигурации LLDP.
	enabled булево		Варианты: no yes	Указывает текущий статус LLDP. Когда `yes`, LLDP включён глобально на устройстве. Когда `no`, LLDP отключён глобально на устройстве.
	max_neighbors_per_port целое число			Указывает максимальное количество соседей на порт. Допустимый диапазон значений от 0 до 65535.
	reinit_delay целое число			Указывает максимальное время ожидания в секундах после достижения интервала TTL перед сбросом таймера TTL. Допустимый диапазон значений от 0 до 65535.
	tx_delay целое число			Указывает время ожидания в секундах, пока LLDP не инициализируется на интерфейсе, прежде чем отправлять сообщение LLDP. Допустимый диапазон значений от 0 до 65535.
	tx_hold целое число			Указывает множитель, определяющий время жизни (TTL) LLDP. TTL определяется умножением этого значения на `tx_interval`. Допустимый диапазон значений от 0 до 65535.
	tx_interval целое число			Указывает интервал, который устройства используют для отправки информации LLDP с каждого из их интерфейсов. Допустимый диапазон значений от 0 до 65535.
multicast словарь				Управление параметрами конфигурации трафика multicast.
	max_pending_packets целое число			Указывает максимальное количество пакетов, ожидающих в очереди от имени одной неполной записи MFC. Допустимый диапазон значений от 0 до 4294967295.
	max_pending_routes целое число			Указывает количество неполных записей MFC, которые каждый TMM позволит существовать одновременно. Допустимый диапазон значений от 0 до 4294967295.
	rate_limit булево		Варианты: no yes	Когда `yes`, значение переменной DB `switchboard.maxmcastrate` управляет ограничением скорости multicast пакетов в секунду в коммутаторе.
	route_lookup_timeout целое число			Указывает максимальную продолжительность жизни неполной записи MFC в секундах. Допустимый диапазон значений от 0 до 4294967295.
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`.
self_allow словарь добавлен в 1.1.0 f5networks.f5_modules				Управление глобальными параметрами конфигурации Self Allow.
	all булево		Варианты: no yes	Устанавливает все или ничего порты и протоколы как системное глобальное `self_allow` значение. Когда `yes`, self_allow разрешает все протоколы и порты. Это эквивалентно установке параметра all в `TMSH`. Когда `no`, self_allow не разрешает никакие протоколы и порты. Это эквивалентно установке параметра none в `TMSH`.
	defaults список / элементы=словарь			Набор значений протоколов и портов по умолчанию, разрешенных для само IP, если значение self IP allow-service установлено в default.
		port целое число		Номер порта для установки. Допустимый диапазон значений от 0 до 65535.
		protocol строка		Имя протокола для установки.
stp словарь				Управление глобальными настройками STP на BIG-IP.
	config_name строка			Указывает имя конфигурации. Принимается длина от 1 до 32 символов. Эффективно только когда `mode` равно `mstp`.
	config_revision целое число			Указывает уровень пересмотра конфигурации MSTP, когда `mode` равно `mstp`. Вы должны указать число в диапазоне от 0 до 65535.
	description строка			Пользовательское описание.

fwd_delay integer		Количество секунд, в течение которых интерфейс был заблокирован от пересылки сетевого трафика после переконфигурации топологии дерева охваченности. Этот параметр не имеет эффекта при использовании режимов `rstp` или `mstp`, если все мосты в дереве охваченности используют протокол RSTP или MSTP. Если присутствуют мосты со старой технологией STP, соседние мосты должны перейти на старый протокол, время переконфигурации которого зависит от значения задержки пересылки. Допустимый диапазон значений — от 4 до 30.
hello_time integer		Указывает интервал времени в секундах между периодическими передачами, которые сообщают информацию о дереве охваченности соседним мостам в сети. Время hello, установленное по умолчанию на устройстве, является оптимальным практически во всех случаях. F5 рекомендует не изменять время hello. Допустимый диапазон значений — от 1 до 10.
max_age integer		Указывает количество секунд, в течение которых информация о дереве охваченности, полученная от других мостов, считается действительной. Допустимый диапазон значений — от 6 до 40 секунд.
max_hops integer		Указывает максимальное количество транзитов, которые может пройти пакет MSTP, прежде чем он будет отброшен. Этот параметр действует только при `mode` `mstp`. Количество транзитов должно находиться в диапазоне от 1 до 255.
mode string	Choices: disabled mstp passthru rstp stp	Указывает режим дерева охваченности. Параметры `mstp`, `rstp` и `stp` поддерживаются только на аппаратных платформах. Попытка установить эти режимы на платформах типа VE приведет к ошибке. Единственно допустимые параметры на платформах типа VE: `passthru` и `disabled`.
transmit_hold integer		Устанавливает абсолютный предел количества пакетов протокола дерева охваченности, которые система управления трафиком может передать на порту за любой интервал времени hello. Допустимый диапазон значений — от 1 до 10 пакетов.

Примечания

Примечание

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

Примеры

- name: Update STP settings
  bigip_network_globals:
    stp:
      config_name: foobar
      config_revision: 1
      max_hops: 20
      mode: mstp
    provider:
      password: secret
      server: lb.mydomain.com
      user: admin
  delegate_to: localhost

- name: Update DAG settings
  bigip_network_globals:
    dag:
      icmp_hash: ipicmp
      round_robin_mode: local
    provider:
      password: secret
      server: lb.mydomain.com
      user: admin
  delegate_to: localhost

- name: Update multiple settings
  bigip_network_globals:
    stp:
      config_name: foobar
      config_revision: 1
      max_hops: 20
      mode: mstp
    dag:
      icmp_hash: ipicmp
      round_robin_mode: local
    provider:
      password: secret
      server: lb.mydomain.com
      user: admin
  delegate_to: localhost

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

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

Ключевое слово			Возвращаемое значение	Описание
dag сложный			изменённое	Управление параметрами конфигурации трафика многоадресной рассылки. Пример: хеш/словарь значений
	dag_ipv6_prefix_len целое число		изменённое	Указывает, следует ли использовать SPDAG или DAG префикса IPv6 для разделения трафика IPv6. Пример: 128
	icmp_hash строка		изменённое	Указывает хеш ICMP для запроса ICMP-эха и ответа ICMP-эха в SW DAG. Пример: ipicmp
	round_robin_mode строка		изменённое	Режим работы DAG на блейде. Пример: локальный
lldp сложный			изменённое	Управление параметрами конфигурации трафика многоадресной рассылки. Пример: хеш/словарь значений
	enabled булево		изменённое	Текущий статус LLDP. Пример: True
	max_neighbors_per_port целое число		изменённое	Максимальное количество соседей на порт. Пример: 128
	reinit_delay целое число		изменённое	Максимальное время в секундах ожидания перед сбросом таймера TTL после достижения интервала TTL. Пример: 30
	tx_delay целое число		изменённое	Количество секунд ожидания инициализации LLDP на интерфейсе перед отправкой сообщения LLDP. Пример: 500
	tx_hold целое число		изменённое	Множитель, определяющий время жизни LLDP. Пример: 10
	tx_interval целое число		изменённое	Интервал, используемый устройствами для отправки информации LLDP с каждого из их интерфейсов. Пример: 240
multicast сложный			изменённое	Управление параметрами конфигурации трафика многоадресной рассылки. Пример: хеш/словарь значений
	max_pending_packets целое число		изменённое	Максимальное количество пакетов, помещенных в очередь от имени одной неполной записи MFC. Пример: 3000
	max_pending_routes целое число		изменённое	Количество неполных записей MFC, которые каждый TMM позволит существовать одновременно. Пример: 50
	rate_limit булево		изменённое	Включает контроль DB для ограничения скорости пакетов многоадресной рассылки в секунду на коммутаторе. Пример: True
	route_lookup_timeout целое число		изменённое	Максимальное время существования неполной записи MFC в секундах. Пример: 20
self_allow сложный			изменённое	Управление системными настройками self_allow. Пример: хеш/словарь значений
	all булево		изменённое	Разрешает все или ни один порт и протоколы в качестве системной настройки self_allow. Пример: True
	defaults сложный		изменённое	Набор по умолчанию протоколов и портов, разрешенных само IP. Пример: хеш/словарь значений
		port целое число	изменённое	Номер порта, который нужно установить. Пример: 443
		protocol строка	изменённое	Имя протокола, которое нужно установить. Пример: tcp
stp сложный			изменённое	Управление глобальными настройками STP на BIG-IP. Пример: хеш/словарь значений
	config_name строка		изменённое	Имя конфигурации. Пример: foobar
	config_revision целое число		изменённое	Уровень ревизии конфигурации MSTP. Пример: 2
	description строка		изменённое	Пользовательское описание. Пример: Моё описание
	fwd_delay целое число		изменённое	Количество секунд, в течение которых интерфейс был заблокирован от пересылки сетевого трафика. Пример: 4
	hello_time целое число		изменённое	Интервал в секундах между периодическими передачами информации о покрывающем дереве. Пример: 2
	max_age целое число		изменённое	Количество секунд, в течение которых полученная от других мостов информация о покрывающем дереве считается действительной. Пример: 30
	max_hops целое число		изменённое	Максимальное количество переходов, которые может пройти пакет MSTP перед его отбрасыванием. Пример: 15
	mode строка		изменённое	Режим покрывающего дерева. Пример: mstp
	transmit_hold целое число		изменённое	Ограничение количества STP, которое система управления трафиком может передавать на порт в любом интервале hello. Пример: 5

Авторы

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_network_globals_module.html