Spec-Zone.ru › Ansible

Модуль f5networks.f5_modules.bigip_virtual_server — управление виртуальными серверами LTM на 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_virtual_server.

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

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

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

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

Параметры

Параметр

Комментарии

address_translation

boolean

Если установлено значение enabled, указывает, что система преобразует адрес виртуального сервера.

Если установлено значение disabled, указывает, что система использует адрес без преобразования.

Этот параметр полезен, когда система распределяет нагрузку между устройствами с одинаковым IP-адресом.

При создании нового виртуального сервера значение по умолчанию — enabled.

Варианты:

  • false
  • true

auto_last_hop

string

добавлено в f5networks.f5_modules 1.13.0

Позволяет системе BIG-IP отслеживать MAC-адрес источника входящих соединений и отправлять ответный трафик из пулов на MAC-адрес источника независимо от таблицы маршрутизации.

Варианты:

  • "default"
  • "enabled"
  • "disabled"

bypass_module_checks

boolean

добавлено в f5networks.f5_modules 1.3.0

Отключает все встроенные проверки модуля, требующие обращений к устройству BIG-IP. Использование этого параметра сокращает количество REST-вызовов, выполняемых модулем. Компромисс заключается в том, что большинство параметров передаются без изменений, поэтому при их задании требуется особая осторожность.

Окончательным источником истины для таких конфигураций является устройство; этот режим подходит для случаев, когда скорость важнее точности.

Если задано значение true, модуль игнорирует значение параметра check_profiles.

Этот параметр можно использовать при создании ресурсов или обновлении существующих.

Варианты:

  • false ← (по умолчанию)
  • true

check_profiles

boolean

добавлено в f5networks.f5_modules 1.2.0

Указывает, следует ли проверять соответствие указанных пользователем профилей SSL клиента и сервера существующим профилям. Это полезно, когда одновременно добавляется большое количество профилей.

Не рекомендуется для обычного использования. При наличии дублирующихся или ошибочных профилей BIG-IP выдаст ошибку.

Варианты:

  • false
  • true ← (по умолчанию)

clone_pools

list / elements=dictionary

Указывает пул или список пулов, которые виртуальный сервер использует для репликации трафика на стороне клиента или сервера.

Обычно этот параметр используется для обнаружения вторжений.

context

string / обязательный

Параметр context для пула клонирования, используемого для репликации трафика на стороне клиента или сервера.

Варианты:

  • "clientside"
  • "serverside"

pool_name

string / обязательный

Имя пула, в который сервер реплицирует трафик.

Можно использовать только пулы, созданные в разделе Common или в том же разделе, что и виртуальный сервер.

На пул в разделе Common необходимо ссылаться, указывая полный путь, например /Common/pool_name.

default_persistence_profile

string

Профиль по умолчанию, управляющий сохранением сеанса.

Чтобы удалить существующий профиль сохранения сеанса по умолчанию, укажите пустое значение: "". Пример см. в документации.

Если type имеет значение dhcp, этот параметр игнорируется.

description

string

Описание виртуального сервера.

destination

псевдонимы: address, ip

string

IP-адрес назначения виртуального сервера.

Обязателен, если state имеет значение present и виртуальный сервер не существует.

Если type имеет значение internal, этот параметр игнорируется. Для всех остальных типов он обязателен.

В качестве назначения также можно указать имя существующего виртуального адреса.

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

Если задано значение false, модуль не устанавливает метаданные на устройстве.

В настоящее время пользователи без прав администратора не могут задавать метаданные объекта, хотя могут создавать и изменять объекты виртуальных серверов. Установка для этого параметра значения false позволяет таким пользователям управлять объектами виртуальных серверов на устройстве с помощью этого модуля.

Попытка изменить state виртуального сервера, принадлежащего iAPP с включенными строгими обновлениями, приведет к сообщению об ошибке от устройства, если параметру insert_metadata не задано значение false.

Варианты:

  • false
  • true ← (по умолчанию)

ip_intelligence_policy

string

Указывает политику IP Intelligence, применяемую к виртуальному серверу.

Для этого параметра требуется, чтобы был предоставлен действующий модуль безопасности BIG-IP, например ASM или AFM.

ip_protocol

string

Указывает имя сетевого протокола, который система будет использовать для направления трафика на этот виртуальный сервер.

При создании нового виртуального сервера, если этот параметр не указан, используется значение по умолчанию tcp.

Настройка Protocol недоступна, если для параметра Type выбрано значение Performance (HTTP).

Значение этого аргумента можно указать числом или одним из ограниченного набора именованных значений. Примеры см. в choices.

Список допустимых номеров IP-протоколов см. по адресу https://en.wikipedia.org/wiki/List_of_IP_protocol_numbers.

Если type имеет значение dhcp, этот модуль принудительно устанавливает для параметра ip_protocol значение 17 (UDP).

Варианты:

  • "ah"
  • "any"
  • "bna"
  • "esp"
  • "etherip"
  • "gre"
  • "icmp"
  • "ipencap"
  • "ipv6"
  • "ipv6-auth"
  • "ipv6-crypt"
  • "ipv6-icmp"
  • "isp-ip"
  • "mux"
  • "ospf"
  • "sctp"
  • "tcp"
  • "udp"
  • "udplite"

irules

псевдонимы: all_rules

list / elements=string

Указывает список правил, применяемых в порядке приоритета.

Чтобы удалить существующие iRules, укажите одно пустое значение: "". Пример см. в документации.

Порядок указания iRules имеет значение, поэтому список с теми же элементами, но в другом порядке в playbook, приведет к изменениям на устройстве.

Если type имеет значение dhcp, stateless, reject или internal, этот параметр игнорируется.

mask

string

Указывает маску сети адреса назначения. Этот параметр работает с адресами IPv4 и IPv6.

Необязательный параметр, который можно указать при создании или обновлении виртуального сервера.

Если destination задан в формате CIDR и указан mask, приоритет имеет параметр mask.

Если указано назначение catchall (например, 0.0.0.0 для IPv4, :: для IPv6), для параметра mask задается значение any или any6 соответственно.

Если destination указан не в формате CIDR и mask не задан, для адресов IPv4 и IPv6 задается значение 255.255.255.255 или ffff:ffff:ffff:ffff:ffff:ffff:ffff:ffff соответственно.

Если destination задан в формате CIDR, а mask не указан, значение параметра mask определяется по destination.

Если destination задан как имя виртуального адреса, а mask не указан, для параметра mask задается значение None, позволяя устройству установить его внутреннее значение по умолчанию.

metadata

any

Произвольные пары «ключ/значение», которые можно прикрепить к виртуальному серверу. Это полезно, когда требуется добавить к виртуальному серверу аннотацию о том, что им управляет Ansible.

Имена ключей сохраняются как строки, включая имена, состоящие из чисел.

Значения всех ключей сохраняются как строки, включая значения, состоящие из чисел.

Данные сохраняются постоянно, а не временно.

mirror

boolean

Указывает, что система зеркально отражает соединения на каждом узле пары с резервированием.

При создании нового виртуального сервера, если этот параметр не указан, используется значение по умолчанию disabled.

Варианты:

  • false
  • true

name

псевдонимы: vs

string / обязательный

Имя виртуального сервера.

partition

string

Раздел устройства, в котором будут управляться ресурсы.

По умолчанию: "Common"

per_flow_request_access_policy

string

Указывает политику доступа Per-Request для виртуального сервера.

policies

псевдонимы: all_policies

list / elements=string

Указывает политики для виртуального сервера.

Если type имеет значение dhcp, reject или internal, этот параметр игнорируется.

pool

string

Пул виртуального сервера по умолчанию.

Чтобы удалить существующий пул, укажите пустое значение: "". Пример см. в документации.

При создании нового виртуального сервера, если type имеет значение stateless, этот параметр обязателен.

Если type имеет значение stateless, в pool не должно быть участников, для которых задан rate_limit.

port

string

Порт виртуального сервера. Обязателен, если 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.

port_translation

boolean

Если задано значение enabled, система преобразует порт виртуального сервера.

Если задано значение disabled, система использует порт без преобразования. Отключение преобразования портов для виртуального сервера полезно, если требуется использовать его для распределения нагрузки между соединениями с любой службой.

При создании нового виртуального сервера значение по умолчанию — enabled.

Варианты:

  • false
  • true

profiles

псевдонимы: all_profiles

any

Список профилей (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, на котором можно внести изменения и проверить правильные сочетания.

Чтобы использовать http2 в режиме полного прокси и включить параметр HTTP MRF Router, отображаемый в графическом интерфейсе, необходимо назначить профиль /Common/httprouter с параметром context, установленным в all. См. конец раздела с примерами ниже.

context

string

Сторона соединения, к которой следует применить профиль.

Варианты:

  • "all" ← (по умолчанию)
  • "server-side"
  • "client-side"

name

string

Имя профиля.

Это значение необходимо указать, если задан context.

Если значение не указано, предполагается, что элемент профиля содержит только имя профиля.

provider

dictionary

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

Объект dict, содержащий сведения о подключении.

auth_provider

string

Настраивает поставщика аутентификации для получения токенов аутентификации с удаленного устройства.

Этот параметр используется преимущественно при работе с устройствами BIG-IQ.

no_f5_teem

логический

Если yes, данные телеметрии TEEM не отправляются в F5.

Эту опцию можно не указывать, задав переменную среды F5_TELEMETRY_OFF.

Ранее использовавшаяся переменная F5_TEEM устарела, поскольку ее название вводило в заблуждение.

Варианты:

  • false ← (по умолчанию)
  • true

password

псевдонимы: pass, pwd

строка / обязательно

Пароль учетной записи пользователя, используемой для подключения к BIG-IP или BIG-IQ.

Эту опцию можно не указывать, задав переменную среды F5_PASSWORD.

server

строка / обязательно

Имя хоста BIG-IP или BIG-IQ.

Эту опцию можно не указывать, задав переменную среды F5_SERVER.

server_port

целое число

Порт сервера BIG-IP.

Эту опцию можно не указывать, задав переменную среды F5_SERVER_PORT.

По умолчанию: 443

timeout

целое число

Задает время ожидания в секундах при подключении к сетевому устройству или отправке ему команд. Если время ожидания истечет до завершения операции, модуль вернет ошибку.

transport

строка

Настраивает транспортное подключение для связи с удаленным устройством.

Варианты:

  • "rest" ← (по умолчанию)

user

строка / обязательно

Имя пользователя для подключения к BIG-IP или BIG-IQ. Этот пользователь должен иметь права администратора на устройстве.

Эту опцию можно не указывать, задав переменную среды F5_USER.

validate_certs

логический

Если no, SSL-сертификаты не проверяются. Используйте этот параметр только на контролируемых вами сайтах с самоподписанными сертификатами.

Эту опцию можно не указывать, задав переменную среды F5_VALIDATE_CERTS.

Варианты:

  • false
  • true ← (по умолчанию)

rate_limit

целое число

Ограничение скорости для виртуального сервера (количество подключений в секунду). Значение 0 отключает ограничение.

Допустимый диапазон значений: от 0 до 4294967295.

rate_limit_dst_mask

целое число

Задает маску в битах, применяемую к адресу назначения при ограничении скорости.

Значение по умолчанию — 0, что эквивалентно использованию всего адреса: 32 для IPv4 или 128 для IPv6.

Допустимый диапазон значений: от 0 до 4294967295.

rate_limit_mode

строка

Указывает, применяется ли ограничение скорости отдельно к виртуальному объекту, адресу источника, адресу назначения или к их комбинации.

Значение по умолчанию — object; адрес источника или назначения не используется как часть ключа.

Варианты:

  • "object" ← (по умолчанию)
  • "object-source"
  • "object-destination"
  • "object-source-destination"
  • "destination"
  • "source"
  • "source-destination"

rate_limit_src_mask

целое число

Задает маску в битах, применяемую к адресу источника при ограничении скорости.

Значение по умолчанию — 0, что эквивалентно использованию всего адреса: 32 для IPv4 или 128 для IPv6.

Допустимый диапазон значений: от 0 до 4294967295.

security_log_profiles

список / элементы=строка

Задает профиль ведения журнала, применяемый к виртуальному серверу.

Для использования этой функции модуль AFM должен быть лицензирован и подготовлен.

Параметры Log all requests и Log illegal requests взаимоисключающие; поэтому при их совместном указании модуль возвращает ошибку.

security_nat_policy

словарь

Задает политики NAT брандмауэра для виртуального сервера.

Можно указать одну или несколько политик NAT.

Используется наиболее специфичная политика. Например, если указать для виртуального сервера политику устройства и политику домена маршрутизации, политика домена маршрутизации переопределит политику устройства.

policy

строка

Задает политику NAT, применяемую непосредственно к виртуальному серверу.

Политика NAT виртуального сервера является наиболее специфичной и переопределяет политику домена маршрутизации и устройства, если они заданы.

Чтобы удалить политику, укажите пустую строку.

use_device_policy

логический

Указывает, что виртуальный сервер использует политику NAT устройства, заданную в параметрах брандмауэра.

Политика устройства используется, если не задана политика домена маршрутизации или настройка NAT виртуального сервера.

Варианты:

  • false
  • true

use_route_domain_policy

логический

Указывает, что виртуальный сервер использует политику домена маршрутизации, заданную в параметрах безопасности домена маршрутизации.

Если этот параметр указан, политика домена маршрутизации переопределяет политику устройства, но сама переопределяется политикой виртуального сервера.

Варианты:

  • false
  • true

serverssl_use_sni

логический

Если enabled, указывает, включен ли SNI в SSL-подключении со стороны сервера.

Если disabled, указывает, отключен ли SNI в SSL-подключении со стороны сервера.

При создании виртуального сервера по умолчанию используется значение disabled.

Варианты:

  • false
  • true

service_down_immediate_action

строка

добавлено в f5networks.f5_modules 1.16.0

Задает немедленное действие при получении начального пакета SYN, если виртуальный сервер имеет статус доступности Offline или Unavailable.

Поддерживается для виртуальных серверов с типом standard и протоколом TCP.

Варианты:

  • "none"
  • "reset"
  • "drop"

snat

строка

Политика трансляции сетевого адреса источника.

Если для type задано значение dhcp, reject или internal, этот параметр игнорируется.

Чтобы включить SNAT с определенным пулом, можно указать имя пула SNAT (например, «/Common/snat_pool_name»).

Чтобы удалить SNAT, укажите слово none.

Чтобы указать automap, используйте слово automap.

source

строка

Задает IP-адрес или сеть, с которых виртуальный сервер принимает трафик.

Виртуальный сервер принимает подключения только с одного из этих IP-адресов.

Чтобы этот параметр работал эффективно, укажите значение, отличное от 0.0.0.0/0 или ::/0 (то есть any/0, any6/0).

Для максимальной эффективности этого параметра укажите наиболее специфичные префиксы адресов, охватывающие все адреса клиентов и не содержащие другие адреса.

Укажите IP-адрес в формате бесклассовой междоменной маршрутизации (CIDR): адрес/префикс, где длина префикса задается в битах. Например, для 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.

Варианты:

  • "preserve"
  • "preserve-strict"
  • "change"

state

строка

Состояние виртуального сервера. Если absent, удаляет виртуальный сервер, если он существует. Если present, создает виртуальный сервер и включает его. Если enabled, включает виртуальный сервер, если он существует. Если disabled, при необходимости создает виртуальный сервер и задает состояние disabled.

Попытка изменить state виртуального сервера, принадлежащего iAPP со включенными строгими обновлениями, приведет к сообщению об ошибке от устройства, если только параметру insert_metadata не присвоено значение no.

Варианты:

  • "present" ← (по умолчанию)
  • "absent"
  • "enabled"
  • "disabled"

type

строка

Задает сетевую службу, предоставляемую этим виртуальным сервером.

При создании виртуального сервера, если этот параметр не указан, по умолчанию используется значение 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, сохранение состояния, зеркалирование подключений, управление скоростью передачи или automap SNAT.

Если reject, задает виртуальный сервер, для которого система BIG-IP отклоняет весь трафик, предназначенный для IP-адреса виртуального сервера.

Если dhcp, задает виртуальный сервер, который перенаправляет запросы клиентов Dynamic Host Control Protocol (DHCP) на получение IP-адреса одному или нескольким серверам DHCP и передает клиенту ответы DHCP-сервера с доступным IP-адресом.

Если internal, задает виртуальный сервер, поддерживающий изменение HTTP-запросов и ответов. Внутренние виртуальные серверы позволяют использовать серверы ICAP (Internet Content Adaptation Protocol) для изменения HTTP-запросов и ответов путем создания и применения профиля ICAP, а также добавления профилей Request Adapt или Response Adapt к виртуальному серверу.

Если message-routing, задает виртуальный сервер, использующий протокол приложения SIP и работающий в соответствии с профилем сеанса SIP и профилем маршрутизатора SIP.

Варианты:

  • "standard" ← (по умолчанию)
  • "forwarding-l2"
  • "forwarding-ip"
  • "performance-http"
  • "performance-l4"
  • "stateless"
  • "reject"
  • "dhcp"
  • "internal"
  • "message-routing"

Примечания

Примечание

  • Дополнительную информацию об использовании 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_virtual_server:
    name: my-virtual-server
    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_virtual_server:
    name: my-virtual-server
    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_virtual_server:
    name: my-virtual-server
    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_virtual_server:
    name: my-virtual-server
    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

- name: Add virtual with MRF router option set
  bigip_virtual_server:
    name: my-virtual-server
    destination: 10.10.10.10
    port: 443
    partition: Common
    profiles:
      - http
      - tcp
      - name: noneg-ssl
        context: client-side
      - name: http2
        context: client-side
      - name: httprouter
        context: all
    provider:
      server: lb.mydomain.net
      user: admin
      password: secret
  delegate_to: localhost

Возвращаемые значения

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

Ключ

Описание

address_translation

boolean

Новое значение, указывающее, включена или отключена трансляция адресов.

Возвращается: при изменении

Пример: true

auto_last_hop

string

Задает значение autoLasthop виртуального сервера.

Возвращается: при изменении

Пример: "enabled"

clone_pools

list / elements=string

Пулы, в которые виртуальный сервер копирует трафик.

Возвращается: при изменении

Пример: [{"context": "clientside", "pool_name": "/Common/Pool1"}]

default_persistence_profile

string

Профиль сохранения состояния по умолчанию, настроенный на виртуальном сервере.

Возвращается: при изменении

Пример: "/Common/dest_addr"

description

string

Новое описание виртуального сервера.

Возвращается: при изменении

Пример: "This is my description"

destination

string

Назначение виртуального сервера.

Возвращается: при изменении

Пример: "1.1.1.1"

disabled

boolean

Указывает, отключен ли виртуальный сервер.

Возвращается: при изменении

Пример: true

disabled_vlans

list / elements=string

Список VLAN, для которых виртуальный сервер отключен.

Возвращается: при изменении

Пример: ["/Common/vlan1", "/Common/vlan2"]

enabled

boolean

Указывает, включен ли виртуальный сервер.

Возвращается: при изменении

Пример: false

enabled_vlans

list / elements=string

Список VLAN, для которых виртуальный сервер включен.

Возвращается: при изменении

Пример: ["/Common/vlan5", "/Common/vlan6"]

fallback_persistence_profile

string

Резервный профиль сохранения состояния, настроенный на виртуальном сервере.

Возвращается: при изменении

Пример: "/Common/source_addr"

firewall_enforced_policy

string

Новая применяемая политика межсетевого экрана.

Возвращается: при изменении

Пример: "/Common/my-enforced-fw"

firewall_staged_policy

string

Новая тестовая политика межсетевого экрана.

Возвращается: при изменении

Пример: "/Common/my-staged-fw"

ip_intelligence_policy

string

Новая политика IP Intelligence, назначенная виртуальному серверу.

Возвращается: при изменении

Пример: "/Common/ip-intelligence"

ip_protocol

integer

Новое значение протокола IP.

Возвращается: при изменении

Пример: 6

irules

list / elements=string

iRules, настроенные на виртуальном сервере.

Возвращается: при изменении

Пример: ["/Common/irule1", "/Common/irule2"]

metadata

dictionary

Новое значение виртуального сервера.

Возвращается: при изменении

Пример: {"key1": "foo", "key2": "bar"}

mirror

boolean

Указывает, зеркалирует ли система соединения на каждом узле резервной пары.

Возвращается: при изменении

Пример: true

per_flow_request_access_policy

string

Политика для каждого запроса, привязанная к виртуальному серверу.

Возвращается: при изменении

Пример: "/Common/sample_per-request_policy"

policies

list / elements=string

Список политик, привязанных к виртуальному серверу.

Возвращается: при изменении

Пример: ["/Common/policy1", "/Common/policy2"]

pool

string

Пул, к которому привязан виртуальный сервер.

Возвращается: при изменении

Пример: "/Common/my-pool"

port

integer

Порт, на котором настроен прослушивающий режим виртуального сервера.

Возвращается: при изменении

Пример: 80

port_translation

boolean

Новое значение, указывающее, включена или отключена трансляция портов.

Возвращается: при изменении

Пример: true

profiles

list / elements=string

Список профилей, настроенных на виртуальном сервере.

Возвращается: при изменении

Пример: [{"context": "server-side", "name": "tcp"}, {"context": "client-side", "name": "tcp-legacy"}]

rate_limit

integer

Максимальное число соединений в секунду, разрешенное для виртуального сервера.

Возвращается: при изменении

Пример: 5000

rate_limit_dst_mask

integer

Задает маску в битах, применяемую к адресу назначения при ограничении скорости.

Возвращается: при изменении

Пример: 32

rate_limit_mode

string

Задает тип ограничения скорости, используемый на виртуальном сервере.

Возвращается: при изменении

Пример: "object-source"

rate_limit_src_mask

integer

Задает маску в битах, применяемую к адресу источника при ограничении скорости.

Возвращается: при изменении

Пример: 32

security_log_profiles

list / elements=string

Новый список профилей журналирования безопасности.

Возвращается: при изменении

Пример: ["/Common/profile1", "/Common/profile2"]

serverssl_use_sni

boolean

Указывает, включен или отключен SNI для SSL-соединения на стороне сервера.

Возвращается: при изменении

Пример: true

service_down_immediate_action

string

Действие, выполняемое при получении начального SYN-пакета, если сервер находится в состоянии Offline или Unavailable.

Возвращается: при изменении

Пример: "drop"

snat

string

Настройка SNAT виртуального сервера.

Возвращается: при изменении

Пример: "Automap"

source

string

Адрес источника, заданный для виртуального сервера в формате CIDR.

Возвращается: при изменении

Пример: "1.2.3.4/32"

source_port

string

Указывает, сохраняет ли система исходный порт соединения.

Возвращается: при изменении

Пример: "change"

Авторы

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

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

  • Отслеживание проблем
  • Домашняя страница
  • Репозиторий (исходный код)

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

Spec-Zone.ru

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