Skip to content

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

License

Notifications You must be signed in to change notification settings

viasite-ansible/ansible-role-hosts

 
 

Repository files navigation

Ansible viasite-ansible.hosts role Build Status

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.

About

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

Resources

License

Stars

Watchers

Forks

Packages

No packages published