bigip_device_connectivity – Управляет настройками IP-конфигурации устройства для HA на BIG-IP
Новое в версии 2.5.
Обзор
- Управляет настройками IP-конфигурации устройства для HA на BIG-IP. Каждое устройство BIG-IP имеет информацию о синхронизации и резервировании подключения (IP-адреса), которые вы определяете в рамках сопряжения или кластеризации HA. Этот модуль позволяет настроить эту информацию.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии | |
|---|---|---|---|
| cluster_mirroring строка Добавлена в 2.7 |
| Указывает, происходит ли зеркалирование внутри одного кластера или между различными кластерами на многоплатной системе. Этот параметр поддерживается только на платформах с несколькими платами, таких как оборудование Viprion. Он не поддерживается на VE. | |
| config_sync_ip строка | Локальный IP-адрес, который система использует для операций ConfigSync. | ||
| failover_multicast логическое значение |
| Когда 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. | ||
| 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. | |
| unicast_failover список | Желаемые адреса для использования при резервировании. Параметры address и port поддерживаются со структурой словаря, где address — локальный IP-адрес, который система использует для операций резервирования. Порт указывает порт, который система использует для операций резервирования. Если port не указан, будет использоваться значение по умолчанию 1026. Если вы указываете рекомендуемый адрес управления, используйте «management-ip» в поле адреса. | ||
Примечания
Примечание
- Этот модуль в основном используется как компонент для настройки пар BIG-IP устройств с HA.
- Требуется BIG-IP >= 12.0.0
- Дополнительную информацию об использовании Ansible для управления устройствами F5 Networks см. на сайте https://www.ansible.com/integrations/networks/f5.
- Требуется версия ПО 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
provider:
server: lb.mydomain.com
user: admin
password: secret
delegate_to: localhost
Возвращаемые значения
Общие значения возврата описаны здесь, следующие поля уникальны для этого модуля:
| Ключ | Возвращаемое | Описание |
|---|---|---|
| changed boolean | всегда | Указывает, была ли обновлена конфигурация F5. |
| cluster_mirroring string | changed | Текущее значение параметра кластерного зеркалирования. Пример: between-clusters |
| config_sync_ip string | changed | Новое значение параметра config_sync_ip. Пример: 10.1.1.1 |
| failover_multicast boolean | 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 integer | changed | Новое значение параметра multicast_port. Пример: 1026 |
| unicast_failover list | changed | Новое значение параметра unicast_failover. Пример: [{'address': '10.1.1.2', 'port': 1026}] |
Статус
- Данный модуль гарантированно поддерживает обратную совместимость в будущих изменениях интерфейса. [stableinterface]
- Этот модуль поддерживается партнером 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_device_connectivity_module.html
