Forge Home

hosts

Manage /etc/hosts file.

10,646 downloads

10,646 latest version

4.1 quality score

We run a couple of automated
scans to help you access a
module's quality. Each module is
given a score based on how well
the author has formatted their
code and documentation and
modules are also checked for
malware using VirusTotal.

Please note, the information below
is for guidance only and neither of
these methods should be considered
an endorsement by Puppet.

Support the Puppet Community by contributing to this module

You are welcome to contribute to this module by suggesting new features, currency updates, or fixes. Every contribution is valuable to help ensure that the module remains compatible with the latest Puppet versions and continues to meet community needs. Complete the following steps:

  1. Review the module’s contribution guidelines and any licenses. Ensure that your planned contribution aligns with the author’s standards and any legal requirements.
  2. Fork the repository on GitHub, make changes on a branch of your fork, and submit a pull request. The pull request must clearly document your proposed change.

For questions about updating the module, contact the module’s author.

Version information

  • 0.0.1 (latest)
released May 16th 2012

Start using this module

  • r10k or Code Manager
  • Bolt
  • Manual installation
  • Direct download

Add this module to your Puppetfile:

mod 'kupson-hosts', '0.0.1'
Learn more about managing modules with a Puppetfile

Add this module to your Bolt project:

bolt module add kupson-hosts
Learn more about using this module with an existing project

Manually install this module globally with Puppet module tool:

puppet module install kupson-hosts --version 0.0.1

Direct download is not typically how you would use a Puppet module to manage your infrastructure, but you may want to download the module in order to inspect the code.

Download

Documentation

kupson/hosts — version 0.0.1 May 16th 2012

Manage /etc/hosts file.

Description

This module is suitable mostly for small groups of hosts without private DNS resolver nearby. It updates /etc/hosts file from template and add host entries grouped by environment to it.

Warning: Host entries not managed by Puppet will be erased on install (and template version updete).

Parameters

  • puppet_ip - Puppet host IP address (extlookup() variable)

Usage

hosts

Replace /etc/hosts with template file and add all hosts from node $environment to it.

include hosts

hosts::allenv

Same as hosts class but import all host resources. Suitable for puppet master host or other all-environment nodes.

include hosts::allenv

hosts::minimal

Only replace /etc/hosts with template file, do not import resources.

include hosts::minimal

hosts::params notes

Parameters for this module such as template version. Change it if you need to trigger /etc/hosts file update on nodes.

Right now $puppet_ip variable is pupulated by call to extlookup() function. Please change it to other data source as needed.