New in version 2.3.
The below requirements are needed on the host that executes this module.
Parameter | Choices/Defaults | Comments |
---|---|---|
credential | Credential to use for the group. | |
description | The description to use for the group. | |
group_by | Limit groups automatically created from inventory source. | |
instance_filters | Comma-separated list of filter expressions for matching hosts. | |
inventory required | Inventory the group should be made a member of. | |
name required | The name to use for the group. | |
overwrite bool |
| Delete child groups and hosts not found in source. |
overwrite_vars | Override vars in child groups and hosts with those from external source. | |
source |
| The source to use for this group. |
source_regions | Regions for cloud provider. | |
source_script | Inventory script to be used when group type is custom . | |
source_vars | Override variables from source with variables from this field. | |
state |
| Desired state of the resource. |
tower_config_file | Path to the Tower config file. See notes. | |
tower_host | URL to your Tower instance. | |
tower_password | Password for your Tower instance. | |
tower_username | Username for your Tower instance. | |
tower_verify_ssl bool |
| Dis/allow insecure connections to Tower. If no , SSL certificates will not be validated. This should only be used on personally controlled sites using self-signed certificates. |
update_on_launch bool |
| Refresh inventory data from its source each time a job is run. |
variables | Variables to use for the group, use @ for a file. |
Note
- name: Add tower group tower_group: name: localhost description: "Local Host Group" inventory: "Local Inventory" state: present tower_config_file: "~/tower_cli.cfg"
This module is flagged as preview which means that it is not guaranteed to have a backwards compatible interface.
This module is flagged as community which means that it is maintained by the Ansible Community. See Module Maintenance & Support for more info.
For a list of other modules that are also maintained by the Ansible Community, see here.
Hint
If you notice any issues in this documentation you can edit this document to improve it.
© 2012–2018 Michael DeHaan
© 2018 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.7/modules/tower_group_module.html