hosts

A simple puppet module to manage hosts file

Jd

jsy

9,252 downloads

7,735 latest version

3.8 quality score

Version information

  • 0.3.0 (latest)
  • 0.2.2
  • 0.2.1
  • 0.2.0
  • 0.1.9
  • 0.1.8
  • 0.1.7
  • 0.1.6
  • 0.1.5
  • 0.1.4
  • 0.1.3
  • 0.1.2
  • 0.1.1
  • 0.1.0
released Jul 16th 2015

Start using this module

Documentation

jsy/hosts — version 0.3.0 Jul 16th 2015

hosts

Table of Contents

  1. Overview
  2. Usage - Configuration options and additional functionality
  3. Validations
  4. Limitations - OS compatibility, etc.

Overview

This is a simple puppet module to manage hosts file. You provide the IP, Host and Alias as a hash value and it will update /etc/hosts by default. Alternatively you can also provide a file location.

Usage

Provide one or mulitple entries like below. If you have multiple hostnames or aliases then separate each with a space.

class {'hosts':
         hosts => {entry1 => {ip=>'127.0.0.1',host=>'localhost',alias=>'localdomain'}},
      }

You may also provide the path to the file that will be updated.

class {'hosts':
         file => '/root/somefile',
     hosts => {entry1 => {ip=>'127.0.0.1',host=>'localhost',alias=>'localdomain'},
          entry2 => {ip=>'127.0.0.1',host=>'',alias=>'localdomain'}
         }
      }

Provide more than one hostname or alias as a space separated list.

class {'hosts':
         file => '/root/somefile',
     hosts => {entry1 => {ip=>'127.0.0.1',host=>'localhost localhost.localdomain',alias=>'localdomain'},
          entry2 => {ip=>'127.0.0.1',host=>'',alias=>'localdomain loopback'}
         }
      }

Hiera Example

hosts:
  entry1:
    ip: 127.0.0.1
    host: localhost.localdomain
    alias: localdomain loopback

Using Hiera

class {'hosts':
         file => '/root/somefile',
         hosts => hiera("hosts")
      }

Validations

This modules require that the IP address must not be empty and either host or alias is provided. If the IP is empty or both the host and alias are missing then it will not process that entry. At the moment there is no validation for correct IP or hostname which will be added in the future so please take care when adding these values.

Limitations

This module should be compatible with all systems. Please pay extra attention to IP and hostnames as these are not validated yet.