f5networks.f5_modules.bigip_tunnel – Управление туннелями на BIG-IP

Примечание

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

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

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

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

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

Обзор

Управляет туннелями на BIG-IP. Туннели обычно основаны на профиле туннеля, который определяет как значения по умолчанию, так и ограничения для туннеля.
Из-за этого модуль предоставляет ряд настроек, которые могут или могут не относиться к типу туннеля, с которым вы работаете. Важно учитывать это при объявлении конфигурации туннеля.
Если конкретный туннель не поддерживает параметр, который вы рассматриваете, в документации по параметру обычно об этом упоминается. В противном случае при настройке этого параметра на устройстве устройство уведомит вас.

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
auto_last_hop строка		Варианты: default enabled disabled	Позволяет настроить автоматическое определение последнего узла на основе каждого туннеля. При создании нового туннеля, если этот параметр поддерживается профилем туннеля, но не указан, значение по умолчанию — `default`. Когда `default`, система использует глобальную настройку auto-lasthop для отправки запроса обратно. Когда `enabled`, позволяет системе отправлять ответный трафик на MAC-адрес, который передал запрос, даже если таблица маршрутизации указывает на другую сеть или интерфейс. В результате система может отправлять ответный трафик клиентам даже при отсутствии соответствующего маршрута.
description строка			Описание туннеля.
key целое число			При применении к туннелю GRE это значение задает необязательное поле в заголовке GRE, используемое для проверки источника пакета. При применении к туннелю VXLAN или Geneve это значение задает идентификатор виртуальной сети (VNI). При применении к туннелю NVGRE это значение задает идентификатор виртуальной подсети (VSID). При создании нового туннеля, если этот параметр поддерживается профилем туннеля, но не указан, значение по умолчанию — `0`.
local_address строка			Указывает IP-адрес локального узла туннеля.
mode строка		Варианты: bidirectional inbound outbound	Указывает, как туннель переносит трафик. При создании нового туннеля, если этот параметр поддерживается профилем туннеля, но не указан, значение по умолчанию — `bidirectional`. При значении `bidirectional`, указывает, что туннель переносит входящий и исходящий трафик. При значении `inbound`, указывает, что туннель переносит только входящий трафик. При значении `outbound`, указывает, что туннель переносит только исходящий трафик.
mtu целое число			Указывает максимальный размер пакета (MTU) туннеля. При создании нового туннеля, если этот параметр поддерживается профилем туннеля, но не указан, значение по умолчанию — `0`. Допустимый диапазон от `0` до `65515`.
name строка / обязательно			Указывает имя туннеля.
partition строка		Значение по умолчанию: "Common"	Раздел устройства для управления ресурсами.
profile строка			Указывает профиль, который необходимо связать с туннелем для обработки трафика. В зависимости от выбора, другие параметры станут доступными или исчезнут. Этот параметр нельзя изменить после его установки.
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`.
remote_address строка			Указывает IP-адрес удалённого узла туннеля. Для `dslite`, `fec` (при настройке туннеля FEC для приема трафика только), `v6rd` (настроен как шлюз ретрансляции), или `map`, туннель должен иметь не указанный удаленный адрес (любой).
secondary_address строка			Указывает не плавающий IP-адрес для туннеля, который будет использоваться с трафиком, инициированным хостом.
state строка		Варианты: present ← absent	Если `present`, гарантирует существование туннеля. Если `absent`, гарантирует удаление туннеля.
tos строка			Указывает значение типа сервиса (TOS), которое нужно вставить в заголовок инкапсулированного пакета. При создании нового туннеля, если этот параметр поддерживается профилем туннеля, но не указан, значение по умолчанию — `preserve`. Если `preserve`, система копирует значение TOS из внутреннего заголовка во внешний заголовок. Вы также можете указать числовое значение. Возможные значения от `0` до `255`.
traffic_group строка			Указывает группу трафика, которую нужно связать с туннелем. Это значение нельзя изменить после установки. Это ограничение BIG-IP.
transparent булево		Варианты: no yes	Указывает, что туннель работает в прозрачном режиме. Если `yes`, вы можете проверять и изменять инкапсулированный трафик, проходящий через систему BIG-IP. Прозрачный туннель завершает туннель, создавая иллюзию, что туннель проходит через устройство без изменений (то есть система BIG-IP выглядит как промежуточный маршрутизатор, который просто маршрутизирует IP-трафик через устройство).
use_pmtu булево		Варианты: no yes	Включает или отключает использование информации PMTU (Path MTU), предоставленной сообщениями об ошибках ICMP NeedFrag. Если `yes` и туннель `mtu` установлен в `0`, туннель будет использовать информацию PMTU. Если `yes` и туннель `mtu` фиксирован на ненулевом значении, туннель будет использовать минимум PMTU и MTU. Если `no`, туннель будет использовать фиксированный MTU или рассчитать его MTU, используя настройки инкапсуляции туннеля.

Примечания

Примечание

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

Примеры

- name: Create a VXLAN tunnel
  bigip_tunnel:
    name: openshift-tunnel
    local_address: 192.1681.240
    key: 0
    secondary_address: 192.168.1.100
    mtu: 0
    use_pmtu: yes
    tos: preserve
    auto_last_hop: default
    traffic_group: traffic-group-1
    state: present
    provider:
      password: secret
      server: lb.mydomain.com
      user: admin
  delegate_to: localhost

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

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

Ключ	Возвращаемое значение	Описание
param1 boolean	изменённое	Новое значение параметра param1 ресурса. Пример: True
param2 string	изменённое	Новое значение параметра param2 ресурса. Пример: Foo is bar

Авторы

Tim Rupp (@caphrim007)

© 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_tunnel_module.html