viasite-ansible / ansible-role-hosts

Ansible role which adds entries to the /etc/hosts file

Ansible viasite-ansible.hosts role

viasite-ansible.hosts is an Ansible role which:

• manages hosts entries

Installation

Using ansible-galaxy:

$ ansible-galaxy install viasite-ansible.hosts

Using requirements.yml:

- src: viasite-ansible.hosts

Using git:

$ git clone https://github.com/weareinteractive/ansible-hosts.git viasite-ansible.hosts

Dependencies

• Ansible >= 2.0

Variables

Here is a list of all the default variables for this role, which are also available in defaults/main.yml.

---
# hosts:
#   - { ip: '127.0.0.1', domain: 'foobar1.com' }
#   - { ip: '127.0.0.2', domain: 'foobar2.com', state: absent }

# list of /etc/hosts entries
hosts: []
# always remove all entries before adding the configured ones
# if set to 'no' you can remove entries manually by setting the
# item's state to 'absent'
hosts_reset: yes

Usage

This is an example playbook:

---

- hosts: all
  roles:
    - viasite-ansible.hosts
  vars:
    hosts:
      - { ip: '127.0.0.1', domain: 'foobar1.com' }
      - { ip: '127.0.0.2', domain: 'foobar2.com' }
      - { ip: '127.0.0.3', domain: 'foobar3.com', state: absent }
    hosts_reset: no

Testing

$ git clone https://github.com/weareinteractive/ansible-hosts.git
$ cd ansible-hosts
$ make test

Contributing

In lieu of a formal style guide, take care to maintain the existing coding style. Add unit tests and examples for any new or changed functionality.

1. Fork it
2. Create your feature branch (git checkout -b my-new-feature)
3. Commit your changes (git commit -am 'Add some feature')
4. Push to the branch (git push origin my-new-feature)
5. Create new Pull Request

Note: To update the README.md file please install and run ansible-role:

$ gem install ansible-role
$ ansible-role docgen

License

Copyright (c) We Are Interactive under the MIT license.