f5networks.f5_modules.bigip_device_group – Управление группами устройств на BIG-IP
Примечание
Этот плагин входит в коллекцию f5networks.f5_modules (версия 1.7.1).
Для установки используйте: ansible-galaxy collection install f5networks.f5_modules.
Для использования в книге задач, укажите: f5networks.f5_modules.bigip_device_group.
Новое в версии 1.0.0: of 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 / required | Указывает имя группы устройств. | ||
| network_failover boolean |
| Указывает, происходит ли переключение по сети или оно жёстко задано. Этот параметр действителен только для typeов, которые являются sync-failover. | |
| provider dictionary добавлено в 1.0.0 f5networks.f5_modules | Объект словаря, содержащий данные о соединении. | ||
| auth_provider string | Настраивает поставщика авторизации для получения маркеров аутентификации от удаленного устройства. Этот параметр действительно используется при работе с устройствами BIG-IQ. | ||
| no_f5_teem boolean |
| Если yes, данные телеметрии TEEM не отправляются в F5.Вы можете опустить этот параметр, задав переменную среды F5_TEEM. | |
| password string / required | Пароль для учетной записи пользователя, используемой для подключения к BIG-IP. Вы можете опустить этот параметр, задав переменную среды F5_PASSWORD.псевдонимы: pass, pwd | ||
| server string / required | Хост BIG-IP. Вы можете опустить этот параметр, задав переменную среды F5_SERVER. | ||
| server_port integer | По умолчанию: 443 | Порт сервера BIG-IP. Вы можете опустить этот параметр, задав переменную среды F5_SERVER_PORT. | |
| timeout integer | Указывает время ожидания в секундах для связи с сетевым устройством при подключении или отправке команд. Если время ожидания истечёт до завершения операции, модуль выдаст ошибку. | ||
| transport string |
| Настраивает транспортное соединение для использования при подключении к удалённому устройству. | |
| user string / required | Имя пользователя для подключения к 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.Это значение нельзя изменить после установки. | |
Примечания
Примечание
- Этот модуль в первую очередь используется в качестве компонента при настройке пар BIG-IP устройств в режиме HA.
- Требуется 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–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/f5networks/f5_modules/bigip_device_group_module.html
