f5networks.f5_modules.bigip_virtual_address – Управление виртуальными адресами LTM на BIG-IP
Примечание
Этот плагин входит в коллекцию f5networks.f5_modules (версия 1.6.0).
Для его установки используйте: ansible-galaxy collection install f5networks.f5_modules.
Для использования в плейбуке укажите: f5networks.f5_modules.bigip_virtual_address.
Новая версия 1.0.0: из f5networks.f5_modules
Описание
- Управление виртуальными адресами LTM на системе BIG-IP.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии | |
|---|---|---|---|
| address строка | Указывает виртуальный адрес. Это значение нельзя изменить после его установки. Если вы никогда не создавали виртуальный адрес, но создавали виртуальные серверы, виртуальный адрес для каждого виртуального сервера был создан автоматически. Название этого виртуального адреса — его значение IP-адреса. | ||
| arp булево |
| Указывает, принимает ли система запросы ARP. Когда no, система не принимает запросы ARP.Когда yes, пакеты отбрасываются.Для того, чтобы виртуальные серверы, использующие этот виртуальный адрес, пересылали пакеты ICMP, ARP и ICMP Echo должны быть отключены. При создании нового виртуального адреса, если этот параметр не указан, значение по умолчанию — yes. | |
| auto_delete булево |
| Указывает, удаляет ли система автоматически виртуальный адрес при удалении последнего связанного виртуального сервера. Когда no, система оставляет виртуальный адрес, даже если все связанные виртуальные серверы были удалены. При создании виртуального адреса значение по умолчанию — yes. | |
| availability_calculation строка |
| Указывает, какие маршруты виртуального адреса система рекламирует. Когда when_any_available, маршрут рекламируется, когда любой виртуальный сервер доступен. Когда when_all_available, маршрут рекламируется, когда все виртуальные серверы доступны. При значении (always) маршрут всегда рекламируется, независимо от доступности виртуальных серверов.псевдонимы: advertise_route | |
| connection_limit целое число | Указывает количество одновременных подключений, которые система разрешает для этого виртуального адреса. | ||
| icmp_echo строка |
| Указывает, как система отправляет ответы на запросы эха ICMP (ICMP echo requests) на основе каждого виртуального адреса для включения рекламы маршрутов. При значении enabled, система BIG-IP перехватывает пакеты запросов эха ICMP и отвечает на них напрямую. При значении disabled, система BIG-IP пропускает запросы эха ICMP к серверам бэкэнда. При значении (selective), система BIG-IP внутренне включает или отключает ответы, в зависимости от состояния виртуальных серверов; when_any_available, when_all_available, or C(always, независимо от состояния любых виртуальных серверов. | |
| name строка | Имя виртуального адреса. Если этот параметр не указан, система использует значение address. | ||
| netmask строка | Указывает маску подсети предоставленного виртуального адреса. Это значение нельзя изменить после его установки. При создании нового виртуального адреса, если этот параметр не указан, значение по умолчанию — 255.255.255.255 для IPv4-адресов и ffff:ffff:ffff:ffff:ffff:ffff:ffff:ffff для IPv6-адресов. | ||
| partition строка | По умолчанию: "Common" | Раздел устройства для управления ресурсами. | |
| provider словарь добавлен в 1.0.0 модуля f5networks.f5_modules | Объект словаря, содержащий данные подключения. | ||
| auth_provider строка | Настраивает поставщика аутентификации для получения маркеров аутентификации от удаленного устройства. Этот параметр действительно используется при работе с устройствами BIG-IQ. | ||
| no_f5_teem булево |
| Если 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 строка |
| Настраивает транспортное соединение для использования при подключении к удаленному устройству. | |
| user строка / обязательно | Имя пользователя для подключения к BIG-IP. Этот пользователь должен иметь административные права на устройстве. Вы можете опустить этот параметр, установив переменную окружения F5_USER. | ||
| validate_certs булево |
| Если no, сертификаты SSL не проверяются. Используйте только на контролируемых вами сайтах, использующих самозаверяющие сертификаты.Вы можете опустить этот параметр, установив переменную окружения F5_VALIDATE_CERTS. | |
| route_advertisement строка |
| Указывает, использует ли система рекламу маршрутов для этого виртуального адреса. При значении disabled система не рекламирует маршруты для этого виртуального адреса. Большинство этих вариантов поддерживаются только на версиях 13.0.0-HF1 или более поздних. В версиях ранее чем эта, все варианты, кроме disabled, будут переведены как enabled.При значении always, система BIG-IP всегда рекламирует маршрут для виртуального адреса, независимо от состояния доступности. Это требует виртуальный адрес enabled. При значении enabled, система BIG-IP рекламирует маршрут для доступного виртуального адреса, основываясь на методе расчета доступности в параметре availability calculation.При значении disabled, система BIG-IP не рекламирует маршрут для виртуального адреса, независимо от состояния доступности.При значении selective, вы также можете выборочно включить ответы ICMP echo, что заставит систему BIG-IP внутренне включать или отключать ответы, в зависимости от состояния виртуального сервера.При значении any, система BIG-IP рекламирует маршрут для виртуального адреса, когда любой виртуальный сервер доступен.При значении all, система BIG-IP рекламирует маршрут для виртуального адреса, когда все виртуальные серверы доступны. | |
| route_domain строка | Домен маршрута address, который вы хотите использовать.Это значение нельзя изменить после его установки. | ||
| spanning булево |
| Включает все системы BIG-IP в группе устройств для прослушивания и обработки трафика по одному и тому же виртуальному адресу. Распространение для виртуального адреса происходит, когда вы включаете опцию spanning на устройстве, а затем синхронизируете виртуальный адрес с другими членами группы устройств.Распространение также зависит от маршрутизатора вышестоящего уровня для распределения потоков приложений по системам BIG-IP, используя маршруты ECMP. ECMP определяет маршрут к виртуальному адресу, используя отдельные плавающие само-IP-адреса, настроенные на каждой системе BIG-IP. Вы также должны настроить MAC-адреса маскирования и отключить arp на виртуальном адресе при включенном Spanning.При создании нового виртуального адреса, если этот параметр не указан, значение по умолчанию — no. | |
| state строка |
| Состояние виртуального адреса. Если absent, система пытается удалить виртуальный адрес. Это будет успешным только если этот виртуальный адрес не используется виртуальным сервером. present создает виртуальный адрес и включает его. Если enabled, включает виртуальный адрес, если он существует. Если disabled, создаёт виртуальный адрес при необходимости и устанавливает состояние на disabled. | |
| traffic_group строка | Группа трафика для виртуального адреса. При создании нового адреса, если это значение не указано, значение по умолчанию — /Common/traffic-group-1. | ||
Примечания
Примечание
- Дополнительную информацию об использовании Ansible для управления устройствами F5 Networks см. на странице https://www.ansible.com/integrations/networks/f5.
- Требуется версия ПО BIG-IP >= 12.
- Модули F5 изменяют только рабочую конфигурацию продукта F5. Чтобы гарантировать сохранение конфигурации BIG-IP на диске, необходимо включить хотя бы одну задачу, использующую модуль f5networks.f5_modules.bigip_config для сохранения рабочей конфигурации. Обратитесь к документации модуля для правильного использования модуля для сохранения вашей рабочей конфигурации.
Примеры
- name: Add virtual address
bigip_virtual_address:
state: present
partition: Common
address: 10.10.10.10
provider:
server: lb.mydomain.net
user: admin
password: secret
delegate_to: localhost
- name: Enable route advertisement on the virtual address
bigip_virtual_address:
state: present
address: 10.10.10.10
route_advertisement: any
provider:
server: lb.mydomain.net
user: admin
password: secret
delegate_to: localhost
Значения возврата
Общие значения возврата описаны здесь, ниже приведены поля, уникальные для данного модуля:
| Ключ | Возвращённое значение | Описание |
|---|---|---|
| address целое число | создано | Адрес виртуального адреса. Пример: 2345 |
| arp логический тип | изменено | Новый способ обработки запросов ARP виртуальным адресом. Пример: True |
| auto_delete логический тип | изменено | Новое значение для автоматического удаления виртуального адреса. Пример: True |
| availability_calculation строка | изменено | Определяет, какие маршруты виртуального адреса система рекламирует. Пример: всегда |
| connection_limit целое число | изменено | Новый лимит подключений для виртуального адреса. Пример: 1000 |
| icmp_echo строка | изменено | Новое значение ICMP echo, применённое к виртуальному адресу. Пример: выключено |
| netmask целое число | создано | Маска сети виртуального адреса. Пример: 2345 |
| spanning строка | изменено | Включено ли spanning или нет. Пример: выключено |
| state строка | изменено | Новое состояние виртуального адреса. Пример: выключено |
Авторы
- Tim Rupp (@caphrim007)
- 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_virtual_address_module.html
