f5networks.f5_modules.bigip_device_group – Управление группами устройств на BIG-IP
Примечание
Этот модуль входит в коллекцию f5networks.f5_modules (версия 1.6.0).
Для его установки используйте: ansible-galaxy collection install f5networks.f5_modules.
Для использования в playbook, укажите: f5networks.f5_modules.bigip_device_group.
Новое в версии 1.0.0: модуля f5networks.f5_modules
Описание
- Управление группами устройств позволяет создавать пары HA и кластеры устройств BIG-IP. Использование этого модуля должно осуществляться совместно с модулем
bigip_configsync_actions, для синхронизации конфигурации между парой или кластером, если автосинхронизация отключена.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии | |
|---|---|---|---|
| auto_sync boolean |
| Указывает, происходит ли синхронизация конфигурации вручную или автоматически. При создании новой группы устройств, этот параметр будет по умолчанию no. | |
| description string | Описание группы устройств. | ||
| full_sync boolean |
| Указывает, синхронизирует ли система всю конфигурацию во время операций синхронизации. Когда no, система выполняет операции инкрементальной синхронизации, основанные на размере кэша, указанном в max_incremental_sync_size.Инкрементальная синхронизация конфигурации – механизм синхронизации конфигурации группы устройств между ее членами без необходимости полного загрузки конфигурации для каждого изменения конфигурации. Для этого все устройства в группе устройств должны изначально согласовать конфигурацию. Обычно это требует по крайней мере одной полной загрузки конфигурации на каждое устройство. При создании новой группы устройств, этот параметр будет по умолчанию no. | |
| max_incremental_sync_size integer | Указывает размер кэша изменений для инкрементальной синхронизации. Например, используя значение по умолчанию, если вы внесли более 1024 КБ инкрементальных изменений, система выполнит полную операцию синхронизации. Использование инкрементальных операций синхронизации может сократить время синхронизации/загрузки конфигурации на устройство для изменений конфигурации. Это значение актуально только тогда, когда full_sync равно no. | ||
| name string / обязательно | Указывает имя группы устройств. | ||
| network_failover boolean |
| Указывает, происходит ли отказ по сети или жестко прошит. Этот параметр действителен только для typeов, которые sync-failover. | |
| provider dictionary добавлено в 1.0.0 f5networks.f5_modules | Объект типа dict, содержащий данные подключения. | ||
| auth_provider string | Настраивает поставщика аутентификации для получения маркеров аутентификации от удаленного устройства. Этот параметр действительно используется при работе с устройствами BIG-IQ. | ||
| no_f5_teem boolean |
| Если yes, данные телеметрии TEEM не отправляются в F5.Вы можете опустить этот параметр, установив переменную среды F5_TEEM. | |
| password string / обязательно | Пароль для учетной записи пользователя, используемой для подключения к BIG-IP. Вы можете опустить этот параметр, установив переменную среды F5_PASSWORD.алиасы: pass, pwd | ||
| server string / обязательно | Хост BIG-IP. Вы можете опустить этот параметр, установив переменную среды F5_SERVER. | ||
| server_port integer | Значение по умолчанию: 443 | Порт сервера BIG-IP. Вы можете опустить этот параметр, установив переменную среды F5_SERVER_PORT. | |
| timeout integer | Указывает таймаут в секундах для связи с сетевым устройством для подключения или отправки команд. Если таймаут истечет до завершения операции, модуль вернет ошибку. | ||
| transport string |
| Настраивает транспортное подключение для использования при подключении к удаленному устройству. | |
| user string / обязательно | Имя пользователя для подключения к BIG-IP. Этот пользователь должен иметь административные привилегии на устройстве. Вы можете опустить этот параметр, установив переменную среды F5_USER. | ||
| validate_certs boolean |
| Если no, сертификаты SSL не проверяются. Используйте только на контролируемых вами сайтах, использующих самозаверенные сертификаты.Вы можете опустить этот параметр, установив переменную среды F5_VALIDATE_CERTS. | |
| save_on_auto_sync boolean |
| При выполнении автосинхронизации, указывает, будет ли конфигурация сохранена. Когда no, будут изменены только текущие настройки на синхронизируемых устройствах.При создании новой группы устройств, этот параметр будет по умолчанию no. | |
| state string |
| Когда state равно present, гарантирует существование группы устройств.Когда state равно absent, гарантирует удаление группы устройств. | |
| type string |
| Указывает тип группы. Группа устройств sync-failover содержит устройства, которые синхронизируют свои данные конфигурации и выполняют переход по отказу друг другу, когда устройство становится недоступным.В группе устройств sync-only такой перехода по отказу нет. При создании новой группы устройств, этот параметр будет по умолчанию sync-only.Это значение нельзя изменить после его установки. | |
Примечания
Примечание
- Этот модуль в основном используется как компонент конфигурации пар HA устройств BIG-IP.
- Требуется BIG-IP >= 12.1.x.
- Дополнительную информацию об использовании Ansible для управления устройствами F5 Networks см. на https://www.ansible.com/integrations/networks/f5.
- Требуется версия ПО BIG-IP >= 12.
- Модули F5 изменяют только текущую конфигурацию продукта F5. Чтобы убедиться, что конфигурация BIG-IP сохраняется на диске, обязательно включите хотя бы одну задачу, которая использует модуль f5networks.f5_modules.bigip_config для сохранения текущей конфигурации. Обратитесь к документации модуля для правильного использования модуля для сохранения текущей конфигурации.
Примеры
- name: Create a sync-only device group
bigip_device_group:
name: foo-group
provider:
password: secret
server: lb.mydomain.com
user: admin
delegate_to: localhost
- name: Create a sync-only device group with auto-sync enabled
bigip_device_group:
name: foo-group
auto_sync: yes
provider:
password: secret
server: lb.mydomain.com
user: admin
delegate_to: localhost
Возвращаемые значения
Общие возвращаемые значения описаны здесь, следующие поля уникальны для этого модуля:
| Ключ | Возвращённое значение | Описание |
|---|---|---|
| auto_sync boolean | изменённое | Новое значение auto_sync группы устройств. Пример: True |
| description string | изменённое | Новое описание группы устройств. Пример: это группа устройств |
| full_sync boolean | изменённое | Новое значение full_sync группы устройств. |
| max_incremental_sync_size integer | изменённое | Новый размер синхронизации группы устройств. Пример: 1000 |
| network_failover boolean | изменённое | Включён ли failover сети. Пример: True |
| save_on_auto_sync boolean | изменённое | Новое значение save_on_auto_sync группы устройств. Пример: True |
| type string | изменённое | Новый тип группы устройств. Пример: sync-failover |
Авторы
- 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.10/collections/f5networks/f5_modules/bigip_device_group_module.html
