bigip_device_connectivity – Управляет настройками IP-конфигурации устройства для HA на BIG-IP
Новая версия 2.5.
Краткое описание
- Управляет настройками IP-конфигурации устройства для HA на BIG-IP. Каждое устройство BIG-IP имеет информацию о синхронизации и резервировании подключения (IP-адреса), которые вы определяете при парном соединении или кластеризации HA. Этот модуль позволяет настраивать эту информацию.
Требования
Ниже перечислены требования к хосту, на котором выполняется этот модуль.
- f5-sdk >= 3.0.16
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии | |
|---|---|---|---|
| cluster_mirroring - добавлено в 2.7 |
| Указывает, происходит ли зеркалирование внутри одного кластера или между различными кластерами на многолезвийной системе. Этот параметр поддерживается только на платформах с несколькими лезвиями, таких как аппаратное обеспечение Viprion. Он не поддерживается в VE. | |
| config_sync_ip - | Локальный IP-адрес, используемый системой для операций ConfigSync. | ||
| failover_multicast boolean |
| При yes, гарантирует, что конфигурация Failover Multicast включена, а если дополнительная конфигурация multicast не предоставлена, гарантирует, что multicast_interface, multicast_address и multicast_port являются значениями по умолчанию, указанными в описании каждого параметра. При no, гарантирует, что конфигурация Failover Multicast отключена. | |
| mirror_primary_address - | Указывает первичный IP-адрес, используемый системой для зеркалирования подключений. | ||
| mirror_secondary_address - | Указывает вторичный IP-адрес, используемый системой для зеркалирования подключений. | ||
| multicast_address - | IP-адрес, который система использует для отправки мультимедийных сообщений, связанных с резервированием. Если failover_multicast равно yes, и этот параметр не указан, будет использовано значение по умолчанию 224.0.0.245. | ||
| multicast_interface - | Интерфейс, по которому система отправляет мультимедийные сообщения, связанные с резервированием. Если failover_multicast равно yes, и этот параметр не указан, будет использовано значение по умолчанию eth0. | ||
| multicast_port - | Порт, по которому система отправляет мультимедийные сообщения, связанные с резервированием. Если failover_multicast равно yes, и этот параметр не указан, будет использовано значение по умолчанию 62960. Это значение должно быть в диапазоне от 0 до 65535. | ||
| password - / обязательно | Пароль учетной записи пользователя, используемой для подключения к BIG-IP. Вы можете опустить этот параметр, установив переменную среды F5_PASSWORD. псевдонимы: pass, pwd | ||
| provider - добавлено в 2.5 | Значение по умолчанию: null | Объект словаря, содержащий данные подключения. | |
| 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 - | Значение по умолчанию: 10 | Устанавливает таймаут в секундах для связи с сетевым устройством для подключения или отправки команд. Если таймаут истечет до завершения операции, модуль вернет ошибку. | |
| transport - / обязательно |
| Настраивает транспортное соединение для подключения к удаленному устройству. | |
| user - / обязательно | Имя пользователя для подключения к BIG-IP. Этот пользователь должен иметь административные привилегии на устройстве. Вы можете опустить этот параметр, установив переменную среды F5_USER. | ||
| validate_certs boolean |
| Если no, сертификаты SSL не проверяются. Используйте только на сайтах под собственным контролем, использующих самозаверяющие сертификаты.Вы можете опустить этот параметр, установив переменную среды F5_VALIDATE_CERTS. | |
| server - / обязательно | Хост BIG-IP. Вы можете опустить этот параметр, установив переменную среды F5_SERVER. | ||
| server_port - добавлено в 2.2 | Значение по умолчанию: 443 | Порт сервера BIG-IP. Вы можете опустить этот параметр, установив переменную среды F5_SERVER_PORT. | |
| unicast_failover - | Желаемые адреса для операций резервирования. Параметры address и port поддерживаются со структурой словаря, где address - это локальный IP-адрес, используемый системой для операций резервирования. Порт указывает порт, используемый системой для операций резервирования. Если port не указан, будет использовано значение по умолчанию 1026. Если вы указываете (рекомендуемый) IP-адрес управления, используйте 'management-ip' в поле адреса. | ||
| user - / обязательно | Имя пользователя для подключения к BIG-IP. Этот пользователь должен иметь административные привилегии на устройстве. Вы можете опустить этот параметр, установив переменную среды F5_USER. | ||
| validate_certs boolean добавлено в 2.0 |
| Если no, сертификаты SSL не проверяются. Используйте только на сайтах под собственным контролем, использующих самозаверяющие сертификаты.Вы можете опустить этот параметр, установив переменную среды F5_VALIDATE_CERTS. | |
Примечания
Примечание
- Этот модуль в основном используется как компонент для настройки HA пар устройств BIG-IP.
- Требуется BIG-IP >= 12.0.0
- Для получения дополнительной информации об использовании Ansible для управления устройствами F5 Networks см. https://www.ansible.com/integrations/networks/f5.
- На хосте требуется пакет f5-sdk Python. Это так же просто, как
pip install f5-sdk. - Требуется версия ПО BIG-IP >= 12.
- Модули F5 манипулируют только рабочей конфигурацией продукта F5. Чтобы убедиться, что специфичная для BIG-IP конфигурация сохраняется на диске, обязательно включите по крайней мере одну задачу, использующую модуль bigip_config для сохранения рабочей конфигурации. Обратитесь к документации модуля для правильного использования модуля для сохранения рабочей конфигурации.
Примеры
- 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 boolean | всегда | Указывает, была ли обновлена конфигурация F5. |
| cluster_mirroring строка | изменено | Текущее значение настройки кластерного зеркалирования. Пример: between-clusters |
| config_sync_ip строка | изменено | Новое значение настройки config_sync_ip. Пример: 10.1.1.1 |
| failover_multicast boolean | изменено | Изменено или нет атрибут failover multicast. |
| mirror_primary_address строка | изменено | Новое значение настройки mirror_primary_address. Пример: 10.1.1.2 |
| mirror_secondary_address строка | изменено | Новое значение настройки mirror_secondary_address. Пример: 10.1.1.3 |
| multicast_address строка | изменено | Новое значение настройки multicast_address. Пример: 224.0.0.245 |
| multicast_interface строка | изменено | Новое значение настройки multicast_interface. Пример: eth0 |
| multicast_port строка | изменено | Новое значение настройки multicast_port. Пример: 1026 |
| unicast_failover список | изменено | Новое значение настройки unicast_failover. Пример: [{'address': '10.1.1.2', 'port': 1026}] |
Статус
- Этот модуль гарантирует отсутствие обратной несовместимости в будущих изменениях интерфейса. [stableinterface]
- Этот модуль поддерживается партнером Ansible. [certified]
Авторы
- 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.7/modules/bigip_device_connectivity_module.html
