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

Примечание

Этот модуль входит в коллекцию f5networks.f5_modules (версия 1.39.0).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.

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

Чтобы использовать коллекцию в плейбуке, укажите: f5networks.f5_modules.bigip_network_globals.

Добавлено в f5networks.f5_modules 1.0.0

Краткое описание
Параметры
Примечания
Примеры
Возвращаемые значения

Краткое описание

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

Параметры

Параметр	Комментарии
dag dictionary	Управление глобальными настройками распределения трафика.
dag_ipv6_prefix_len integer	Определяет, следует ли использовать SPDAG или DAG с префиксом IPv6 для распределения трафика IPv6, если для vlan cmp hash задано значение `src-ip` или `dst-ip`. Допустимый диапазон значений — от 0 до 128; при значении `128` используется SPAG. Этот параметр доступен только в TMOS версии `13.x` и выше.
icmp_hash string	Указывает хеш ICMP для эхо-запросов и эхо-ответов ICMP в SW DAG. При значении `icmp` эхо-запросы и эхо-ответы ICMP распределяются на основе идентификатора ICMP. При значении `ipicmp` эхо-запросы и эхо-ответы ICMP распределяются на основе идентификатора ICMP и IP-адресов. Этот параметр доступен только в версии `TMOS` `13.x` и выше. Допустимые значения: `"icmp"` `"ipicmp"`
round_robin_mode string	Определяет, может ли распределитель round robin (DAG) на линейной карте распределять пакеты на все TMM системы или только на TMM, локальные для этой линейной карты. При значении `global` DAG распределяет пакеты на все TMM системы. При значении `local` DAG распределяет пакеты только на TMM, локальные для этой линейной карты. Допустимые значения: `"global"` `"local"`
lldp dictionary	Управление параметрами конфигурации LLDP.
enabled boolean	Указывает текущее состояние LLDP. При значении `true` LLDP включен на устройстве глобально. При значении `false` LLDP отключен на устройстве глобально. Допустимые значения: `false` `true`
max_neighbors_per_port integer	Указывает максимальное количество соседних устройств на порт. Допустимый диапазон значений — от 0 до 65535.
reinit_delay integer	Указывает максимальное количество секунд ожидания после достижения интервала TTL перед сбросом таймера TTL. Допустимый диапазон значений — от 0 до 65535.
tx_delay integer	Указывает количество секунд ожидания инициализации LLDP на интерфейсе перед отправкой сообщения LLDP. Допустимый диапазон значений — от 0 до 65535.
tx_hold integer	Указывает множитель, определяющий время жизни LLDP (TTL). TTL определяется умножением этого значения на `tx_interval`. Допустимый диапазон значений — от 0 до 65535.
tx_interval integer	Указывает интервал отправки устройствами информации LLDP с каждого из интерфейсов. Допустимый диапазон значений — от 0 до 65535.
multicast dictionary	Управление параметрами конфигурации многоадресного трафика.
max_pending_packets integer	Указывает максимальное количество пакетов, поставленных в очередь для одной незавершенной записи MFC. Допустимый диапазон — от 0 до 4294967295.
max_pending_routes integer	Указывает количество незавершенных записей MFC, которые каждый TMM может одновременно хранить. Допустимый диапазон — от 0 до 4294967295.
rate_limit boolean	При значении `true` параметр переменной БД `switchboard.maxmcastrate` определяет ограничение скорости многоадресных пакетов в секунду на коммутаторе. Допустимые значения: `false` `true`
route_lookup_timeout integer	Указывает максимальное время жизни незавершенной записи MFC в секундах. Допустимый диапазон — от 0 до 4294967295.
provider dictionary добавлено в f5networks.f5_modules 1.0.0	Объект dict, содержащий сведения о подключении.
auth_provider string	Настраивает поставщика аутентификации для получения токенов аутентификации с удаленного устройства. Этот параметр используется преимущественно при работе с устройствами BIG-IQ.
no_f5_teem boolean	Если `yes`, телеметрические данные TEEM не отправляются в F5. Этот параметр можно не указывать, задав переменную окружения `F5_TELEMETRY_OFF`. Ранее использовавшаяся переменная `F5_TEEM` устарела из-за неоднозначного имени. Допустимые значения: `false` ← (по умолчанию) `true`
password псевдонимы: pass, pwd string / обязательный	Пароль учетной записи, используемой для подключения к BIG-IP или BIG-IQ. Этот параметр можно не указывать, задав переменную окружения `F5_PASSWORD`.
server string / обязательный	Имя хоста BIG-IP или BIG-IQ. Этот параметр можно не указывать, задав переменную окружения `F5_SERVER`.
server_port integer	Порт сервера BIG-IP. Этот параметр можно не указывать, задав переменную окружения `F5_SERVER_PORT`. По умолчанию: `443`
timeout integer	Задает тайм-аут в секундах для обмена данными с сетевым устройством при подключении или отправке команд. Если время ожидания истекает до завершения операции, модуль выдаст ошибку.
transport string	Настраивает транспортное соединение, используемое для подключения к удаленному устройству. Допустимые значения: `"rest"` ← (по умолчанию)
user string / обязательный	Имя пользователя для подключения к BIG-IP или BIG-IQ. У этого пользователя должны быть права администратора на устройстве. Этот параметр можно не указывать, задав переменную окружения `F5_USER`.
validate_certs boolean	Если `no`, сертификаты SSL не проверяются. Используйте этот параметр только на контролируемых вами сайтах с самоподписанными сертификатами. Этот параметр можно не указывать, задав переменную окружения `F5_VALIDATE_CERTS`. Допустимые значения: `false` `true` ← (по умолчанию)
self_allow dictionary добавлено в f5networks.f5_modules 1.1.0	Управление глобальными параметрами конфигурации Self Allow.
all boolean	Задает для всех портов и протоколов значение all или none в качестве общесистемного параметра `self_allow`. При значении `true` параметр self_allow разрешает все протоколы и порты. Это эквивалентно заданию параметра all в `TMSH`. При значении `false` параметр self_allow не разрешает ни один протокол и порт. Это эквивалентно заданию параметра none в `TMSH`. Допустимые значения: `false` `true`
defaults list / элементы=dictionary	Набор протоколов и портов по умолчанию, разрешенных для Self IP, если для параметра allow-service Self IP задано значение default.
port integer	Номер порта, который нужно задать. Допустимый диапазон значений — от 0 до 65535.
protocol string	Имя протокола, которое нужно задать.
stp dictionary	Управление глобальными настройками STP на BIG-IP.
config_name string	Указывает имя конфигурации. Допустимая длина — от 1 до 32 символов. Действует только в том случае, если `mode` имеет значение `mstp`.
config_revision integer	Указывает уровень редакции конфигурации MSTP, если `mode` имеет значение `mstp`. Необходимо указать число в диапазоне от 0 до 65535.
description string	Описание, заданное пользователем.
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	Указывает режим связующего дерева. Параметры `mstp`, `rstp` и `stp` поддерживаются только на аппаратных платформах. Попытка задать эти режимы на платформах типа VE завершится ошибкой. На платформах типа VE допустимы только параметры `passthru` и `disabled`. Допустимые значения: `"disabled"` `"mstp"` `"passthru"` `"rstp"` `"stp"`
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 complex	Управление параметрами конфигурации многоадресного трафика. Возвращается: changed Пример: `"hash/dictionary of values"`
dag_ipv6_prefix_len integer	Указывает, следует ли использовать SPDAG или DAG с префиксом IPv6 для распределения трафика IPv6. Возвращается: changed Пример: `128`
icmp_hash string	Указывает хеш ICMP для эхо-запроса и эхо-ответа ICMP в SW DAG. Возвращается: changed Пример: `"ipicmp"`
round_robin_mode string	Режим работы DAG на линейной карте. Возвращается: changed Пример: `"local"`
lldp complex	Управление параметрами конфигурации многоадресного трафика. Возвращается: changed Пример: `"hash/dictionary of values"`
enabled boolean	Текущий статус LLDP. Возвращается: changed Пример: `true`
max_neighbors_per_port integer	Максимальное количество соседей на порт. Возвращается: changed Пример: `128`
reinit_delay integer	Максимальное количество секунд ожидания перед сбросом таймера TTL по истечении интервала TTL. Возвращается: changed Пример: `30`
tx_delay integer	Количество секунд ожидания инициализации LLDP на интерфейсе перед отправкой сообщения LLDP. Возвращается: changed Пример: `500`
tx_hold integer	Множитель, определяющий время жизни LLDP. Возвращается: changed Пример: `10`
tx_interval integer	Интервал, с которым устройства отправляют информацию LLDP с каждого из своих интерфейсов. Возвращается: changed Пример: `240`
multicast complex	Управление параметрами конфигурации многоадресного трафика. Возвращается: changed Пример: `"hash/dictionary of values"`
max_pending_packets integer	Максимальное количество пакетов, поставленных в очередь для одной незавершённой записи MFC. Возвращается: changed Пример: `3000`
max_pending_routes integer	Количество незавершённых записей MFC, которые могут одновременно существовать для каждого TMM. Возвращается: changed Пример: `50`
rate_limit boolean	Включает управление ограничением скорости многоадресных пакетов в секунду на коммутаторе с помощью переменной базы данных. Возвращается: changed Пример: `true`
route_lookup_timeout integer	Максимальное время жизни незавершённой записи MFC в секундах. Возвращается: changed Пример: `20`
self_allow complex	Управляет общесистемными настройками self_allow. Возвращается: changed Пример: `"hash/dictionary of values"`
all boolean	Разрешает все порты и протоколы либо запрещает их все в рамках общесистемной настройки self_allow. Возвращается: changed Пример: `true`
defaults complex	Набор протоколов и портов, разрешённых по умолчанию для self IP. Возвращается: changed Пример: `"hash/dictionary of values"`
port integer	Номер порта, который необходимо задать. Возвращается: changed Пример: `443`
protocol string	Имя протокола, которое необходимо задать. Возвращается: changed Пример: `"tcp"`
stp complex	Управление глобальными настройками STP на BIG-IP. Возвращается: changed Пример: `"hash/dictionary of values"`
config_name string	Имя конфигурации. Возвращается: changed Пример: `"foobar"`
config_revision integer	Уровень ревизии конфигурации MSTP. Возвращается: changed Пример: `2`
description string	Описание, заданное пользователем. Возвращается: changed Пример: `"My description"`
fwd_delay integer	Количество секунд, в течение которых интерфейсу запрещена передача сетевого трафика. Возвращается: changed Пример: `4`
hello_time integer	Интервал в секундах между периодическими передачами информации о связующем дереве. Возвращается: changed Пример: `2`
max_age integer	Количество секунд, в течение которых информация о связующем дереве, полученная от других мостов, считается действительной. Возвращается: changed Пример: `30`
max_hops integer	Максимальное количество переходов, которое может пройти пакет MSTP до отбрасывания. Возвращается: changed Пример: `15`
mode string	Режим связующего дерева. Возвращается: changed Пример: `"mstp"`
transmit_hold integer	Ограничение на количество пакетов STP, которые система управления трафиком может передать через порт за один интервал hello time. Возвращается: changed Пример: `5`

Авторы

Wojciech Wypior (@wojtek0806)

Ссылки на коллекцию

© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/f5networks/f5_modules/bigip_network_globals_module.html