Documentation

tower_host - create, update, or destroy Ansible Tower host.

New in version 2.3.

Synopsis

Requirements (on host that executes module)

  • python >= 2.6
  • ansible-tower-cli >= 3.0.3

Options

parameter required default choices comments
description
 no
The description to use for the host.
enabled
 no True
If the host should be enabled.
inventory
 yes
Inventory the host should be made a member of.
name
 yes
The name to use for the host.
state
 no present
  • present
  • absent
Desired state of the resource.
tower_config_file
 no
Path to the Tower config file. See notes.
tower_host
 no
URL to your Tower instance.
tower_password
 no
Password for your Tower instance.
tower_username
 no
Username for your Tower instance.
tower_verify_ssl
 no True
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.
variables
 no
Variables to use for the host. Use '@' for a file.

Examples

- name: Add tower host
  tower_host:
    name: localhost
    description: "Local Host Group"
    inventory: "Local Inventory"
    state: present
    tower_config_file: "~/tower_cli.cfg"

Notes

Note

  • If no config_file is provided we will attempt to use the tower-cli library defaults to find your Tower host information.
  • config_file should contain Tower configuration in the following format host=hostname username=username password=password

Status

This module is flagged as preview which means that it is not guaranteed to have a backwards compatible interface.

For help in developing on modules, should you be so inclined, please read Community Information & Contributing, Testing Ansible and Developing Modules.