bigip_virtual_address – Управление виртуальными адресами LTM на BIG-IP
Новое в версии 2.4.
Описание
- Управление виртуальными адресами LTM на BIG-IP.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии | |
|---|---|---|---|
| address строка | Виртуальный адрес. Это значение нельзя изменить после его установки. Если вы никогда не создавали виртуальный адрес, но создавали виртуальные серверы, то для каждого виртуального сервера автоматически создавался виртуальный адрес. Название этого виртуального адреса - его значение IP-адреса. | ||
| arp логическое добавлено в 2.7 |
| Указывает, принимает ли система запросы ARP. Когда no, указывает, что система не принимает запросы ARP.Когда yes, пакеты отбрасываются.Обратите внимание, что для того, чтобы пересылающие виртуальные серверы, использующие этот виртуальный адрес, пересылали пакеты ICMP, необходимо отключить как ARP, так и ICMP Echo. При создании нового виртуального адреса, если этот параметр не указан, значение по умолчанию - yes. | |
| arp_state строка |
| Указывает, принимает ли система запросы ARP. При (disabled), указывает, что система не принимает запросы ARP. Обратите внимание, что для того, чтобы пересылающие виртуальные серверы, использующие этот виртуальный адрес, пересылали пакеты ICMP, необходимо отключить как ARP, так и ICMP Echo. При (enabled), пакеты отбрасываются. Устарело. Используйте параметр arp вместо него.При создании нового виртуального адреса, если этот параметр не указан, значение по умолчанию - enabled. | |
| auto_delete строка | Указывает, автоматически ли удаляется виртуальный адрес при удалении последнего связанного виртуального сервера. Когда disabled, указывает, что система оставляет виртуальный адрес даже при удалении всех связанных виртуальных серверов. При создании виртуального адреса значение по умолчанию - enabled.enabled и disabled устарели и будут удалены в Ansible 2.11. Вместо этого используйте известные логические значения Ansible, такие как yes и no
| ||
| availability_calculation строка добавлено в 2.6 |
| Указывает, какие маршруты виртуального адреса система рекламирует. При when_any_available, рекламирует маршрут, когда доступен любой виртуальный сервер. При when_all_available, рекламирует маршрут, когда все виртуальные серверы доступны. При (always), всегда рекламирует маршрут независимо от доступности виртуальных серверов.псевдонимы: advertise_route | |
| connection_limit целое число | Указывает количество одновременных подключений, разрешенных системой для этого виртуального адреса. | ||
| icmp_echo строка |
| Указывает, как система отправляет ответы на запросы (ICMP) echo на основе каждого виртуального адреса для включения рекламы маршрутов. При enabled, система BIG-IP перехватывает пакеты запросов ICMP echo и отвечает на них непосредственно. При disabled, система BIG-IP передает запросы ICMP echo на бэкенд-серверы. При (selective), система BIG-IP внутренне включает или отключает ответы в зависимости от состояния виртуального сервера; when_any_available, when_all_available, or C(always, независимо от состояния любых виртуальных серверов. | |
| name строка добавлено в 2.6 | Имя виртуального адреса. Если этот параметр не указан, будет использовано значение address. | ||
| netmask строка | Маска сети предоставленного виртуального адреса. Это значение нельзя изменить после его установки. При создании нового виртуального адреса, если этот параметр не указан, значение по умолчанию - 255.255.255.255 для IPv4-адресов и ffff:ffff:ffff:ffff:ffff:ffff:ffff:ffff для IPv6-адресов. | ||
| partition строка добавлено в 2.5 | По умолчанию: "Общие" | Раздел устройства для управления ресурсами. | |
| provider словарь добавлено в 2.5 | Объект словаря, содержащий данные подключения. | ||
| auth_provider строка | Настраивает поставщика авторизации для получения маркеров аутентификации от удаленного устройства. Этот параметр используется при работе с устройствами BIG-IQ. | ||
| password строка / обязательно | Пароль для учетной записи пользователя, используемой для подключения к BIG-IP. Можно опустить этот параметр, установив переменную окружения F5_PASSWORD.псевдонимы: pass, pwd | ||
| server строка / обязательно | Хост BIG-IP. Можно опустить этот параметр, установив переменную окружения F5_SERVER. | ||
| server_port целое число | По умолчанию: 443 | Порт сервера BIG-IP. Можно опустить этот параметр, установив переменную окружения F5_SERVER_PORT. | |
| ssh_keyfile путь | Указывает файл SSH-ключа для аутентификации подключения к удаленному устройству. Этот аргумент используется только для транспортов cli. Можно опустить этот параметр, установив переменную окружения ANSIBLE_NET_SSH_KEYFILE. | ||
| timeout целое число | Указывает таймаут в секундах для связи с сетевым устройством для подключения или отправки команд. Если таймаут превышен до завершения операции, модуль выдаст ошибку. | ||
| transport строка |
| Настраивает транспортное соединение для подключения к удаленному устройству. | |
| user строка / обязательно | Имя пользователя для подключения к BIG-IP. Этот пользователь должен иметь административные привилегии на устройстве. Можно опустить этот параметр, установив переменную окружения F5_USER. | ||
| validate_certs логическое |
| Если no, сертификаты SSL не проверяются. Используйте это только на контролируемых вами сайтах, использующих самозаверяющие сертификаты.Можно опустить этот параметр, установив переменную окружения F5_VALIDATE_CERTS. | |
| route_advertisement string added in 2.6 |
| Указывает, использует ли система рекламу маршрутов для этого виртуального адреса. При значении disabled система не рекламирует маршруты для этого виртуального адреса. Большинство из этих опций поддерживаются только в версиях 13.0.0-HF1 и выше. В версиях ниже все варианты ожидают disabled будет переведено в enabled.При значении always, система BIG-IP всегда будет рекламировать маршрут для виртуального адреса, независимо от состояния доступности. Это требует enabled виртуальный адрес.При значении enabled, система BIG-IP будет рекламировать маршрут для доступного виртуального адреса, основываясь на методе расчета в вычислении доступности.При значении disabled, система BIG-IP не будет рекламировать маршрут для виртуального адреса, независимо от состояния доступности.При значении selective, вы также можете выборочно включить ответы ICMP echo, что заставляет систему BIG-IP внутренне включать или выключать ответы на основе состояния виртуального сервера. Либо any виртуальный сервер, all виртуальных серверов, или always, независимо от состояния любого виртуального сервера.При значении any, система BIG-IP будет рекламировать маршрут для виртуального адреса, когда любой виртуальный сервер доступен.При значении all, система BIG-IP будет рекламировать маршрут для виртуального адреса, когда все виртуальные серверы доступны. | |
| route_domain string added in 2.6 | Домен маршрутизации address, который вы хотите использовать.Это значение нельзя изменить после его установки. | ||
| spanning boolean added in 2.7 |
| Включает все системы BIG-IP в группе устройств для прослушивания и обработки трафика по одному виртуальному адресу. Расширение для виртуального адреса происходит, когда вы включаете опцию spanning на устройстве, а затем синхронизируете виртуальный адрес с другими членами группы устройств.Расширение также полагается на маршрутизатор верхнего уровня для распределения потоков приложений на системы BIG-IP с использованием маршрутов ECMP. ECMP определяет маршрут к виртуальному адресу, используя отдельные плавающие IP-адреса, настроенные на каждой системе BIG-IP. При включенном расширении также необходимо настроить адреса MAC-маскировки и отключить arp на виртуальном адресе.При создании нового виртуального адреса, если этот параметр не указан, используется значение по умолчанию no. | |
| state string |
| Состояние виртуального адреса. Если absent, будет предпринята попытка удалить виртуальный адрес. Это произойдет только в случае, если этот виртуальный адрес не используется виртуальным сервером. present создает виртуальный адрес и включает его. Если enabled, включить виртуальный адрес, если он существует. Если disabled, создать виртуальный адрес при необходимости и установить состояние на disabled. | |
| traffic_group string added in 2.5 | Группа трафика для виртуального адреса. При создании нового адреса, если это значение не указано, будет использоваться значение по умолчанию /Common/traffic-group-1. | ||
Примечания
Примечание
- Дополнительную информацию об использовании Ansible для управления устройствами F5 Networks см. на странице https://www.ansible.com/integrations/networks/f5.
- Требуется версия ПО BIG-IP >= 12.
- Модули F5 манипулируют только рабочей конфигурацией продукта F5. Чтобы убедиться, что конфигурация, специфичная для BIG-IP, сохраняется на диске, необходимо включить хотя бы одну задачу, использующую модуль 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 integer | created | Адрес виртуального адреса. Пример: 2345 |
| arp boolean | changed | Новый способ обработки запросов ARP для виртуального адреса. Пример: True |
| auto_delete string | changed | Новое значение для автоматического удаления виртуального адреса. Пример: enabled |
| availability_calculation string | changed | Указывает, какие маршруты виртуального адреса система рекламирует. Пример: always |
| connection_limit integer | changed | Новый лимит подключений для виртуального адреса. Пример: 1000 |
| icmp_echo string | changed | Новое значение ICMP echo, применённое к виртуальному адресу. Пример: disabled |
| netmask integer | created | Маска сети виртуального адреса. Пример: 2345 |
| spanning string | changed | Включено или выключено расширение. Пример: disabled |
| state string | changed | Новое состояние виртуального адреса. Пример: disabled |
Статус
- Этот модуль не гарантирует обратную совместимость интерфейса. [preview]
- Этот модуль поддерживается партнером Ansible. [certified]
Авторы
- 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.9/modules/bigip_virtual_address_module.html
