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 |
| Когда 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) | По умолчанию: Нет | Объект типа dict, содержащий данные подключения. | |
| 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 установлена. | |
| unicast_failover | Желаемые адреса для операций резервирования. Параметры address и port поддерживаются со структурой словаря, где address — локальный IP-адрес, который система использует для операций резервирования. Порт указывает порт, который система использует для операций резервирования. Если port не указан, будет использовано значение по умолчанию 1026. Если вы указываете (рекомендуемый) адрес управления, используйте «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.
- На хосте требуется пакет 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 | изменён | Новое значение параметра config_sync_ip. Пример: 10.1.1.1 |
| failover_multicast bool | изменён | Указывает, был ли изменён атрибут резервного копирования multicast. |
| mirror_primary_address string | изменён | Новое значение параметра mirror_primary_address. Пример: 10.1.1.2 |
| mirror_secondary_address string | изменён | Новое значение параметра mirror_secondary_address. Пример: 10.1.1.3 |
| multicast_address string | изменён | Новое значение параметра multicast_address. Пример: 224.0.0.245 |
| multicast_interface string | изменён | Новое значение параметра multicast_interface. Пример: eth0 |
| multicast_port string | изменён | Новое значение параметра multicast_port. Пример: 1026 |
| unicast_failover list | изменён | Новое значение параметра unicast_failover. Пример: [{'port': 1026, 'address': '10.1.1.2'}] |
Статус
Этот модуль помечен как превью, что означает, что его интерфейс не гарантируется как обратной совместимости.
Автор
- 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_device_connectivity_module.html
