dustyhorizon / puppet-module-hosts

Puppet module to manage host entries

hosts module

Manage host entries.

Can ensure entries for localhost, localhost6, and $::fqdn, including aliases and optionally purge unmanaged entries.

===

Compatibility

This module targets Puppet v3 with Ruby versions 1.8.7, 1.9.3, 2.0.0 and 2.1.0. It should work with any *nix based system that uses /etc/hosts.

===

Parameters

enable_ipv4_localhost

Boolean to enable ipv4 localhost entry

• Default: true

enable_ipv6_localhost

Boolean to enable ipv6 localhost entry

• Default: true

enable_fqdn_entry

Boolean to enable entry for fqdn

• Default: true

use_fqdn

When enabled use the ${::fqdn} fact to determine the hosts entry for the local node.

• Default: true

fqdn_host_aliases

String or Array of aliases for fqdn

• Default: $::hostname

localhost_aliases

String or Array of aliases for localhost

• Default: [ 'localhost', 'localhost4', 'localhost4.localdomain4' ]

localhost6_aliases

String or Array of aliases for localhost6

• Default: [ 'localhost6', 'localhost6.localdomain6' ]

purge_hosts

Boolean to optionally purge unmanaged entries from hosts

• Default: false

target

String for path to hosts file

• Default: /etc/hosts

collect_all

Boolean to optionally collect all the exported Host resources

• Default: false

host_entries

Hash of host entries

• Default: undef

===

Hiera example of host_entries

---
hosts::host_entries:
  'servicename.example.com':
    ip: '10.0.0.5'
    host_aliases:
      - 'servicename'