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. | ||
| password строка / обязательно | Пароль для учетной записи пользователя, используемой для подключения к BIG-IP. Вы можете опустить этот параметр, установив переменную среды F5_PASSWORD. псевдонимы: pass, pwd | ||
| provider словарь добавлено в 2.5 | Объект словаря, содержащий данные подключения. | ||
| 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 булево |
| Если 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 булево добавлено в 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.
- Требуется версия ПО 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 строка | изменено | Текущее значение настройки 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)
- 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.8/modules/bigip_device_connectivity_module.html
