This role manages /etc/hosts and /etc/hostname on Linux systems and the hostname and C:\Windows\System32\drivers\etc on Windows systems.
This is a fork of https://github.com/ajsalminen/ansible-role-hosts .
Each entry is described by a dictionary with the keys "address" which contains the IP address for the entry and "hosts" which is a list of hostnames. The host names are added in the same order so first one will be the canonical hostname.
The following describes what variables you can set. When "entry" is mentioned, it means the structure described in the last paragraph.
hosts_ipv4_loopback_hosts: An entry for the IPv4 loopback address. Defaults to setting localhost.localdomain and localhost as hostnames.
hosts_default_ipv4_hosts: An entry for default inventory IPv4 address. Defaults to inventory_hostname and inventory_hostname_short from ansible.
hosts_default_hosts: A list of entries that are set by default in the role. Contains the previous two entries by default.
hosts_additional_hosts: A list of additional entries to put in the hosts file. Empty by default.
hosts_all_hosts: List of all host entries. Just merges hosts_default_hosts and hosts_additional_hosts by default.
hosts_hostname: The hostname that will be given to the remote target (ie the
contents of /etc/hostname). If left empty, it defaults to
inventory_hostname_short.
hosts_etc_hosts_template: The template to use to generate the etc/hosts file.
It defaults to the bundled hosts.j2 template.
Including an example of how to use your role (for instance, with variables passed in as parameters) is always nice for users too:
- hosts: servers
roles:
- role: hosts
hosts_additional_hosts:
- address: 192.168.0.1
hostnames:
- server.example.com
- server
MIT/Simplified BSD license
Fork created by Nikolaos Kakouros. Original role created by Antti J. Salminen.