bigip_virtual_address - Управление виртуальными адресами LTM на BIG-IP
Новое в версии 2.4.
Обзор
- Управление виртуальными адресами LTM на BIG-IP.
Требования
Ниже перечислены требования к хосту, на котором выполняется этот модуль.
- f5-sdk >= 3.0.9
- netaddr
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии | |
|---|---|---|---|
| address обязательно | Виртуальный адрес. Это значение нельзя изменить после его установки. Псевдонимы: name | ||
| advertise_route |
| Указывает, какие маршруты виртуального адреса система рекламирует. При значении when_any_available, рекламирует маршрут, когда доступен любой виртуальный сервер. При значении when_all_available, рекламирует маршрут, когда доступны все виртуальные серверы. При значении (always) всегда рекламирует маршрут независимо от доступности виртуальных серверов. | |
| arp_state |
| Указывает, принимает ли система запросы ARP. При значении (disabled) система не принимает запросы ARP. Обратите внимание, что для того, чтобы виртуальные серверы, использующие этот виртуальный адрес, пересылали пакеты ICMP, необходимо отключить как ARP, так и ICMP Echo. При значении (enabled), пакеты будут отбрасываться. | |
| auto_delete |
| Указывает, автоматически ли система удаляет виртуальный адрес при удалении последнего связанного виртуального сервера. При значении disabled, система оставляет виртуальный адрес даже когда все связанные виртуальные серверы были удалены. При создании виртуального адреса значение по умолчанию — enabled. | |
| 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, независимо от состояния любых виртуальных серверов. | |
| netmask | Значение по умолчанию: 255.255.255.255 | Маска подсети предоставленного виртуального адреса. Это значение нельзя изменить после его установки. | |
| partition (добавлено в 2.5) | Значение по умолчанию: Common | Раздел устройства для управления ресурсами. | |
| password обязательно | Пароль учетной записи пользователя, используемой для подключения к BIG-IP. Этот параметр можно опустить, если переменная среды F5_PASSWORD установлена.Псевдонимы: pass, pwd | ||
| provider (добавлено в 2.5) | Значение по умолчанию: None | Объект словаря, содержащий сведения о подключении. | |
| ssh_keyfile | Указывает SSH-ключевой файл для аутентификации подключения к удаленному устройству. Этот аргумент используется только для транспортов cli. Если значение не указано в задаче, используется значение переменной среды ANSIBLE_NET_SSH_KEYFILE. | ||
| timeout | Значение по умолчанию: 10 | Указывает таймаут в секундах для связи с сетевым устройством при подключении или отправке команд. Если таймаут истечет до завершения операции, модуль вернет ошибку. | |
| server обязательно | Хост BIG-IP. Этот параметр можно опустить, если переменная среды F5_SERVER установлена. | ||
| user обязательно | Имя пользователя для подключения к BIG-IP. Этот пользователь должен иметь административные права на устройстве. Этот параметр можно опустить, если переменная среды F5_USER установлена. | ||
| server_port | Значение по умолчанию: 443 | Порт сервера BIG-IP. Этот параметр можно опустить, если переменная среды F5_SERVER_PORT установлена. | |
| password обязательно | Пароль учетной записи пользователя, используемой для подключения к BIG-IP. Этот параметр можно опустить, если переменная среды F5_PASSWORD установлена.Псевдонимы: pass, pwd | ||
| validate_certs |
| Если no, сертификаты SSL не будут проверены. Используйте только на сайтах, контролируемых лично, использующих самоподписанные сертификаты. Этот параметр можно опустить, если переменная среды F5_VALIDATE_CERTS установлена. | |
| transport обязательно |
| Настраивает транспортное соединение для подключения к удаленному устройству. | |
| server обязательно | Хост BIG-IP. Этот параметр можно опустить, если переменная среды F5_SERVER установлена. | ||
| server_port (добавлено в 2.2) | Значение по умолчанию: 443 | Порт сервера BIG-IP. Этот параметр можно опустить, если переменная среды F5_SERVER_PORT установлена. | |
| state |
| Состояние виртуального адреса. Если absent, будет предпринята попытка удалить виртуальный адрес. Это будет выполнено только в том случае, если этот виртуальный адрес не используется виртуальным сервером. present создает виртуальный адрес и включает его. Если enabled, включить виртуальный адрес, если он существует. Если disabled, создать виртуальный адрес при необходимости и установить состояние на disabled. | |
| traffic_group (добавлено в 2.5) | Группа трафика для виртуального адреса. При создании нового адреса, если это значение не указано, используется значение по умолчанию /Common/traffic-group-1. | ||
| use_route_advertisement |
| Указывает, использует ли система рекламу маршрутов для этого виртуального адреса. При отключении система не рекламирует маршруты для этого виртуального адреса. | |
| user обязательно | Имя пользователя для подключения к BIG-IP. Этот пользователь должен иметь административные права на устройстве. Этот параметр можно опустить, если переменная среды F5_USER установлена. | ||
| validate_certs (добавлено в 2.0) |
| Если no, сертификаты SSL не будут проверены. Используйте только на сайтах, контролируемых лично, использующих самоподписанные сертификаты. Этот параметр можно опустить, если переменная среды F5_VALIDATE_CERTS установлена. | |
Примечания
Примечание
- Требуется пакет netaddr Python на хосте. Это так же просто, как pip install netaddr.
- Дополнительную информацию об использовании Ansible для управления устройствами F5 Networks см. на странице https://www.ansible.com/integrations/networks/f5.
- Требуется пакет f5-sdk Python на хосте. Это так же просто, как
pip install f5-sdk.
Примеры
- name: Add virtual address
bigip_virtual_address:
server: lb.mydomain.net
user: admin
password: secret
state: present
partition: Common
address: 10.10.10.10
delegate_to: localhost
- name: Enable route advertisement on the virtual address
bigip_virtual_address:
server: lb.mydomain.net
user: admin
password: secret
state: present
address: 10.10.10.10
use_route_advertisement: yes
delegate_to: localhost
Значения возврата
Общие значения возврата документированы здесь, ниже приведены поля, уникальные для этого модуля:
| Ключ | Возвращаемое | Описание |
|---|---|---|
| address int | создано | Адрес виртуального адреса. Пример: 2345 |
| arp_state string | изменено | Новый способ, которым виртуальный адрес обрабатывает запросы ARP. Пример: выключено |
| auto_delete string | изменено | Новая настройка для автоматического удаления виртуального адреса. Пример: включено |
| connection_limit int | изменено | Новый лимит подключений виртуального адреса. Пример: 1000 |
| icmp_echo string | изменено | Новая настройка ICMP echo, применённая к виртуальному адресу. Пример: выключено |
| netmask int | создано | Маска сети виртуального адреса. Пример: 2345 |
| state string | изменено | Новое состояние виртуального адреса. Пример: выключено |
| use_route_advertisement bool | изменено | Новая настройка использования рекламы маршрута. Пример: True |
Статус
Этот модуль помечен как превью, что означает, что гарантии обратной совместимости нет.
Автор
- 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.5/modules/bigip_virtual_address_module.html
