f5networks.f5_modules.license_hopper lookup – Return random license from list

Note

This lookup plugin is part of the f5networks.f5_modules collection (version 1.17.0).

You might already have this collection installed if you are using the ansible package. It is not included in ansible-core. To check whether it is installed, run ansible-galaxy collection list.

To install it, use: ansible-galaxy collection install f5networks.f5_modules.

To use it in a playbook, specify: f5networks.f5_modules.license_hopper.

New in version 1.0: of f5networks.f5_modules

Synopsis

  • Select a random license key from a file and remove it from future lookups

  • Can optionally remove the key if remove=True is specified

Examples

- name: Get a regkey license from a stash without deleting it
  bigiq_regkey_license:
    key: "{{ lookup('license_hopper', 'filename=/path/to/licenses.txt') }}"
    state: present
    pool: regkey1

- name: Get a regkey license from a stash and delete the key from the file
  bigiq_regkey_license:
    key: "{{ lookup('license_hopper', 'filename=/path/to/licenses.txt', remove=True) }}"
    state: present
    pool: regkey1

Return Values

Common return values are documented here, the following are the fields unique to this lookup:

Key

Description

_raw

string

random item

Returned: success

Authors

  • Tim Rupp

Hint

Configuration entries for each entry type have a low to high priority order. For example, a variable that is lower in the list will override a variable that is higher up.