Модуль f5networks.f5_modules.bigip_device_license – Управление установкой и активацией лицензий на устройствах BIG-IP

Примечание

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

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

Для установки используйте: ansible-galaxy collection install f5networks.f5_modules.

Для использования в плейбуке укажите: f5networks.f5_modules.bigip_device_license.

Новая функция в f5networks.f5_modules 1.0.0

Описание
Параметры
Примечания
Примеры

Описание

Управление установкой и активацией лицензий на BIG-IP.

Параметры

Параметр	Комментарии
accept_eula boolean	Указывает, принимаете ли вы EULA BIG-IP. По умолчанию это значение равно `false`. Вы должны явно указать, что ознакомились и приняли лицензионное соглашение. Данный модуль не предоставляет вам EULA, поэтому вы обязаны ознакомиться с ним самостоятельно. EULA можно найти здесь: https://support.f5.com/csp/article/K12902. Этот параметр не требуется, когда `state` равно `absent`, и будет проигнорирован, если он указан. Варианты: `false` ← (по умолчанию) `true`
addon_keys list / elements=string добавлено в f5networks.f5_modules 1.2.0	Список дополнительных ключей, которые будут использоваться вместе с базовой лицензией. Этот параметр будет проигнорирован, если не указан `license_key`. Этот параметр не требуется, когда `state` равно `absent`, и будет проигнорирован, если он указан.
force boolean	Указывает, нужно ли принудительно обновить лицензию. По умолчанию это значение равно `false`. Этот параметр не требуется и будет проигнорирован, если он указан. Варианты: `false` ← (по умолчанию) `true`
license_key string	Ключ регистрации для лицензирования BIG-IP. Этот параметр требуется, если `state` равно `present` или `latest`. Этот параметр не требуется, когда `state` равно `absent`, и будет проигнорирован, если он указан.
license_server string	Сервер лицензий F5 для получения лицензии и проверки пакета. Этот параметр требуется, если `state` равно `present` или `latest`. Этот параметр не требуется, когда `state` равно `absent`, и будет проигнорирован, если он указан. По умолчанию: `"activate.f5.com"`
provider dictionary добавлено в f5networks.f5_modules 1.0.0	Объект типа dict, содержащий детали подключения.
auth_provider string	Настраивает поставщика аутентификации для получения токенов аутентификации от удаленного устройства. Этот параметр действительно используется при работе с устройствами BIG-IQ.
no_f5_teem boolean	Если `yes`, данные телеметрии TEEM не отправляются в F5. Вы можете опустить этот параметр, задав переменную среды `F5_TELEMETRY_OFF`. Предыдущая переменная `F5_TEEM` устарела, так как ее имя вызывало недопонимание. Варианты: `false` ← (по умолчанию) `true`
password aliases: 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` ← (по умолчанию)

состояние

строка

Состояние лицензии на системе.

Когда present, гарантирует только, что лицензия существует.

Когда absent, удаляет лицензию на системе.

Когда latest, гарантирует, что лицензия всегда действительна. Это не идемпотентное состояние, так как повторный запуск может изменить результат.

Когда revoked, удаляет лицензию на системе и аннулирует ее будущее использование на серверах лицензий F5.

Варианты:

"absent"
"latest"
"present" ← (по умолчанию)
"revoked"

Примечания

Примечание

Этот модуль может использоваться для лицензирования BIG-IP, у которого нет доступа к интернету.
Доступ к интернету необходим только для контроллера Ansible, так как активация лицензии выполняется на контроллере Ansible, с которого запускается модуль.
Дополнительную информацию об использовании Ansible для управления устройствами F5 Networks см. на странице https://www.ansible.com/integrations/networks/f5.
Требуется версия ПО BIG-IP >= 12.
Модули F5 работают только с активной конфигурацией продукта F5. Чтобы убедиться, что конфигурация BIG-IP сохранится на диске, обязательно включите хотя бы одну задачу, которая использует модуль f5networks.f5_modules.bigip_config, для сохранения активной конфигурации. Обратитесь к документации модуля для правильного использования модуля, чтобы сохранить активную конфигурацию.

Примеры

- name: License BIG-IP using a key
  bigip_device_license:
    license_key: "XXXXX-XXXXX-XXXXX-XXXXX-XXXXXXX"
    provider:
      server: "lb.mydomain.com"
      user: "admin"
      password: "secret"
  delegate_to: localhost

- name: License BIG-IP using a key
  bigip_device_license:
    license_key: "XXXXX-XXXXX-XXXXX-XXXXX-XXXXXXX"
    provider:
      server: "lb.mydomain.com"
      user: "admin"
      password: "secret"
  delegate_to: localhost

- name: Remove the license from the system
  bigip_device_license:
    state: "absent"
    provider:
      server: "lb.mydomain.com"
      user: "admin"
      password: "secret"
  delegate_to: localhost

Авторы

Tim Rupp (@caphrim007)
Wojciech Wypior (@wojtek0806)
Andrey Kashcheev (@andreykashcheev)

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

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