dominion_solutions / dominion_solutions.netbird / 0.2.0 / inventory / netbird Get inventory from the Netbird API | "added in version" 0.0.2 of dominion_solutions.netbird" Authors: Mark J. Horninger (@spam-n-eggs)dominion_solutions.netbird.netbird (0.2.0) — inventory
Install with ansible-galaxy collection install dominion_solutions.netbird:==0.2.0
collections: - name: dominion_solutions.netbird version: 0.2.0
Get inventory from the Netbird API. Allows for filtering based on Netbird Tags / Groups.
cache: default: true description: Cache plugin output to a file env: - name: ANSIBLE_INVENTORY_CACHE ini: - key: cache section: inventory type: boolean groups: default: {} description: Add hosts to group based on Jinja2 conditionals. type: dict plugin: choices: - netbird - dominion_solutions.netbird.netbird description: Marks this as an instance of the 'netbird' plugin. required: true strict: default: false description: Whether or not to fail if a group or variable is not found. type: bool api_key: description: The API Key for the Netbird API. env: - name: NETBIRD_API_KEY required: true type: string api_url: description: The URL for the Netbird API. env: - name: NETBIRD_API_URL required: true type: string compose: default: {} description: compose variables for Ansible based on jinja2 expression and inventory vars required: false type: dict ip_style: choices: - plain - api default: plain description: Populate hostvars with all information available from the Netbird API. type: string cache_plugin: default: memory description: - Cache plugin to use for the inventory's source data. env: - name: ANSIBLE_CACHE_PLUGIN - name: ANSIBLE_INVENTORY_CACHE_PLUGIN ini: - key: fact_caching section: defaults - key: cache_plugin section: inventory type: str cache_prefix: default: ansible_inventory_ description: - Prefix to use for cache plugin files/tables env: - name: ANSIBLE_CACHE_PLUGIN_PREFIX - name: ANSIBLE_INVENTORY_CACHE_PLUGIN_PREFIX ini: - key: fact_caching_prefix section: defaults - key: cache_prefix section: inventory keyed_groups: default: [] description: create groups for plugins based on variable values and add the corresponding hosts to it elements: dict required: false suboptions: default_value: description: - The default value when the host variable's value is an empty string. - This option is mutually exclusive with O(keyed_groups[].trailing_separator). type: str version_added: '2.12' version_added_collection: ansible.builtin key: description: - The key from input dictionary used to generate groups type: str parent_group: description: parent group for keyed group type: str prefix: default: '' description: A keyed group name will start with this prefix type: str separator: default: _ description: separator used to build the keyed group name type: str trailing_separator: default: true description: - Set this option to V(False) to omit the O(keyed_groups[].separator) after the host variable when the value is an empty string. - This option is mutually exclusive with O(keyed_groups[].default_value). type: bool version_added: '2.12' version_added_collection: ansible.builtin type: list cache_timeout: default: 3600 description: - Cache duration in seconds env: - name: ANSIBLE_CACHE_PLUGIN_TIMEOUT - name: ANSIBLE_INVENTORY_CACHE_TIMEOUT ini: - key: fact_caching_timeout section: defaults - key: cache_timeout section: inventory type: int netbird_groups: description: A list of Netbird groups to filter the inventory by. elements: string required: false type: list use_extra_vars: default: false description: Merge extra vars into the available variables for composition (highest precedence). env: - name: ANSIBLE_INVENTORY_USE_EXTRA_VARS ini: - key: use_extra_vars section: inventory_plugins type: bool version_added: '2.11' version_added_collection: ansible.builtin cache_connection: description: - Cache connection data or path, read cache plugin documentation for specifics. env: - name: ANSIBLE_CACHE_PLUGIN_CONNECTION - name: ANSIBLE_INVENTORY_CACHE_CONNECTION ini: - key: fact_caching_connection section: defaults - key: cache_connection section: inventory type: str leading_separator: default: true description: - Use in conjunction with keyed_groups. - By default, a keyed group that does not have a prefix or a separator provided will have a name that starts with an underscore. - This is because the default prefix is "" and the default separator is "_". - Set this option to False to omit the leading underscore (or other separator) if no prefix is given. - If the group name is derived from a mapping the separator is still used to concatenate the items. - To not use a separator in the group name at all, set the separator for the keyed group to an empty string instead. type: boolean version_added: '2.11' version_added_collection: ansible.builtin netbird_connected: default: true description: Filter the inventory by connected peers. type: boolean