bigip_device_connectivity - Управляет настройками IP-конфигурации устройства для HA на BIG-IP
Новое в версии 2.5.
Описание
- Управляет настройками IP-конфигурации устройства для HA на BIG-IP. Каждое устройство BIG-IP имеет информацию о синхронизации и резервировании подключения (IP-адреса), которую вы определяете как часть сопряжения HA или кластеризации. Этот модуль позволяет настроить эту информацию.
Требования
Ниже перечислены требования, необходимые на хосте, на котором выполняется этот модуль.
- f5-sdk >= 3.0.9
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии | |
|---|---|---|---|
| config_sync_ip | Локальный IP-адрес, используемый системой для операций ConfigSync. | ||
| failover_multicast bool |
| Когда yes, гарантирует, что конфигурация Failover Multicast включена, и если нет дальнейших настроек multicast, гарантирует, что multicast_interface, multicast_address и multicast_port принимают значения по умолчанию, указанные в описании каждого параметра. Когда no, гарантирует, что конфигурация Failover Multicast отключена. | |
| mirror_primary_address | Указывает первичный IP-адрес, который система должна использовать для зеркалирования соединений. | ||
| mirror_secondary_address | Указывает вторичный IP-адрес, который система должна использовать для зеркалирования соединений. | ||
| multicast_address | IP-адрес, который система должна использовать для отправки multicast-сообщений, связанных с резервированием. Когда failover_multicast является yes, и этот параметр не указан, используется значение по умолчанию 224.0.0.245. | ||
| multicast_interface | Интерфейс, по которому система отправляет multicast-сообщения, связанные с резервированием. Когда failover_multicast является yes, и этот параметр не указан, используется значение по умолчанию eth0. | ||
| multicast_port | Порт, по которому система отправляет multicast-сообщения, связанные с резервированием. Когда failover_multicast является yes, и этот параметр не указан, используется значение по умолчанию 62960. Это значение должно быть в диапазоне от 0 до 65535. | ||
| password обязательно | Пароль для учетной записи пользователя, используемой для подключения к BIG-IP. Вы можете опустить этот параметр, если переменная среды F5_PASSWORD установлена.псевдонимы: pass, pwd | ||
| provider (добавлено в 2.5) | Объект типа dict, содержащий данные подключения. | ||
| password обязательно | Пароль для учетной записи пользователя, используемой для подключения к BIG-IP. Вы можете опустить этот параметр, если переменная среды F5_PASSWORD установлена.псевдонимы: pass, pwd | ||
| server обязательно | Хост BIG-IP. Вы можете опустить этот параметр, если переменная среды F5_SERVER установлена. | ||
| server_port | По умолчанию: 443 | Порт сервера BIG-IP. Вы можете опустить этот параметр, если переменная среды F5_SERVER_PORT установлена. | |
| user обязательно | Имя пользователя для подключения к BIG-IP. Этот пользователь должен иметь административные привилегии на устройстве. Вы можете опустить этот параметр, если переменная среды F5_USER установлена. | ||
| validate_certs bool |
| Если no, сертификаты SSL не будут проверены. Используйте только на сайтах, находящихся под вашим контролем, с самозаверенными сертификатами. Вы можете опустить этот параметр, если переменная среды F5_VALIDATE_CERTS установлена. | |
| timeout | По умолчанию: 10 | Указывает время ожидания в секундах для связи с сетевым устройством при подключении или отправке команд. Если время ожидания истечет до завершения операции, модуль вернет ошибку. | |
| ssh_keyfile | Указывает SSH-ключ для аутентификации соединения с удаленным устройством. Этот аргумент используется только для транспортов cli. Если значение не указано в задании, используется значение переменной среды ANSIBLE_NET_SSH_KEYFILE. | ||
| transport обязательно |
| Настраивает транспортное соединение для подключения к удаленному устройству. | |
| server обязательно | Хост BIG-IP. Вы можете опустить этот параметр, если переменная среды F5_SERVER установлена. | ||
| server_port (добавлено в 2.2) | По умолчанию: 443 | Порт сервера BIG-IP. Вы можете опустить этот параметр, если переменная среды F5_SERVER_PORT установлена. | |
| unicast_failover | Желаемые адреса для использования в операциях резервирования. Параметры address и port поддерживаются со структурой словаря, где address - локальный IP-адрес, используемый системой для операций резервирования. Порт указывает порт, используемый системой для операций резервирования. Если port не указан, используется значение по умолчанию 1026. Если вы указываете (рекомендуемый) адрес управления, используйте 'management-ip' в поле address. | ||
| user обязательно | Имя пользователя для подключения к BIG-IP. Этот пользователь должен иметь административные привилегии на устройстве. Вы можете опустить этот параметр, если переменная среды F5_USER установлена. | ||
| validate_certs bool (добавлено в 2.0) |
| Если no, сертификаты SSL не будут проверены. Используйте только на сайтах, находящихся под вашим контролем, с самозаверенными сертификатами. Вы можете опустить этот параметр, если переменная среды F5_VALIDATE_CERTS установлена. | |
Примечания
Примечание
- Этот модуль в основном используется как компонент для настройки пар BIG-IP устройств в режиме HA.
- Требуется BIG-IP >= 12.0.0
- Дополнительную информацию об использовании Ansible для управления устройствами F5 Networks см. на странице https://www.ansible.com/integrations/networks/f5.
- Требуется пакет f5-sdk Python на хосте. Это так же просто, как
pip install f5-sdk.
Примеры
- name: Configure device connectivity for standard HA pair
bigip_device_connectivity:
config_sync_ip: 10.1.30.1
mirror_primary_address: 10.1.30.1
unicast_failover:
- address: management-ip
- address: 10.1.30.1
server: lb.mydomain.com
user: admin
password: secret
delegate_to: localhost
Возвращаемые значения
Общие возвращаемые значения документированы здесь, следующие поля уникальны для этого модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| changed bool | всегда | Указывает, была ли обновлена конфигурация F5. |
| config_sync_ip string | changed | Новое значение параметра config_sync_ip. Пример: 10.1.1.1 |
| failover_multicast bool | changed | Указывает, был ли изменен атрибут резервного мультиковещания. |
| mirror_primary_address string | changed | Новое значение параметра mirror_primary_address. Пример: 10.1.1.2 |
| mirror_secondary_address string | changed | Новое значение параметра mirror_secondary_address. Пример: 10.1.1.3 |
| multicast_address string | changed | Новое значение параметра multicast_address. Пример: 224.0.0.245 |
| multicast_interface string | changed | Новое значение параметра multicast_interface. Пример: eth0 |
| multicast_port string | changed | Новое значение параметра multicast_port. Пример: 1026 |
| unicast_failover list | changed | Новое значение параметра unicast_failover. Пример: [{'address': '10.1.1.2', 'port': 1026}] |
Статус
Этот модуль помечен как stableinterface, что означает, что разработчики этого модуля гарантируют, что не будут вноситься обратные несовместимые изменения в интерфейс.
Техническое обслуживание
Этот модуль помечен как community, что означает, что он поддерживается сообществом Ansible. Подробнее см. Техническое обслуживание и поддержка модулей.
Список других модулей, поддерживаемых сообществом Ansible, см. здесь.
Автор
- 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.6/modules/bigip_device_connectivity_module.html
