f5networks.f5_modules.bigip_provision – Управление предоставлением модулей BIG-IP
Примечание
Этот плагин входит в состав коллекции f5networks.f5_modules (версия 1.7.1).
Для его установки используйте: ansible-galaxy collection install f5networks.f5_modules.
Для использования в плейбуке укажите: f5networks.f5_modules.bigip_provision.
Новое в версии 1.0.0: из f5networks.f5_modules
Обзор
- Управление предоставлением модулей BIG-IP. Этот модуль будет предоставлять только стандартные уровни: Dedicated, Nominal и Minimum.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии | |
|---|---|---|---|
| level строка |
| Устанавливает уровень предоставления для запрошенных модулей. Изменение уровня для одного модуля может потребовать изменения уровня другого модуля. Например, изменение одного модуля на dedicated требует установки всех остальных на none. Установка уровня модуля на none означает, что модуль не активирован.Используйте значение state для absent, чтобы установить (level) в значение none и отменить предоставление модуля.Этот параметр не относится к cgnat - pre tmos 15.0 или mgmt и не будет применен к модулю cgnat - pre tmos 15.0 или mgmt. | |
| memory строка | Устанавливает дополнительную память для модуля управления. Это дополнительно к минимально выделенной оперативной памяти в 1264 МБ. Допустимый диапазон значений 0 - 8192. Максимальное значение ограничено доступной оперативной памятью в системе.Указание large резервирует дополнительные 500 МБ для модуля mgmt.Указание medium резервирует дополнительные 200 МБ для модуля mgmt.Указание small не резервирует дополнительную оперативную память для модуля mgmt.Используйте large для конфигураций, содержащих более 2000 объектов, или, точнее, для любой конфигурации, превышающей 1000 объектов на 2 ГБ установленной памяти. Изменение размера модуля управления mgmt после первоначального предоставления вызывает операцию повторного предоставления. | ||
| module строка / обязательно |
| Модуль для предоставления в BIG-IP. псевдонимы: name | |
| provider словарь добавлен в 1.0.0 из f5networks.f5_modules | Объект словаря, содержащий сведения о подключении. | ||
| auth_provider строка | Настраивает провайдера аутентификации для получения токенов аутентификации от удаленного устройства. Этот параметр используется при работе с устройствами BIG-IQ. | ||
| no_f5_teem логическое |
| Если yes, данные телеметрии TEEM не отправляются в F5.Вы можете опустить этот параметр, установив переменную среды F5_TEEM. | |
| password строка / обязательно | Пароль для учетной записи пользователя, используемой для подключения к BIG-IP. Вы можете опустить этот параметр, установив переменную среды F5_PASSWORD. псевдонимы: pass, pwd | ||
| server строка / обязательно | Хост BIG-IP. Вы можете опустить этот параметр, установив переменную среды F5_SERVER. | ||
| server_port целое число | По умолчанию: 443 | Порт сервера BIG-IP. Вы можете опустить этот параметр, установив переменную среды F5_SERVER_PORT. | |
| timeout целое число | Указывает таймаут в секундах для связи с сетевым устройством для подключения или отправки команд. Если таймаут истечет до завершения операции, модуль выдаст ошибку. | ||
| transport строка |
| Настраивает транспортное соединение для использования при подключении к удаленному устройству. | |
| user строка / обязательно | Имя пользователя для подключения к BIG-IP. Этот пользователь должен иметь административные права на устройстве. Вы можете опустить этот параметр, установив переменную среды F5_USER. | ||
| validate_certs логическое |
| Если no, сертификаты SSL не проверяются. Используйте только на контролируемых вами сайтах с самозаверяемыми сертификатами.Вы можете опустить этот параметр, установив переменную среды F5_VALIDATE_CERTS. | |
| state строка |
| Состояние предоставленного модуля в системе. Когда present, гарантируется, что указанный модуль предоставлен на запрошенном уровне, при условии наличия достаточных ресурсов на устройстве (например, физической оперативной памяти) для поддержки модуля.Когда absent, отменить предоставление модуля.absent, не является релевантным вариантом для модуля mgmt, так как он не может быть отменён. | |
Примечания
Примечание
- Дополнительную информацию об использовании Ansible для управления устройствами F5 Networks см. на странице https://www.ansible.com/integrations/networks/f5.
- Требуется версия программного обеспечения BIG-IP >= 12.
- Модули F5 манипулируют только текущей конфигурацией продукта F5. Чтобы убедиться, что специфичная для BIG-IP конфигурация сохраняется на диске, необходимо включить хотя бы одну задачу, использующую модуль f5networks.f5_modules.bigip_config для сохранения текущей конфигурации. Обратитесь к документации модуля для правильного использования модуля для сохранения текущей конфигурации.
Примеры
- name: Provision PEM at "nominal" level
bigip_provision:
module: pem
level: nominal
provider:
server: lb.mydomain.com
password: secret
user: admin
delegate_to: localhost
- name: Provision a dedicated SWG. This will unprovision every other module
bigip_provision:
module: swg
level: dedicated
provider:
server: lb.mydomain.com
password: secret
user: admin
delegate_to: localhost
- name: Provision mgmt with medium amount of memory.
bigip_provision:
module: mgmt
memory: medium
provider:
server: lb.mydomain.com
password: secret
user: admin
delegate_to: localhost
Возвращаемые значения
Общие возвращаемые значения описаны здесь, следующие являются полями, уникальными для этого модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| level строка | changed | Новый уровень предоставления модуля. Пример: minimum |
| memory строка | changed | Новое предоставленное количество памяти для модуля mgmt. Пример: large |
Авторы
- Tim Rupp (@caphrim007)
- Greg Crosby (@crosbygw)
© 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_provision_module.html
