Модуль f5networks.f5_modules.bigip_provision – управление подготовкой модулей BIG-IP

Примечание

Этот модуль входит в коллекцию f5networks.f5_modules (версия 1.39.0).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.

Чтобы установить её, используйте: ansible-galaxy collection install f5networks.f5_modules.

Чтобы использовать её в плейбуке, укажите: f5networks.f5_modules.bigip_provision.

Добавлено в f5networks.f5_modules 1.0.0

Краткое описание
Параметры
Примечания
Примеры
Возвращаемые значения

Краткое описание

Управление подготовкой модулей BIG-IP. Этот модуль выполняет подготовку только на стандартных уровнях: Dedicated, Nominal и Minimum.

Параметры

Параметр	Комментарии
level string	Задаёт уровень подготовки для указанных модулей. Изменение уровня одного модуля может потребовать изменения уровня другого. Например, для изменения одного модуля на `dedicated` необходимо установить для всех остальных значение `none`. Установка уровня модуля в `none` означает, что модуль не активирован. Используйте `state` со значением absent, чтобы установить для c(level) значение none и отменить подготовку модуля. Этот параметр не применим к `cgnat - pre tmos 15.0` или `mgmt` и не будет применён к модулю `cgnat - pre tmos 15.0` или `mgmt`. Варианты: `"dedicated"` `"nominal"` ← (по умолчанию) `"minimum"`
memory string	Задаёт дополнительный объём памяти для модуля управления. Он выделяется сверх минимального объёма ОЗУ в 1264 МБ. Допустимый диапазон значений: `0 - 8192`. Максимальное значение ограничено доступным объёмом ОЗУ в системе. Указание `large` резервирует дополнительные 500 МБ для модуля mgmt. Указание `medium` резервирует дополнительные 200 МБ для модуля mgmt. Указание `small` не резервирует дополнительную ОЗУ для модуля mgmt. Используйте `large` для конфигураций, содержащих более 2000 объектов, или, точнее, для любой конфигурации, превышающей 1000 объектов на 2 ГБ установленной памяти. Изменение размера `mgmt` управления после первоначальной подготовки приводит к повторной подготовке.
module псевдонимы: name string / обязательный	Модуль для подготовки в BIG-IP. Варианты: `"am"` `"afm"` `"apm"` `"asm"` `"avr"` `"cgnat"` `"fps"` `"gtm"` `"ilx"` `"lc"` `"ltm"` `"mgmt"` `"pem"` `"sam"` `"sslo"` `"swg"` `"urldb"` `"vcmp"`
provider dictionary добавлен в f5networks.f5_modules 1.0.0	Словарь с данными для подключения.
auth_provider string	Настраивает поставщика аутентификации для получения токенов аутентификации с удалённого устройства. Этот параметр используется преимущественно при работе с устройствами BIG-IQ.
no_f5_teem boolean	Если `yes`, телеметрические данные TEEM не отправляются в F5. Этот параметр можно не указывать, задав переменную среды `F5_TELEMETRY_OFF`. Ранее использовавшаяся переменная `F5_TEEM` объявлена устаревшей, поскольку её название было неоднозначным. Варианты: `false` ← (по умолчанию) `true`
password псевдонимы: pass, pwd string / обязательный	Пароль учётной записи пользователя для подключения к BIG-IP или BIG-IQ. Этот параметр можно не указывать, задав переменную среды `F5_PASSWORD`.
server string / обязательный	Имя хоста BIG-IP или BIG-IQ. Этот параметр можно не указывать, задав переменную среды `F5_SERVER`.
server_port integer	Порт сервера BIG-IP. Этот параметр можно не указывать, задав переменную среды `F5_SERVER_PORT`. По умолчанию: `443`
timeout integer	Задаёт время ожидания в секундах при обмене данными с сетевым устройством — при подключении или отправке команд. Если операция не завершится до истечения времени ожидания, модуль завершится с ошибкой.
transport string	Настраивает транспорт для подключения к удалённому устройству. Варианты: `"rest"` ← (по умолчанию)
user string / обязательный	Имя пользователя для подключения к BIG-IP или BIG-IQ. У этого пользователя должны быть права администратора на устройстве. Этот параметр можно не указывать, задав переменную среды `F5_USER`.
validate_certs boolean	Если `no`, SSL-сертификаты не проверяются. Используйте этот параметр только на сайтах под вашим контролем, применяющих самоподписанные сертификаты. Этот параметр можно не указывать, задав переменную среды `F5_VALIDATE_CERTS`. Варианты: `false` `true` ← (по умолчанию)
state string	Состояние подготовленного модуля в системе. Если задано `present`, гарантируется, что указанный модуль будет подготовлен на запрошенном уровне при условии, что на устройстве достаточно ресурсов (например, физической ОЗУ) для его работы. Если задано `absent`, подготовка модуля отменяется. `absent` не является применимым параметром для модуля `mgmt`, поскольку его подготовку отменить нельзя. Варианты: `"present"` ← (по умолчанию) `"absent"`

Примечания

Примечание

Дополнительные сведения об использовании 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 string	Новый уровень подготовки модуля. Возвращается: при изменении Пример: `"minimum"`
memory string	Новый объём памяти, выделенный для модуля mgmt. Возвращается: при изменении Пример: `"large"`

Авторы

Tim Rupp (@caphrim007)
Greg Crosby (@crosbygw)

Ссылки на коллекцию

© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/f5networks/f5_modules/bigip_provision_module.html