Модуль f5networks.f5_modules.bigip_device_license — управление установкой и активацией лицензии на устройствах 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_device_license.

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

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

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

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

Параметры

Параметр	Комментарии
accept_eula логический	Указывает, принимаете ли вы лицензионное соглашение BIG-IP (EULA). По умолчанию это значение — `false`. Вы должны явно подтвердить, что ознакомились с лицензией и принимаете ее. Этот модуль не показывает текст лицензионного соглашения, поэтому вы должны прочитать его самостоятельно. С лицензионным соглашением можно ознакомиться здесь: https://support.f5.com/csp/article/K12902. Этот параметр не требуется, если `state` равно `absent`, и будет проигнорирован, если он указан. Варианты: `false` ← (по умолчанию) `true`
addon_keys список / элементы=строка добавлено в f5networks.f5_modules 1.2.0	Список дополнительных ключей для использования вместе с базовой лицензией. Этот параметр будет проигнорирован, если `license_key` не указан. Этот параметр не требуется, если `state` равно `absent`, и будет проигнорирован, если он указан.
force логический	Указывает, нужно ли принудительно обновить лицензию. По умолчанию это значение — `false`. Этот параметр не требуется и будет проигнорирован, если он указан. Варианты: `false` ← (по умолчанию) `true`
license_key строка	Регистрационный ключ для лицензирования BIG-IP. Этот параметр требуется, если `state` равно `present` или `latest`. Этот параметр не требуется, если `state` равно `absent`, и будет проигнорирован, если он указан.
license_server строка	Сервер лицензирования F5, используемый для получения лицензии и проверки досье. Этот параметр требуется, если `state` равно `present` или `latest`. Этот параметр не требуется, если `state` равно `absent`, и будет проигнорирован, если он указан. По умолчанию: `"activate.f5.com"`
provider словарь добавлено в f5networks.f5_modules 1.0.0	Объект dict, содержащий сведения о подключении.
auth_provider строка	Настраивает поставщика аутентификации для получения токенов аутентификации с удаленного устройства. Этот параметр используется преимущественно при работе с устройствами BIG-IQ.
no_f5_teem логический	Если `yes`, телеметрические данные TEEM не отправляются в F5. Этот параметр можно не указывать, задав переменную среды `F5_TELEMETRY_OFF`. Ранее использовавшаяся переменная `F5_TEEM` устарела, так как ее название было неоднозначным. Варианты: `false` ← (по умолчанию) `true`
password псевдонимы: pass, pwd строка / обязательный	Пароль учетной записи пользователя, используемой для подключения к BIG-IP или BIG-IQ. Этот параметр можно не указывать, задав переменную среды `F5_PASSWORD`.
server строка / обязательный	Узел BIG-IP или BIG-IQ. Этот параметр можно не указывать, задав переменную среды `F5_SERVER`.
server_port целое число	Порт сервера BIG-IP. Этот параметр можно не указывать, задав переменную среды `F5_SERVER_PORT`. По умолчанию: `443`
timeout целое число	Задает время ожидания в секундах при подключении к сетевому устройству или отправке команд. Если время ожидания истечет до завершения операции, модуль завершится с ошибкой.
transport строка	Настраивает транспортное соединение, используемое для подключения к удаленному устройству. Варианты: `"rest"` ← (по умолчанию)
user строка / обязательный	Имя пользователя для подключения к BIG-IP или BIG-IQ. У этого пользователя должны быть права администратора на устройстве. Этот параметр можно не указывать, задав переменную среды `F5_USER`.
validate_certs логический	Если `no`, SSL-сертификаты не проверяются. Используйте этот параметр только на контролируемых вами сайтах, использующих самоподписанные сертификаты. Этот параметр можно не указывать, задав переменную среды `F5_VALIDATE_CERTS`. Варианты: `false` `true` ← (по умолчанию)
state строка	Состояние лицензии в системе. При значении `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–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_device_license_module.html