Spec-Zone.ru › Ansible 2.10

f5networks.f5_modules.bigip_virtual_server – Управление виртуальными серверами LTM на BIG-IP

Примечание

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

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

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

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

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

Обзор

  • Управление виртуальными серверами LTM на системе BIG-IP.

Параметры

Параметр Варианты/Значения по умолчанию Комментарии
address_translation
boolean
    Варианты:
  • no
  • yes
При значении enabled, указывает, что система переводит адрес виртуального сервера.
При значении disabled, указывает, что система использует адрес без перевода.
Эта опция полезна при балансировке нагрузки на устройства с одинаковым IP-адресом.
При создании нового виртуального сервера значение по умолчанию - enabled.
bypass_module_checks
boolean
добавлено в 1.3.0 f5networks.f5_modules
    Варианты:
  • no ←
  • yes
Отключает все встроенные проверки модуля, требующие обращений к устройству BIG-IP. Использование этой опции сокращает количество запросов REST, выполняемых этим модулем. Недостаток заключается в том, что большинство параметров передаются как есть, что требует дополнительной осторожности при их определении.
Устройство является конечным источником достоверности таких конфигураций, полезно в тех случаях, когда приоритет отдается скорости перед точностью.
Если установлено значение yes, модуль игнорирует значение параметра check_profiles.
Этот параметр можно использовать при создании или обновлении ресурсов.
check_profiles
boolean
добавлено в 1.2.0 f5networks.f5_modules
    Варианты:
  • no
  • yes ←
Указывает, следует ли проверять правильность указанных пользователем профилей SSL клиента и сервера по отношению к существующим профилям. Это полезно в тех случаях, когда большое количество профилей добавляется сразу.
Не рекомендуется для обычного использования. В случае дублирования или ошибочных профилей BIG-IP выведет ошибку.
clone_pools
list / elements=dictionary
Указывает пул или список пулов, которые виртуальный сервер использует для репликации трафика с клиентской или серверной стороны.
Обычно эта опция используется для обнаружения вторжений.
context
string / required
    Варианты:
  • clientside
  • serverside
Параметр контекста для пула клонирования для репликации трафика с клиентской или серверной стороны.
pool_name
string / required
Имя пула, в который сервер реплицирует трафик.
Можно использовать только пулы, созданные в разделе «Общие» или в том же разделе, что и виртуальный сервер.
Ссылка на пул в разделе «Общие» должна быть в формате полного пути, например, /Common/pool_name.
default_persistence_profile
string
Профиль по умолчанию, который управляет сохранением сессий.
Если необходимо удалить существующий профиль сохранения сессий по умолчанию, укажите пустое значение; "". См. документацию для примера.
Если type является dhcp, этот параметр игнорируется.
description
string
Описание виртуального сервера.
destination
string
IP-адрес назначения виртуального сервера.
Требуется, когда state равно present и виртуальный сервер не существует.
Если type равно internal, этот параметр игнорируется. Для всех других типов он обязателен.
Также можно указать имя существующего виртуального адреса в качестве назначения.

псевдонимы: адрес, ip
disabled_vlans
list / elements=string
Список VLAN, которые нужно отключить. Если раздел не указан в VLAN, используется опция partition этого модуля.
Этот параметр несовместим с параметрами enabled_vlans.
enabled_vlans
list / elements=string
Список VLAN для включения. Если используется VLAN с именем all, разрешатся все VLAN. VLAN можно указывать с или без ведущего раздела. Если раздел не указан в VLAN, используется опция partition этого модуля.
Этот параметр несовместим с параметром disabled_vlans.
fallback_persistence_profile
string
Указывает профиль сохранения сессий, который система должна использовать, если не может использовать указанный профиль сохранения сессий по умолчанию.
Если необходимо удалить существующий резервный профиль сохранения сессий, укажите пустое значение; "". См. документацию для примера.
Если type равно dhcp, этот параметр игнорируется.
firewall_enforced_policy
string
Применяет указанную политику AFM к виртуальному серверу принудительно.
При создании нового виртуального сервера, если этот параметр не указан, принудительная политика отключена.
firewall_staged_policy
string
Применяет указанную политику AFM к виртуальному серверу принудительно.
Этапированная политика показывает результаты правил политики в журнале, но не применяет правила непосредственно к трафику.
При создании нового виртуального сервера, если этот параметр не указан, этапированная политика отключена.
insert_metadata
boolean
    Варианты:
  • no
  • yes ←
При значении no модуль не устанавливает метаданные на устройстве.
В настоящее время существует ограничение, что пользователи, не являющиеся администраторами, не могут устанавливать метаданные на объект, несмотря на возможность создания и изменения объектов виртуальных серверов. Установка этого параметра в no позволяет таким пользователям использовать этот модуль для управления объектами виртуальных серверов на устройстве.
ip_intelligence_policy
string
Указывает политику интеллектуального управления IP, применяемую к виртуальному серверу.
Этот параметр требует наличия и настройки соответствующего модуля безопасности BIG-IP, например, ASM или AFM.
ip_protocol
string
    Варианты:
  • ah
  • any
  • bna
  • esp
  • etherip
  • gre
  • icmp
  • ipencap
  • ipv6
  • ipv6-auth
  • ipv6-crypt
  • ipv6-icmp
  • isp-ip
  • mux
  • ospf
  • sctp
  • tcp
  • udp
  • udplite
Указывает имя сетевого протокола, который система должна использовать для направления трафика на этот виртуальный сервер.
При создании нового виртуального сервера, если этот параметр не указан, значение по умолчанию - tcp.
Настройка Протокола недоступна при выборе «Производительность (HTTP)» в качестве Type.
Значение этого аргумента можно указать как в числовом формате, так и в виде имени в определенном списке. Обратитесь к choices для примеров.
Список допустимых номеров IP-протоколов см. на https://en.wikipedia.org/wiki/List_of_IP_protocol_numbers.
Если type равно dhcp, этот модуль принудительно устанавливает параметр ip_protocol в 17 (UDP).
irules
list / elements=string
Указывает список правил, которые должны применяться в порядке приоритета.
Если необходимо удалить существующие iRules, укажите единственное пустое значение; "". См. документацию для примера.
Порядок, в котором указаны iRules, имеет значение, поэтому список с одинаковыми элементами, но в другом порядке в скрипте, внесёт изменения на устройстве.
Если type равно dhcp, stateless, reject или internal, этот параметр игнорируется.

псевдонимы: все_правила
mask
string
Указывает маску сети адреса назначения. Этот параметр работает с IPv4 и IPv6 адресами.
Этот параметр является необязательным и может быть указан при создании или обновлении виртуального сервера.
Если destination задано в формате CIDR и mask предоставлено, параметр mask имеет приоритет.
Если вы указали универсальное назначение (например, 0.0.0.0 для IPv4, :: для IPv6), параметр mask устанавливается соответственно в any или any6.
Если destination не в формате CIDR и mask не указано, устанавливаются значения 255.255.255.255 или ffff:ffff:ffff:ffff:ffff:ffff:ffff:ffff для IPv4 и IPv6 соответственно.
Если destination указано в формате CIDR и mask не указано, маска выводится из destination.
Если destination указано как имя виртуального адреса, а mask не указано, маска будет равна None, позволяя устройству установить её по своим внутренним настройкам.
metadata
raw
Произвольные пары ключ-значение, которые вы можете прикрепить к виртуальному серверу. Это полезно в ситуациях, когда вы хотите добавить аннотации к виртуальному серверу для управления Ansible.
Имена ключей хранятся в виде строк; это включает имена, которые являются числами.
Значения для всех ключей хранятся в виде строк; это включает значения, которые являются числами.
Данные сохраняются, а не являются временными.
mirror
boolean
    Варианты:
  • no
  • yes
Указывает, что система дублирует подключения на каждом члене дублирующей пары.
При создании нового виртуального сервера, если этот параметр не указан, значение по умолчанию - disabled.
name
string / required
Имя виртуального сервера.

псевдонимы: vs
Раздел
строка
По умолчанию:
"Общие"
Раздел устройства для управления ресурсами.
Политики
список / элементы=строка
Указывает политики для виртуального сервера.
Когда type равно dhcp, reject или internal, этот параметр игнорируется.

Псевдонимы: все_политики
Пул
строка
Пул по умолчанию для виртуального сервера.
Если вы хотите удалить существующий пул, укажите пустое значение; "". См. документацию для примера.
При создании нового виртуального сервера и type равно stateless, этот параметр обязателен.
Если type равно stateless, pool не должно содержать элементов, определяющих rate_limit.
Порт
строка
Порт виртуального сервера. Требуется, когда state равно present и виртуальный сервер не существует.
Если вы не хотите указывать определенный порт, используйте значение 0. Это означает, что виртуальный сервер прослушивает любой порт.
Когда type равно dhcp, этот модуль принудительно устанавливает параметр port в значение 67.
Когда type равно internal, этот модуль принудительно устанавливает параметр port в значение 0.
В дополнение к указанию номера порта, также можно указать несколько имён служб.
Строка ftp может быть использована для порта 21.
Строка http может быть использована для порта 80.
Строка https может быть использована для порта 443.
Строка telnet может быть использована для порта 23.
Строка smtp может быть использована для порта 25.
Строка snmp может быть использована для порта 161.
Строка snmp-trap может быть использована для порта 162.
Строка ssh может быть использована для порта 22.
Строка tftp может быть использована для порта 69.
Строка isakmp может быть использована для порта 500.
Строка mqtt может быть использована для порта 1883.
Строка mqtt-tls может быть использована для порта 8883.
Перевод_порта
логический
    Варианты:
  • нет
  • да
Если enabled, система переводит порт виртуального сервера.
Если disabled, система использует порт без перевода. Отключение перевода портов для виртуального сервера полезно, если вы хотите использовать виртуальный сервер для балансировки соединений с любой службой.
При создании нового виртуального сервера значение по умолчанию — enabled.
Профили
сырые
Список профилей (HTTP, ClientSSL, ServerSSL и т.д.) для применения к обеим сторонам соединения (клиентская и серверная стороны).
Если вы хотите применить определённый профиль только к клиентской стороне соединения, укажите client-side для context профиля.
Если вы хотите применить определённый профиль только к серверной стороне соединения, укажите server-side для context профиля.
Если context не указан, он будет по умолчанию all.
Если вы хотите удалить профиль из списка активных на виртуальном сервере, просто удалите его из списка profiles. Примеры иллюстрируют это.
Если вы хотите добавить профиль в список активных профилей на виртуальном сервере, просто добавьте его в список profiles. Примеры иллюстрируют это.
Профили важны. Этот модуль не сможет настроить BIG-IP, если вы неправильно используете профили или попытаетесь установить IP-протокол, который не поддерживается текущими или новыми профилями. Как этот модуль, так и BIG-IP сообщат об ошибке, если это неверно, что будет похоже на lists profiles incompatible with its protocol.
Если вы не уверены, какие сочетания профилей правильные, мы рекомендуем иметь доступный BIG-IP, в котором вы можете вносить изменения и копировать корректные комбинации.

Псевдонимы: все_профили
Контекст
строка
    Варианты:
  • все ←
  • серверная_сторона
  • клиентская_сторона
Сторона соединения, на которую должен быть применён профиль.
Имя
строка
Имя профиля.
Это необходимо, если указан контекст.
Если это не указано, предполагается, что элемент профиля — только имя профиля.
Поставщик
словарь
добавлен в 1.0.0 от f5networks.f5_modules
Объект словаря, содержащий сведения о подключении.
Поставщик_аутентификации
строка
Настраивает поставщика аутентификации для получения маркеров аутентификации с удалённого устройства.
Этот параметр действительно используется при работе с устройствами BIG-IQ.
Без_f5_teem
логический
    Варианты:
  • нет
  • да
Если yes, данные телеметрии TEEM не отправляются в F5.
Вы можете опустить этот параметр, установив переменную окружения F5_TEEM.
Пароль
строка / обязательно
Пароль для учётной записи пользователя, используемой для подключения к BIG-IP.
Вы можете опустить этот параметр, установив переменную окружения F5_PASSWORD.

Псевдонимы: пароль, pass, pwd
Сервер
строка / обязательно
Хост BIG-IP.
Вы можете опустить этот параметр, установив переменную окружения F5_SERVER.
Порт_сервера
целое
По умолчанию:
443
Порт сервера BIG-IP.
Вы можете опустить этот параметр, установив переменную окружения F5_SERVER_PORT.
Таймаут
целое
Устанавливает таймаут в секундах для связи с сетевым устройством при подключении или отправке команд. Если таймаут истечёт до завершения операции, модуль вернёт ошибку.
Транспорт
строка
    Варианты:
  • rest ←
Настраивает транспортное соединение, используемое при подключении к удалённому устройству.
Пользователь
строка / обязательно
Имя пользователя для подключения к BIG-IP. Этот пользователь должен иметь административные права на устройстве.
Вы можете опустить этот параметр, установив переменную окружения F5_USER.
Проверять_сертификаты
логический
    Варианты:
  • нет
  • да ←
Если no, сертификаты SSL не проверяются. Используйте это только на сайтах под вашим контролем, использующих самоподписанные сертификаты.
Вы можете опустить этот параметр, установив переменную окружения F5_VALIDATE_CERTS.
Предел_скорости
целое
Предел скорости виртуального сервера (соединения в секунду). Установка этого значения в 0 отключает лимит.
Допустимый диапазон значений — 0 — 4294967295.
Предел_скорости_маска_назначения
целое
Указывает маску в битах, применяемую к адресу назначения в рамках ограничения скорости.
Значение по умолчанию — 0, что эквивалентно использованию всего адреса — 32 в IPv4 или 128 в IPv6.
Допустимый диапазон значений — 0 — 4294967295.
Режим_ограничения_скорости
строка
    Варианты:
  • объект ←
  • источник_объекта
  • назначение_объекта
  • источник-назначение_объекта
  • назначение
  • источник
  • источник-назначение
Указывает, применяется ли ограничение скорости на основе виртуального объекта, адреса источника, адреса назначения или их комбинации.
Значение по умолчанию — object, которое не использует адрес источника или назначения в качестве части ключа.
Предел_скорости_маска_источника
целое
Указывает маску в битах, применяемую к адресу источника в рамках ограничения скорости.
Значение по умолчанию — 0, что эквивалентно использованию всего адреса — 32 в IPv4 или 128 в IPv6.
Допустимый диапазон значений — 0 — 4294967295.
security_log_profiles
список / elements=строка
Указывает профиль журнала, применяемый к виртуальному серверу.
Для использования этой функции модуль AFM должен быть лицензирован и настроен.
Log all requests и Log illegal requests взаимоисключающие, поэтому этот модуль генерирует ошибку, если они указаны вместе.
security_nat_policy
словарь
Указывает политики NAT брандмауэра для виртуального сервера.
Вы можете указать одну или несколько политик NAT для использования.
Используется наиболее специфичная политика. Например, если вы укажете, что виртуальный сервер должен использовать политику устройства и политику домена маршрутизации, политика домена маршрутизации переопределяет политику устройства.
policy
строка
Указывает политику для прямого применения политики NAT к виртуальному серверу.
Политика NAT виртуального сервера является наиболее специфичной и переопределяет политику домена маршрутизации и политику устройства, если они указаны.
Для удаления политики укажите пустое значение.
use_device_policy
булево
    Варианты:
  • нет
  • да
Указывает, что виртуальный сервер использует политику NAT устройства, как указано в параметрах брандмауэра.
Политика устройства используется, если не указана политика домена маршрутизации или настройка NAT виртуального сервера.
use_route_domain_policy
булево
    Варианты:
  • нет
  • да
Указывает, что виртуальный сервер использует политику домена маршрутизации, как указано в настройках безопасности домена маршрутизации.
При указании политика домена маршрутизации переопределяет политику устройства и переопределяется политикой виртуального сервера.
snat
строка
Политика адреса исходной сети.
Когда type равно dhcp, reject или internal, этот параметр игнорируется.
Можно указать имя пула SNAT (например, "/Common/snat_pool_name"), чтобы включить SNAT с указанным пулом.
Для удаления SNAT укажите слово none.
Для указания автосопоставления используйте слово automap.
source
строка
Указывает IP-адрес или сеть, из которой виртуальный сервер принимает трафик.
Виртуальный сервер принимает клиентов только с одного из этих IP-адресов.
Для эффективной работы этой настройки укажите значение, отличное от 0.0.0.0/0 или ::/0 (то есть любой/0, любой6/0).
Для максимальной полезности этой настройки укажите наиболее специфичные префиксы адресов, охватывающие все адреса клиентов и только их.
Укажите IP-адрес в формате CIDR (Classless Inter-Domain Routing); адрес/префикс, где длина префикса указана в битах. Например, для IPv4: 10.0.0.1/32 или 10.0.0.0/24, а для IPv6: ffe1::0020/64 или 2001:ed8:77b5:2:10:10:100:42/64.
source_port
строка
    Варианты:
  • сохранить
  • сохранить-строго
  • изменить
Указывает, сохраняет ли система исходный порт соединения.
При создании нового виртуального сервера, если этот параметр не указан, значение по умолчанию — preserve.
state
строка
    Варианты:
  • present ←
  • absent
  • enabled
  • disabled
Состояние виртуального сервера. Если absent, удаляет виртуальный сервер, если он существует. Если present, создает виртуальный сервер и включает его. Если enabled, включает виртуальный сервер, если он существует. Если disabled, создает виртуальный сервер при необходимости и устанавливает состояние в disabled.
type
строка
    Варианты:
  • стандартный ←
  • forwarding-l2
  • forwarding-ip
  • performance-http
  • performance-l4
  • stateless
  • reject
  • dhcp
  • internal
  • message-routing
Указывает сетевую услугу, предоставляемую этим виртуальным сервером.
При создании нового виртуального сервера, если этот параметр не указан, значение по умолчанию — standard.
Это значение нельзя изменить после его установки.
Когда standard, указывает виртуальный сервер, который направляет трафик клиента в пул балансировки нагрузки, и является наиболее базовым типом виртуального сервера. Когда вы впервые создаете виртуальный сервер, вы назначаете ему существующий пул по умолчанию. После этого виртуальный сервер автоматически направляет трафик в этот пул по умолчанию.
Когда forwarding-l2, указывает виртуальный сервер, который разделяет один и тот же IP-адрес, что и узел в связанной VLAN.
Когда forwarding-ip, указывает виртуальный сервер, подобный другим виртуальным серверам, за исключением того, что у виртуального сервера нет членов пула для балансировки нагрузки. Виртуальный сервер просто передает пакет непосредственно целевому IP-адресу, указанному в запросе клиента.
Когда performance-http, указывает виртуальный сервер, с которым вы связываете профиль Fast HTTP. Вместе виртуальный сервер и профиль увеличивают скорость обработки виртуальным сервером запросов HTTP.
Когда performance-l4, указывает виртуальный сервер, с которым вы связываете профиль Fast L4. Вместе виртуальный сервер и профиль увеличивают скорость обработки виртуальным сервером запросов уровня 4.
Когда stateless, указывает виртуальный сервер, который принимает трафик, соответствующий адресу виртуального сервера, и балансирует нагрузку пакета для членов пула без попытки сопоставления пакета с уже существующим соединением в таблице соединений. Новые соединения сразу же удаляются из таблицы соединений. Это отвечает требованию одностороннего трафика UDP, который нужно обрабатывать с очень высокой пропускной способностью, например, балансировки нагрузки syslog трафика в пуле серверов syslog. Бессостоятельные виртуальные серверы не подходят для обработки трафика, требующего отслеживания состояния, такого как трафик TCP. Бессостоятельные виртуальные серверы не поддерживают iRules, сохранение состояния, дублирование соединений, ограничение скорости или автосопоставление SNAT.
Когда reject, указывает, что система BIG-IP отклоняет любой трафик, предназначенный для IP-адреса виртуального сервера.
Когда dhcp, указывает виртуальный сервер, который пересылает запросы DHCP-клиентов об IP-адресе одному или нескольким DHCP-серверам и предоставляет ответы DHCP-серверов с доступным IP-адресом для клиента.
Когда internal, указывает виртуальный сервер, который поддерживает модификацию запросов и ответов HTTP. Внутренние виртуальные серверы позволяют использовать серверы ICAP (Internet Content Adaptation Protocol) для модификации запросов и ответов HTTP путем создания и применения профиля ICAP и добавления профилей Request Adapt или Response Adapt к виртуальному серверу.
Когда message-routing, указывает виртуальный сервер, использующий протокол приложения SIP и функционирующий в соответствии с профилем сессии SIP и профилем SIP-маршрутизатора.

Примечания

Примечание

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

Примеры

- name: Modify Port of the Virtual Server
  bigip_virtual_server:
    state: present
    partition: Common
    name: my-virtual-server
    port: 8080
    provider:
      server: lb.mydomain.net
      user: admin
      password: secret
  delegate_to: localhost

- name: Delete virtual server
  bigip_virtual_server:
    state: absent
    partition: Common
    name: my-virtual-server
    provider:
      server: lb.mydomain.net
      user: admin
      password: secret
  delegate_to: localhost

- name: Add virtual server
  bigip_virtual_server:
    state: present
    partition: Common
    name: my-virtual-server
    destination: 10.10.10.10
    port: 443
    pool: my-pool
    snat: Automap
    description: Test Virtual Server
    profiles:
      - http
      - fix
      - name: clientssl
        context: server-side
      - name: ilx
        context: client-side
    policies:
      - my-ltm-policy-for-asm
      - ltm-uri-policy
      - ltm-policy-2
      - ltm-policy-3
    enabled_vlans:
      - /Common/vlan2
    provider:
      server: lb.mydomain.net
      user: admin
      password: secret
  delegate_to: localhost

- name: Add FastL4 virtual server
  bigip_virtual_server:
    destination: 1.1.1.1
    name: fastl4_vs
    port: 80
    profiles:
      - fastL4
    state: present
    provider:
      server: lb.mydomain.net
      user: admin
      password: secret
  delegate_to: localhost

- name: Add iRules to the Virtual Server
  bigip_virtual_server:
    name: my-virtual-server
    irules:
      - irule1
      - irule2
    provider:
      server: lb.mydomain.net
      user: admin
      password: secret
  delegate_to: localhost

- name: Remove one iRule from the Virtual Server
  bigip_virtual_server:
    name: my-virtual-server
    irules:
      - irule2
    provider:
      server: lb.mydomain.net
      user: admin
      password: secret
  delegate_to: localhost

- name: Remove all iRules from the Virtual Server
  bigip_virtual_server:
    name: my-virtual-server
    irules: ""
    provider:
      server: lb.mydomain.net
      user: admin
      password: secret
  delegate_to: localhost

- name: Remove pool from the Virtual Server
  bigip_virtual_server:
    name: my-virtual-server
    pool: ""
    provider:
      server: lb.mydomain.net
      user: admin
      password: secret
  delegate_to: localhost

- name: Add metadata to virtual
  bigip_pool:
    state: absent
    name: my-pool
    partition: Common
    metadata:
      ansible: 2.4
      updated_at: 2017-12-20T17:50:46Z
    provider:
      server: lb.mydomain.com
      user: admin
      password: secret
  delegate_to: localhost

- name: Add virtual with two profiles
  bigip_pool:
    state: absent
    name: my-pool
    partition: Common
    profiles:
      - http
      - tcp
    provider:
      server: lb.mydomain.com
      user: admin
      password: secret
  delegate_to: localhost

- name: Remove HTTP profile from previous virtual
  bigip_pool:
    state: absent
    name: my-pool
    partition: Common
    profiles:
      - tcp
    provider:
      server: lb.mydomain.com
      user: admin
      password: secret
  delegate_to: localhost

- name: Add the HTTP profile back to the previous virtual
  bigip_pool:
    state: absent
    name: my-pool
    partition: Common
    profiles:
      - http
      - tcp
    provider:
      server: lb.mydomain.com
      user: admin
      password: secret
  delegate_to: localhost

- name: Add virtual server with rate limit
  bigip_virtual_server:
    state: present
    partition: Common
    name: my-virtual-server
    destination: 10.10.10.10
    port: 443
    pool: my-pool
    snat: Automap
    description: Test Virtual Server
    profiles:
      - http
      - fix
      - name: clientssl
        context: server-side
      - name: ilx
        context: client-side
    policies:
      - my-ltm-policy-for-asm
      - ltm-uri-policy
      - ltm-policy-2
      - ltm-policy-3
    enabled_vlans:
      - /Common/vlan2
    rate_limit: 400
    rate_limit_mode: destination
    rate_limit_dst_mask: 32
    provider:
      server: lb.mydomain.net
      user: admin
      password: secret
  delegate_to: localhost

- name: Add FastL4 virtual server with clone_pools
  bigip_virtual_server:
    destination: 1.1.1.1
    name: fastl4_vs
    port: 80
    profiles:
      - fastL4
    state: present
    clone_pools:
      - pool_name: FooPool
        context: clientside
    provider:
      server: lb.mydomain.net
      user: admin
      password: secret
  delegate_to: localhost

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

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

Ключ Возвращаемое Описание
address_translation
boolean
изменённое
Новое значение, указывающее, включена ли трансляция адресов или выключена.

Пример:
True
clone_pools
список / элементы=строка
изменённое
Пулы, в которые виртуальный сервер копирует трафик.

Пример:
[{'context': 'clientside', 'pool_name': '/Common/Pool1'}]
default_persistence_profile
строка
изменённое
Установленный профиль персистенции по умолчанию на виртуальном сервере.

Пример:
/Common/dest_addr
description
строка
изменённое
Новое описание виртуального сервера.

Пример:
Это моё описание
destination
строка
изменённое
Цель виртуального сервера.

Пример:
1.1.1.1
disabled
boolean
изменённое
Включен или выключен виртуальный сервер.

Пример:
True
disabled_vlans
список / элементы=строка
изменённое
Список VLAN, для которых виртуальный сервер отключён.

Пример:
['/Common/vlan1', '/Common/vlan2']
enabled
boolean
изменённое
Включён или выключён виртуальный сервер.

enabled_vlans
список / элементы=строка
изменённое
Список VLAN, для которых виртуальный сервер включён.

Пример:
['/Common/vlan5', '/Common/vlan6']
fallback_persistence_profile
строка
изменённое
Установленный резервный профиль персистенции на виртуальном сервере.

Пример:
/Common/source_addr
firewall_enforced_policy
строка
изменённое
Новый принудительный профиль брандмауэра.

Пример:
/Common/my-enforced-fw
firewall_staged_policy
строка
изменённое
Новый подготавливаемый профиль брандмауэра.

Пример:
/Common/my-staged-fw
ip_intelligence_policy
строка
изменённое
Новый профиль IP Intelligence, назначенный виртуальному серверу.

Пример:
/Common/ip-intelligence
ip_protocol
целое число
изменённое
Новое значение IP протокола.

Пример:
6
irules
список / элементы=строка
изменённое
Настроенные iRules на виртуальном сервере.

Пример:
['/Common/irule1', '/Common/irule2']
metadata
словарь
изменённое
Новое значение виртуального сервера.

Пример:
{'key1': 'foo', 'key2': 'bar'}
mirror
boolean
изменённое
Указывает, что система зеркалит подключения на каждом члене дублирующей пары.

Пример:
True
policies
список / элементы=строка
изменённое
Список профилей, прикреплённых к виртуальному серверу.

Пример:
['/Common/policy1', '/Common/policy2']
pool
строка
изменённое
Пул, к которому прикреплён виртуальный сервер.

Пример:
/Common/my-pool
port
целое число
изменённое
Порт, на котором виртуальный сервер настроен на прослушивание.

Пример:
80
port_translation
boolean
изменённое
Новое значение, указывающее, включена ли трансляция портов или выключена.

Пример:
True
profiles
список / элементы=строка
изменённое
Список профилей, установленных на виртуальном сервере.

Пример:
[{'context': 'server-side', 'name': 'tcp'}, {'context': 'client-side', 'name': 'tcp-legacy'}]
rate_limit
целое число
изменённое
Максимальное количество подключений в секунду, разрешённых для виртуального сервера.

Пример:
5000
rate_limit_dst_mask
целое число
изменённое
Устанавливает маску в битах, применяемую к адресу назначения в рамках ограничения скорости.

Пример:
32
rate_limit_mode
строка
изменённое
Устанавливает тип ограничения скорости, используемый на виртуальном сервере.

Пример:
object-source
rate_limit_src_mask
целое число
изменённое
Устанавливает маску в битах, применяемую к источнику адреса в рамках ограничения скорости.

Пример:
32
security_log_profiles
список / элементы=строка
изменённое
Новый список профилей журналов безопасности.

Пример:
['/Common/profile1', '/Common/profile2']
snat
строка
изменённое
Настройка SNAT виртуального сервера.

Пример:
Automap
source
строка
изменённое
Установленный адрес источника на виртуальном сервере в формате CIDR.

Пример:
1.2.3.4/32
source_port
строка
изменённое
Указывает, сохраняет ли система исходный порт подключения.

Пример:
change


Авторы

  • Tim Rupp (@caphrim007)
  • Wojciech Wypior (@wojtek0806)
  • Nitin Khanna (@nitinthewiz)

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

Spec-Zone.ru

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